@koda-sl/baker-cli 0.386.0-dev.8b1f99042 → 0.386.0-dev.d6e55699d

package/dist/preview-UKYLPAW2.js

@@ -0,0 +1,169 @@
+import {
+  FACEBOOK_PREVIEW_FORMATS,
+  INSTAGRAM_PREVIEW_FORMATS,
+  PLATFORM_SCOPED_POSITIONS,
+  previewFormatForPosition
+} from "./chunk-GOJXKIFQ.js";
+import {
+  handleMetaError
+} from "./chunk-TPXI2GCW.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-EF5DP6EB.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/preview.ts
+import { writeFileSync } from "fs";
+import { defineCommand } from "citty";
+var VALID_AD_FORMATS = [
+  "DESKTOP_FEED_STANDARD",
+  "MOBILE_FEED_STANDARD",
+  "MOBILE_FEED_BASIC",
+  "RIGHT_COLUMN_STANDARD",
+  "MOBILE_FULLWIDTH",
+  "MOBILE_INTERSTITIAL",
+  "MOBILE_BANNER",
+  "MOBILE_MEDIUM_RECTANGLE",
+  "MOBILE_NATIVE",
+  "FACEBOOK_STORY_MOBILE",
+  "FACEBOOK_REELS_MOBILE",
+  "INSTAGRAM_STORY",
+  "INSTAGRAM_REELS",
+  "INSTAGRAM_REELS_OVERLAY",
+  "INSTAGRAM_STANDARD",
+  "INSTAGRAM_EXPLORE_CONTEXTUAL",
+  "INSTAGRAM_EXPLORE_GRID_HOME",
+  "INSTAGRAM_SEARCH_CHAIN",
+  "INSTAGRAM_SHOP",
+  "INSTAGRAM_PROFILE_FEED",
+  "INSTREAM_VIDEO_DESKTOP",
+  "INSTREAM_VIDEO_MOBILE",
+  "FACEBOOK_REELS_BANNER",
+  "FACEBOOK_REELS_STICKER",
+  "MESSENGER_MOBILE_INBOX_MEDIA",
+  "MESSENGER_MOBILE_STORY_MEDIA",
+  "AUDIENCE_NETWORK_OUTSTREAM_VIDEO",
+  "AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE",
+  "AUDIENCE_NETWORK_REWARDED_VIDEO",
+  "INSTANT_ARTICLE_STANDARD",
+  "MARKETPLACE_MOBILE",
+  "BIZ_DISCO_FEED_MOBILE"
+];
+function failPreviewValidation(message) {
+  writeAdsJson({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function resolvePlacement(position, platform) {
+  const platformArg = typeof platform === "string" ? platform.toLowerCase() : void 0;
+  if (platformArg && platformArg !== "facebook" && platformArg !== "instagram") {
+    failPreviewValidation("--platform must be facebook or instagram");
+  }
+  const format = previewFormatForPosition(position, platformArg);
+  if (format) {
+    return format;
+  }
+  if (PLATFORM_SCOPED_POSITIONS.has(position) && !platformArg) {
+    failPreviewValidation(
+      `--placement ${position} names a different surface on Facebook and on Instagram \u2014 add --platform facebook or --platform instagram (the breakdown row's publisher_platform)`
+    );
+  }
+  failPreviewValidation(
+    `No Meta preview format is published for placement "${position}". Meta does not document one for every placement (facebook_notification and facebook_profile_feed among them), so this placement cannot be previewed \u2014 report it as unverified rather than inferring what it renders. Pass the platform_position exactly as the insights breakdown spelled it: targeting names a few surfaces differently (story, reels, explore_home) and those names never appear in a breakdown. Previewable placements: ${listPlacements()}`
+  );
+}
+function listPlacements() {
+  const facebook = Object.keys(FACEBOOK_PREVIEW_FORMATS).join(", ");
+  const instagram = Object.keys(INSTAGRAM_PREVIEW_FORMATS).join(", ");
+  return `facebook \u2014 ${facebook}; instagram \u2014 ${instagram}`;
+}
+var previewCommand = defineCommand({
+  meta: {
+    name: "preview",
+    description: `Generate a Meta-hosted preview iframe for a creative or ad. Returns iframe HTML which you
+can embed or save to a file. The iframe URL contains a short-lived access token \u2014 treat as secret.
+
+Start here when you need to know what a creative looks like in one specific placement \u2014 this is
+Meta's own renderer, so it settles "does my video show as a still image there?" without guessing.
+Pass the placement straight from an insights breakdown with --placement (a platform_position value),
+or a Meta ad_format with --ad-format. Run --list-formats to see both sets.
+
+Examples:
+  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD
+  baker ads meta preview --creative-id 6123 --placement facebook_reels_overlay --platform facebook
+  baker ads meta preview --ad-id 9988 --ad-format INSTAGRAM_REELS --out-file /tmp/preview.html
+  baker ads meta preview --account-id act_123 --creative '{"object_story_spec":{...}}' --ad-format MOBILE_FEED_STANDARD`
+  },
+  args: {
+    "creative-id": { type: "string", description: "Existing creative ID" },
+    "ad-id": { type: "string", description: "Existing ad ID" },
+    "account-id": { type: "string", description: "Required when previewing an unpublished --creative spec" },
+    creative: { type: "string", description: "JSON spec of an unpublished creative (e.g. object_story_spec)" },
+    "ad-format": { type: "string", description: "Meta ad_format enum value (--list-formats to see them)" },
+    placement: {
+      type: "string",
+      description: "platform_position from an insights breakdown (e.g. facebook_reels_overlay) \u2014 resolved to an ad_format"
+    },
+    platform: { type: "string", description: "facebook|instagram \u2014 required for --placement feed, which both report" },
+    "list-formats": { type: "boolean", description: "Print the ad_format values and placement mappings, then exit" },
+    "out-file": { type: "string", description: "Save iframe HTML to this path" },
+    "no-cache": NO_CACHE_ARG
+  },
+  run: async ({ args }) => {
+    if (args["list-formats"]) {
+      writeAdsJson({
+        ok: true,
+        data: {
+          adFormats: VALID_AD_FORMATS,
+          placements: { facebook: FACEBOOK_PREVIEW_FORMATS, instagram: INSTAGRAM_PREVIEW_FORMATS }
+        }
+      });
+      return;
+    }
+    const placement = args.placement;
+    const adFormat = placement ? resolvePlacement(placement, args.platform) : args["ad-format"];
+    if (!adFormat) {
+      failPreviewValidation("pass --ad-format or --placement (see --list-formats)");
+    }
+    if (!VALID_AD_FORMATS.includes(adFormat)) {
+      failPreviewValidation(
+        `Invalid --ad-format "${adFormat}". Meta publishes no complete ad_format enum, so this is the set we know: ${VALID_AD_FORMATS.join(", ")}. To preview a placement you saw in an insights breakdown, pass --placement <platform_position> instead of guessing a format name.`
+      );
+    }
+    const body = { adFormat };
+    if (args["creative-id"]) body.creativeId = args["creative-id"];
+    if (args["ad-id"]) body.adId = args["ad-id"];
+    if (args["account-id"]) body.accountId = args["account-id"];
+    if (args.creative) body.creative = args.creative;
+    if (args["no-cache"]) body.skipCache = true;
+    try {
+      const data = await apiPost("/api/ads/meta/preview", body);
+      const html = data.map((d) => d.body).join("\n");
+      const hints = placement ? [
+        `Rendered ${placement} as ad_format ${adFormat}. Open the iframe to SEE it \u2014 Meta does not document what it renders for a creative a placement cannot take, so a preview you looked at is the evidence, and anything you did not look at stays unverified.`
+      ] : [];
+      if (args["out-file"]) {
+        const summary = { ok: true, data: { file: args["out-file"], rows: data.length, adFormat } };
+        writeFileSync(args["out-file"], html, "utf-8");
+        writeJsonEnvelope(hints.length > 0 ? { ...summary, hints } : summary);
+        return;
+      }
+      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  previewCommand
+};
+//# sourceMappingURL=preview-UKYLPAW2.js.map

package/dist/preview-UKYLPAW2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/preview.ts"],"sourcesContent":["import { writeFileSync } from \"node:fs\";\nimport {\n  FACEBOOK_PREVIEW_FORMATS,\n  INSTAGRAM_PREVIEW_FORMATS,\n  PLATFORM_SCOPED_POSITIONS,\n  previewFormatForPosition,\n} from \"@baker/api/ads-meta\";\nimport { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson, writeJsonEnvelope } from \"../output.ts\";\nimport { handleMetaError } from \"./shared.ts\";\n\nconst VALID_AD_FORMATS = [\n  \"DESKTOP_FEED_STANDARD\",\n  \"MOBILE_FEED_STANDARD\",\n  \"MOBILE_FEED_BASIC\",\n  \"RIGHT_COLUMN_STANDARD\",\n  \"MOBILE_FULLWIDTH\",\n  \"MOBILE_INTERSTITIAL\",\n  \"MOBILE_BANNER\",\n  \"MOBILE_MEDIUM_RECTANGLE\",\n  \"MOBILE_NATIVE\",\n  \"FACEBOOK_STORY_MOBILE\",\n  \"FACEBOOK_REELS_MOBILE\",\n  \"INSTAGRAM_STORY\",\n  \"INSTAGRAM_REELS\",\n  \"INSTAGRAM_REELS_OVERLAY\",\n  \"INSTAGRAM_STANDARD\",\n  \"INSTAGRAM_EXPLORE_CONTEXTUAL\",\n  \"INSTAGRAM_EXPLORE_GRID_HOME\",\n  \"INSTAGRAM_SEARCH_CHAIN\",\n  \"INSTAGRAM_SHOP\",\n  \"INSTAGRAM_PROFILE_FEED\",\n  \"INSTREAM_VIDEO_DESKTOP\",\n  \"INSTREAM_VIDEO_MOBILE\",\n  \"FACEBOOK_REELS_BANNER\",\n  \"FACEBOOK_REELS_STICKER\",\n  \"MESSENGER_MOBILE_INBOX_MEDIA\",\n  \"MESSENGER_MOBILE_STORY_MEDIA\",\n  \"AUDIENCE_NETWORK_OUTSTREAM_VIDEO\",\n  \"AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE\",\n  \"AUDIENCE_NETWORK_REWARDED_VIDEO\",\n  \"INSTANT_ARTICLE_STANDARD\",\n  \"MARKETPLACE_MOBILE\",\n  \"BIZ_DISCO_FEED_MOBILE\",\n];\n\n/** A bad flag is not a network failure — mislabelling it invites a retry of the same doomed call. */\nfunction failPreviewValidation(message: string): never {\n  writeAdsJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message } });\n  process.exit(1);\n}\n\n/**\n * Preview is the free way to see what Meta actually renders for a creative in a\n * given surface — the check that turns \"this placement must be showing a still\"\n * from a claim into an observation. It was being used by guessing format names,\n * so both doors are open now: the Meta `ad_format` enum via `--ad-format`, and\n * the `platform_position` an insights breakdown reports via `--placement`.\n */\nfunction resolvePlacement(position: string, platform: unknown): string {\n  const platformArg = typeof platform === \"string\" ? platform.toLowerCase() : undefined;\n  if (platformArg && platformArg !== \"facebook\" && platformArg !== \"instagram\") {\n    failPreviewValidation(\"--platform must be facebook or instagram\");\n  }\n  const format = previewFormatForPosition(position, platformArg);\n  if (format) {\n    return format;\n  }\n  if (PLATFORM_SCOPED_POSITIONS.has(position) && !platformArg) {\n    failPreviewValidation(\n      `--placement ${position} names a different surface on Facebook and on Instagram — add --platform facebook or --platform instagram (the breakdown row's publisher_platform)`,\n    );\n  }\n  failPreviewValidation(\n    `No Meta preview format is published for placement \"${position}\". Meta does not document one for every placement (facebook_notification and facebook_profile_feed among them), so this placement cannot be previewed — report it as unverified rather than inferring what it renders. Pass the platform_position exactly as the insights breakdown spelled it: targeting names a few surfaces differently (story, reels, explore_home) and those names never appear in a breakdown. Previewable placements: ${listPlacements()}`,\n  );\n}\n\nfunction listPlacements(): string {\n  const facebook = Object.keys(FACEBOOK_PREVIEW_FORMATS).join(\", \");\n  const instagram = Object.keys(INSTAGRAM_PREVIEW_FORMATS).join(\", \");\n  return `facebook — ${facebook}; instagram — ${instagram}`;\n}\n\nexport const previewCommand = defineCommand({\n  meta: {\n    name: \"preview\",\n    description: `Generate a Meta-hosted preview iframe for a creative or ad. Returns iframe HTML which you\ncan embed or save to a file. The iframe URL contains a short-lived access token — treat as secret.\n\nStart here when you need to know what a creative looks like in one specific placement — this is\nMeta's own renderer, so it settles \"does my video show as a still image there?\" without guessing.\nPass the placement straight from an insights breakdown with --placement (a platform_position value),\nor a Meta ad_format with --ad-format. Run --list-formats to see both sets.\n\nExamples:\n  baker ads meta preview --creative-id 6123 --ad-format MOBILE_FEED_STANDARD\n  baker ads meta preview --creative-id 6123 --placement facebook_reels_overlay --platform facebook\n  baker ads meta preview --ad-id 9988 --ad-format INSTAGRAM_REELS --out-file /tmp/preview.html\n  baker ads meta preview --account-id act_123 --creative '{\"object_story_spec\":{...}}' --ad-format MOBILE_FEED_STANDARD`,\n  },\n  args: {\n    \"creative-id\": { type: \"string\", description: \"Existing creative ID\" },\n    \"ad-id\": { type: \"string\", description: \"Existing ad ID\" },\n    \"account-id\": { type: \"string\", description: \"Required when previewing an unpublished --creative spec\" },\n    creative: { type: \"string\", description: \"JSON spec of an unpublished creative (e.g. object_story_spec)\" },\n    \"ad-format\": { type: \"string\", description: \"Meta ad_format enum value (--list-formats to see them)\" },\n    placement: {\n      type: \"string\",\n      description:\n        \"platform_position from an insights breakdown (e.g. facebook_reels_overlay) — resolved to an ad_format\",\n    },\n    platform: { type: \"string\", description: \"facebook|instagram — required for --placement feed, which both report\" },\n    \"list-formats\": { type: \"boolean\", description: \"Print the ad_format values and placement mappings, then exit\" },\n    \"out-file\": { type: \"string\", description: \"Save iframe HTML to this path\" },\n    \"no-cache\": NO_CACHE_ARG,\n  },\n  run: async ({ args }) => {\n    if (args[\"list-formats\"]) {\n      writeAdsJson({\n        ok: true,\n        data: {\n          adFormats: VALID_AD_FORMATS,\n          placements: { facebook: FACEBOOK_PREVIEW_FORMATS, instagram: INSTAGRAM_PREVIEW_FORMATS },\n        },\n      });\n      return;\n    }\n\n    const placement = args.placement as string | undefined;\n    const adFormat = placement ? resolvePlacement(placement, args.platform) : (args[\"ad-format\"] as string);\n    if (!adFormat) {\n      failPreviewValidation(\"pass --ad-format or --placement (see --list-formats)\");\n    }\n    if (!VALID_AD_FORMATS.includes(adFormat)) {\n      failPreviewValidation(\n        `Invalid --ad-format \"${adFormat}\". Meta publishes no complete ad_format enum, so this is the set we know: ${VALID_AD_FORMATS.join(\", \")}. To preview a placement you saw in an insights breakdown, pass --placement <platform_position> instead of guessing a format name.`,\n      );\n    }\n    const body: Record<string, unknown> = { adFormat };\n    if (args[\"creative-id\"]) body.creativeId = args[\"creative-id\"];\n    if (args[\"ad-id\"]) body.adId = args[\"ad-id\"];\n    if (args[\"account-id\"]) body.accountId = args[\"account-id\"];\n    if (args.creative) body.creative = args.creative;\n    if (args[\"no-cache\"]) body.skipCache = true;\n\n    try {\n      const data = await apiPost<Array<{ body: string }>>(\"/api/ads/meta/preview\", body);\n      const html = data.map((d) => d.body).join(\"\\n\");\n      const hints = placement\n        ? [\n            `Rendered ${placement} as ad_format ${adFormat}. Open the iframe to SEE it — Meta does not document what it renders for a creative a placement cannot take, so a preview you looked at is the evidence, and anything you did not look at stays unverified.`,\n          ]\n        : [];\n      if (args[\"out-file\"]) {\n        const summary = { ok: true as const, data: { file: args[\"out-file\"], rows: data.length, adFormat } };\n        writeFileSync(args[\"out-file\"] as string, html, \"utf-8\");\n        writeJsonEnvelope(hints.length > 0 ? { ...summary, hints } : summary);\n        return;\n      }\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/profile-Q3PHR6FU.js

@@ -0,0 +1,159 @@
+import {
+  IDEA_HINT
+} from "./chunk-WNFTXSGR.js";
+import {
+  reportError
+} from "./chunk-752S7JF6.js";
+import {
+  apiGet
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/winning-ads/profile.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "winning-ads.profile",
+  description: "What one brand is doing, read off its ads: estimated spend (a range over every ad from `since` to today, the last 30 days, and a min.), what it launched lately and what still runs, the tests it ran and the version it kept, format and platform mix, top landing pages, audiences (Google Ads: declared targeting and the countries its ads were shown in, EU-shown ads only), similar brands, and when it was last checked. Compact by default; --full returns every launch, calendar day and landing page.",
+  args: {
+    advertiser: { type: "string", description: "Advertiser id (from `advertisers` or `following`)", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "Return the whole profile", required: false, default: false }
+  }
+});
+var COMPACT_LAUNCHES = 15;
+var COMPACT_TOP = 5;
+var STALE_DAYS = 35;
+var DAY_MS = 24 * 60 * 60 * 1e3;
+function compactProfile(p) {
+  return {
+    last_checked_at: p.freshness.last_checked_at,
+    next_scan_at: p.freshness.next_scan_at,
+    spend: p.spend ? {
+      currency: p.spend.currency,
+      min: p.spend.min,
+      range: [p.spend.low, p.spend.high],
+      since: p.spend.since ? p.spend.since.slice(0, 10) : null,
+      last_30_days: { min: p.spend.last_30_days.min, range: [p.spend.last_30_days.low, p.spend.last_30_days.high] },
+      by_platform: p.spend.by_platform.map(
+        (b) => b.high === 0 && (b.unpriced_ads ?? 0) > 0 ? {
+          platform: b.platform,
+          unpriced: `no delivery published for its ${b.unpriced_ads} ads: spend unknown, never $0`
+        } : {
+          platform: b.platform,
+          range: [b.low, b.high],
+          ...b.last_30_days ? { last_30_days: [b.last_30_days.low, b.last_30_days.high] } : {}
+        }
+      ),
+      ads_counted: {
+        measured: p.spend.measured_ads,
+        estimated: p.spend.extrapolated_ads,
+        not_counted: p.spend.unpriced_ads
+      }
+    } : null,
+    counts: p.counts,
+    media_mix: p.media_mix,
+    platform_split: p.platform_split,
+    launch_weeks: p.launch_weeks,
+    recent_launches: p.recent_launches.slice(0, COMPACT_LAUNCHES).map((l) => ({
+      ad_id: l.ad_id,
+      platform: l.platform,
+      format: l.format,
+      headline: l.headline,
+      first_seen_at: l.first_seen_at,
+      stage: l.stage,
+      idea: l.idea ?? null
+    })),
+    tests: p.tests.slice(0, COMPACT_TOP).map((t) => ({
+      concept: t.concept,
+      launched_at: t.launched_at,
+      versions: t.versions,
+      still_running: t.still_running,
+      status: t.status,
+      winner_ad_id: t.winner_ad_id,
+      what_differed: t.what_differed
+    })),
+    landing_pages: p.landing_pages.slice(0, COMPACT_TOP).map((l) => ({ page: l.page, ads: l.ads, active_ads: l.active_ads })),
+    audiences: {
+      inferred: p.audiences.inferred.slice(0, COMPACT_TOP),
+      measured_countries: p.audiences.measured?.countries.slice(0, COMPACT_TOP) ?? null,
+      targeting: p.audiences.targeting ? {
+        ages: p.audiences.targeting.ages.slice(0, COMPACT_TOP),
+        genders: p.audiences.targeting.genders.slice(0, COMPACT_TOP),
+        locations: p.audiences.targeting.locations.slice(0, COMPACT_TOP),
+        countries: p.audiences.targeting.countries.slice(0, COMPACT_TOP)
+      } : null
+    },
+    similar: p.similar.slice(0, COMPACT_TOP)
+  };
+}
+function profileHints(p, now) {
+  const hints = [];
+  if (p.spend) {
+    hints.push(
+      'Spend is an estimate from the reach platforms publish \xD7 benchmark prices, in USD: quote it as a range ("at least $min, likely $low\u2013$high since <since>"; `range` covers every ad from `since` to today, `last_30_days` the last month), never as one exact figure.'
+    );
+    if (p.spend.unpriced_ads > 0) {
+      hints.push(
+        `${p.spend.unpriced_ads} ads publish no reach and are not counted (\`ads_counted.not_counted\`; \`by_platform\` names the channel), so real spend is higher than the range: say so whenever you quote it. \`estimated\` ads are priced from the brand's similar ads.`
+      );
+    }
+  } else {
+    hints.push(
+      "No platform publishes delivery for this brand's ads, so its spend is unknown: say so, never report $0."
+    );
+  }
+  const checked = p.freshness.last_checked_at ? Date.parse(p.freshness.last_checked_at) : null;
+  if (checked === null || now.getTime() - checked > STALE_DAYS * DAY_MS) {
+    hints.push(
+      "This brand was not checked in the last 5 weeks, so what still runs may be out of date: `baker winning-ads refresh <advertiser>` re-scans it."
+    );
+  }
+  if (p.recent_launches.some((l) => l.idea)) {
+    hints.push(
+      `${IDEA_HINT} \`launch_weeks\` counts \`new_ideas\` and \`idea_ads\` per week; \`counts.unique_ideas\` is every concept the brand ran.`
+    );
+  }
+  if (p.tests.some((t) => t.status === "decided" && t.winner_ad_id)) {
+    hints.push("Open a test's winner with `baker winning-ads content <ad-id>` to see what the brand kept.");
+  }
+  return hints;
+}
+var profileCommand = defineCommand({
+  meta: {
+    name: "profile",
+    description: "What one brand is doing: spend estimate, launches and what still runs, tests and the version kept, mixes, landing pages, audiences, similar brands. Start here: baker winning-ads profile adv_123 (add --platform meta to narrow, --full for everything)"
+  },
+  args: {
+    advertiser: { type: "positional", description: "Advertiser id", required: true },
+    platform: { type: "string", description: "Only this platform: meta|linkedin|tiktok|google", required: false },
+    full: { type: "boolean", description: "Return the whole profile", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const params = { id: String(args.advertiser) };
+      if (args.platform) {
+        params.platform = String(args.platform);
+      }
+      const profile = await apiGet("/api/ad-library/advertiser-profile", params);
+      writeJson({
+        ok: true,
+        data: { advertiser_id: String(args.advertiser), ...args.full ? profile : compactProfile(profile) },
+        hints: profileHints(profile, /* @__PURE__ */ new Date())
+      });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+export {
+  compactProfile,
+  profileCommand,
+  profileHints
+};
+//# sourceMappingURL=profile-Q3PHR6FU.js.map

package/dist/profile-Q3PHR6FU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/profile.ts"],"sourcesContent":["import type { AdvertiserProfile } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { IDEA_HINT } from \"./launches.ts\";\nimport { reportError } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.profile\",\n  description:\n    \"What one brand is doing, read off its ads: estimated spend (a range over every ad from `since` to today, the last 30 days, and a min.), what it launched lately and what still runs, the tests it ran and the version it kept, format and platform mix, top landing pages, audiences (Google Ads: declared targeting and the countries its ads were shown in, EU-shown ads only), similar brands, and when it was last checked. Compact by default; --full returns every launch, calendar day and landing page.\",\n  args: {\n    advertiser: { type: \"string\", description: \"Advertiser id (from `advertisers` or `following`)\", required: true },\n    platform: { type: \"string\", description: \"Only this platform: meta|linkedin|tiktok|google\", required: false },\n    full: { type: \"boolean\", description: \"Return the whole profile\", required: false, default: false },\n  },\n});\n\nconst COMPACT_LAUNCHES = 15;\nconst COMPACT_TOP = 5;\nconst STALE_DAYS = 35;\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** The profile cut to what an agent needs to describe the brand. */\nexport function compactProfile(p: AdvertiserProfile) {\n  return {\n    last_checked_at: p.freshness.last_checked_at,\n    next_scan_at: p.freshness.next_scan_at,\n    spend: p.spend\n      ? {\n          currency: p.spend.currency,\n          min: p.spend.min,\n          range: [p.spend.low, p.spend.high],\n          since: p.spend.since ? p.spend.since.slice(0, 10) : null,\n          last_30_days: { min: p.spend.last_30_days.min, range: [p.spend.last_30_days.low, p.spend.last_30_days.high] },\n          by_platform: p.spend.by_platform.map((b) =>\n            b.high === 0 && (b.unpriced_ads ?? 0) > 0\n              ? {\n                  platform: b.platform,\n                  unpriced: `no delivery published for its ${b.unpriced_ads} ads: spend unknown, never $0`,\n                }\n              : {\n                  platform: b.platform,\n                  range: [b.low, b.high],\n                  ...(b.last_30_days ? { last_30_days: [b.last_30_days.low, b.last_30_days.high] } : {}),\n                },\n          ),\n          ads_counted: {\n            measured: p.spend.measured_ads,\n            estimated: p.spend.extrapolated_ads,\n            not_counted: p.spend.unpriced_ads,\n          },\n        }\n      : null,\n    counts: p.counts,\n    media_mix: p.media_mix,\n    platform_split: p.platform_split,\n    launch_weeks: p.launch_weeks,\n    recent_launches: p.recent_launches.slice(0, COMPACT_LAUNCHES).map((l) => ({\n      ad_id: l.ad_id,\n      platform: l.platform,\n      format: l.format,\n      headline: l.headline,\n      first_seen_at: l.first_seen_at,\n      stage: l.stage,\n      idea: l.idea ?? null,\n    })),\n    tests: p.tests.slice(0, COMPACT_TOP).map((t) => ({\n      concept: t.concept,\n      launched_at: t.launched_at,\n      versions: t.versions,\n      still_running: t.still_running,\n      status: t.status,\n      winner_ad_id: t.winner_ad_id,\n      what_differed: t.what_differed,\n    })),\n    landing_pages: p.landing_pages\n      .slice(0, COMPACT_TOP)\n      .map((l) => ({ page: l.page, ads: l.ads, active_ads: l.active_ads })),\n    audiences: {\n      inferred: p.audiences.inferred.slice(0, COMPACT_TOP),\n      measured_countries: p.audiences.measured?.countries.slice(0, COMPACT_TOP) ?? null,\n      targeting: p.audiences.targeting\n        ? {\n            ages: p.audiences.targeting.ages.slice(0, COMPACT_TOP),\n            genders: p.audiences.targeting.genders.slice(0, COMPACT_TOP),\n            locations: p.audiences.targeting.locations.slice(0, COMPACT_TOP),\n            countries: p.audiences.targeting.countries.slice(0, COMPACT_TOP),\n          }\n        : null,\n    },\n    similar: p.similar.slice(0, COMPACT_TOP),\n  };\n}\n\n/** Steer on the figures an agent would otherwise misreport. */\nexport function profileHints(p: AdvertiserProfile, now: Date): string[] {\n  const hints: string[] = [];\n  if (p.spend) {\n    hints.push(\n      'Spend is an estimate from the reach platforms publish × benchmark prices, in USD: quote it as a range (\"at least $min, likely $low–$high since <since>\"; `range` covers every ad from `since` to today, `last_30_days` the last month), never as one exact figure.',\n    );\n    if (p.spend.unpriced_ads > 0) {\n      hints.push(\n        `${p.spend.unpriced_ads} ads publish no reach and are not counted (\\`ads_counted.not_counted\\`; \\`by_platform\\` names the channel), so real spend is higher than the range: say so whenever you quote it. \\`estimated\\` ads are priced from the brand's similar ads.`,\n      );\n    }\n  } else {\n    hints.push(\n      \"No platform publishes delivery for this brand's ads, so its spend is unknown: say so, never report $0.\",\n    );\n  }\n  const checked = p.freshness.last_checked_at ? Date.parse(p.freshness.last_checked_at) : null;\n  if (checked === null || now.getTime() - checked > STALE_DAYS * DAY_MS) {\n    hints.push(\n      \"This brand was not checked in the last 5 weeks, so what still runs may be out of date: `baker winning-ads refresh <advertiser>` re-scans it.\",\n    );\n  }\n  if (p.recent_launches.some((l) => l.idea)) {\n    hints.push(\n      `${IDEA_HINT} \\`launch_weeks\\` counts \\`new_ideas\\` and \\`idea_ads\\` per week; \\`counts.unique_ideas\\` is every concept the brand ran.`,\n    );\n  }\n  if (p.tests.some((t) => t.status === \"decided\" && t.winner_ad_id)) {\n    hints.push(\"Open a test's winner with `baker winning-ads content <ad-id>` to see what the brand kept.\");\n  }\n  return hints;\n}\n\nexport const profileCommand = defineCommand({\n  meta: {\n    name: \"profile\",\n    description:\n      \"What one brand is doing: spend estimate, launches and what still runs, tests and the version kept, mixes, landing pages, audiences, similar brands. Start here: baker winning-ads profile adv_123 (add --platform meta to narrow, --full for everything)\",\n  },\n  args: {\n    advertiser: { type: \"positional\", description: \"Advertiser id\", required: true },\n    platform: { type: \"string\", description: \"Only this platform: meta|linkedin|tiktok|google\", required: false },\n    full: { type: \"boolean\", description: \"Return the whole profile\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = { id: String(args.advertiser) };\n      if (args.platform) {\n        params.platform = String(args.platform);\n      }\n      const profile = await apiGet<AdvertiserProfile>(\"/api/ad-library/advertiser-profile\", params);\n      writeJson({\n        ok: true,\n        data: { advertiser_id: String(args.advertiser), ...(args.full ? profile : compactProfile(profile)) },\n        hints: profileHints(profile, new Date()),\n      });\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/promoted-tweet-writes-IYOAZTA5.js

@@ -0,0 +1,180 @@
+import {
+  csvArg,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-PBVLPFJ6.js";
+import "./chunk-M6UNISGO.js";
+import "./chunk-G7AFVTUS.js";
+import "./chunk-BVM5IRZW.js";
+import {
+  TARGETING_OPERATORS,
+  TARGETING_TYPES
+} from "./chunk-KRIK2JR4.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-JAYT43KX.js";
+import "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/promoted-tweet-writes.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.promotedTweets.create",
+  description: "Stage promoting one or more existing posts in an X ad group. Takes post (tweet) ids \u2014 the numeric id from the post's URL, not a base36 ads id.",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-id": {
+      type: "string",
+      description: "Ad group id, or an x_temp_* ref staged in this draft",
+      required: true
+    },
+    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
+  }
+});
+var promotedTweetsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage promoting posts in an ad group (applies when the chat is published).
+
+Example:
+  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
+    "tweet-ids": { type: "string", description: "CSV of post ids", required: true }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "promotedTweet.create",
+      accountId,
+      payload: { lineItemId: args["line-item-id"], tweetIds: csvArg(args["tweet-ids"]) ?? [] }
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.promotedTweets.remove",
+  description: "Stage removing one or more promoted posts. X has no pause for these \u2014 removal is the only way to stop one serving, and it cannot be undone (re-promoting creates a new association).",
+  args: {
+    ids: { type: "string", description: "Promoted-post ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false }
+  }
+});
+var promotedTweetsRemoveCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: `Stage removing promoted posts. Cannot be undone.
+
+Example:
+  baker ads x promoted-tweets remove ayyorn,ayyoro`
+  },
+  args: {
+    ids: { type: "positional", description: "Promoted-post ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOps(
+      requireTargets(args, "ids").map((id) => ({
+        kind: "promotedTweet.remove",
+        accountId,
+        target: id,
+        payload: {}
+      }))
+    );
+  }
+});
+registerSchema({
+  command: "ads.x.targetingCriteria.create",
+  description: `Stage one targeting criterion on an X ad group. One op per value, because X stores each criterion as its own entity. Look values up first with \`baker ads x targeting-constants\`.
+Types: ${TARGETING_TYPES.join(", ")}. Operators: ${TARGETING_OPERATORS.join(" (include) | ")} (exclude).`,
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-id": { type: "string", description: "Ad group id, or an x_temp_* ref", required: true },
+    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
+    value: {
+      type: "string",
+      description: "Targeting value \u2014 from `targeting-constants` for the lookup types",
+      required: true
+    },
+    operator: { type: "string", description: "EQ to include (default), NE to exclude", required: false }
+  }
+});
+var targetingCriteriaCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage one targeting criterion on an ad group.
+
+Examples:
+  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1
+  baker ads x targeting-criteria create --line-item-id wiee9 --type INTEREST --value 25 --operator NE`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-id": { type: "string", description: "Ad group id or x_temp_* ref", required: true },
+    type: { type: "string", description: TARGETING_TYPES.join(" | "), required: true },
+    value: { type: "string", description: "Targeting value", required: true },
+    operator: { type: "string", description: "EQ (include) | NE (exclude)" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOp({
+      kind: "targetingCriteria.create",
+      accountId,
+      payload: {
+        lineItemId: args["line-item-id"],
+        targetingType: args.type,
+        targetingValue: args.value,
+        ...args.operator ? { operatorType: args.operator } : {}
+      }
+    });
+  }
+});
+registerSchema({
+  command: "ads.x.targetingCriteria.remove",
+  description: "Stage removing one or more targeting criteria from an X ad group.",
+  args: {
+    ids: { type: "string", description: "Targeting criterion ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID", required: false }
+  }
+});
+var targetingCriteriaRemoveCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: `Stage removing targeting criteria.
+
+Example:
+  baker ads x targeting-criteria remove 1dmtken`
+  },
+  args: {
+    ids: { type: "positional", description: "Targeting criterion ids, comma-separated", required: true },
+    "account-id": { type: "string", description: "X Ads account ID" }
+  },
+  run: async ({ args }) => {
+    const accountId = await stageAccountId(args);
+    await stageXOps(
+      requireTargets(args, "ids").map((id) => ({
+        kind: "targetingCriteria.remove",
+        accountId,
+        target: id,
+        payload: {}
+      }))
+    );
+  }
+});
+export {
+  promotedTweetsCreateCommand,
+  promotedTweetsRemoveCommand,
+  targetingCriteriaCreateCommand,
+  targetingCriteriaRemoveCommand
+};
+//# sourceMappingURL=promoted-tweet-writes-IYOAZTA5.js.map

package/dist/promoted-tweet-writes-IYOAZTA5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/x/promoted-tweet-writes.ts"],"sourcesContent":["import { TARGETING_OPERATORS, TARGETING_TYPES } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { csvArg, requireTargets, stageAccountId, stageXOp, stageXOps } from \"./write-shared.ts\";\n\n/**\n * Staged ad and targeting writes.\n *\n * \"Promoted tweet\" is X's name for the association between a post and an ad\n * group — the thing X Ads Manager calls an ad. There is no pause: the only way\n * to stop one serving is to remove the association, which leaves the post itself\n * untouched.\n */\n\nregisterSchema({\n  command: \"ads.x.promotedTweets.create\",\n  description:\n    \"Stage promoting one or more existing posts in an X ad group. Takes post (tweet) ids — the numeric id from the post's URL, not a base36 ads id.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"line-item-id\": {\n      type: \"string\",\n      description: \"Ad group id, or an x_temp_* ref staged in this draft\",\n      required: true,\n    },\n    \"tweet-ids\": { type: \"string\", description: \"CSV of post ids\", required: true },\n  },\n});\n\nexport const promotedTweetsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage promoting posts in an ad group (applies when the chat is published).\n\nExample:\n  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    \"line-item-id\": { type: \"string\", description: \"Ad group id or x_temp_* ref\", required: true },\n    \"tweet-ids\": { type: \"string\", description: \"CSV of post ids\", required: true },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOp({\n      kind: \"promotedTweet.create\",\n      accountId,\n      payload: { lineItemId: args[\"line-item-id\"], tweetIds: csvArg(args[\"tweet-ids\"]) ?? [] },\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.promotedTweets.remove\",\n  description:\n    \"Stage removing one or more promoted posts. X has no pause for these — removal is the only way to stop one serving, and it cannot be undone (re-promoting creates a new association).\",\n  args: {\n    ids: { type: \"string\", description: \"Promoted-post ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n  },\n});\n\nexport const promotedTweetsRemoveCommand = defineCommand({\n  meta: {\n    name: \"remove\",\n    description: `Stage removing promoted posts. Cannot be undone.\n\nExample:\n  baker ads x promoted-tweets remove ayyorn,ayyoro`,\n  },\n  args: {\n    ids: { type: \"positional\", description: \"Promoted-post ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOps(\n      requireTargets(args, \"ids\").map((id) => ({\n        kind: \"promotedTweet.remove\",\n        accountId,\n        target: id,\n        payload: {},\n      })),\n    );\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.targetingCriteria.create\",\n  description: `Stage one targeting criterion on an X ad group. One op per value, because X stores each criterion as its own entity. Look values up first with \\`baker ads x targeting-constants\\`.\nTypes: ${TARGETING_TYPES.join(\", \")}. Operators: ${TARGETING_OPERATORS.join(\" (include) | \")} (exclude).`,\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n    \"line-item-id\": { type: \"string\", description: \"Ad group id, or an x_temp_* ref\", required: true },\n    type: { type: \"string\", description: TARGETING_TYPES.join(\" | \"), required: true },\n    value: {\n      type: \"string\",\n      description: \"Targeting value — from `targeting-constants` for the lookup types\",\n      required: true,\n    },\n    operator: { type: \"string\", description: \"EQ to include (default), NE to exclude\", required: false },\n  },\n});\n\nexport const targetingCriteriaCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage one targeting criterion on an ad group.\n\nExamples:\n  baker ads x targeting-criteria create --line-item-id wiee9 --type LOCATION --value 96683cc9126741d1\n  baker ads x targeting-criteria create --line-item-id wiee9 --type INTEREST --value 25 --operator NE`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n    \"line-item-id\": { type: \"string\", description: \"Ad group id or x_temp_* ref\", required: true },\n    type: { type: \"string\", description: TARGETING_TYPES.join(\" | \"), required: true },\n    value: { type: \"string\", description: \"Targeting value\", required: true },\n    operator: { type: \"string\", description: \"EQ (include) | NE (exclude)\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOp({\n      kind: \"targetingCriteria.create\",\n      accountId,\n      payload: {\n        lineItemId: args[\"line-item-id\"],\n        targetingType: args.type,\n        targetingValue: args.value,\n        ...(args.operator ? { operatorType: args.operator } : {}),\n      },\n    });\n  },\n});\n\nregisterSchema({\n  command: \"ads.x.targetingCriteria.remove\",\n  description: \"Stage removing one or more targeting criteria from an X ad group.\",\n  args: {\n    ids: { type: \"string\", description: \"Targeting criterion ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\", required: false },\n  },\n});\n\nexport const targetingCriteriaRemoveCommand = defineCommand({\n  meta: {\n    name: \"remove\",\n    description: `Stage removing targeting criteria.\n\nExample:\n  baker ads x targeting-criteria remove 1dmtken`,\n  },\n  args: {\n    ids: { type: \"positional\", description: \"Targeting criterion ids, comma-separated\", required: true },\n    \"account-id\": { type: \"string\", description: \"X Ads account ID\" },\n  },\n  run: async ({ args }) => {\n    const accountId = await stageAccountId(args);\n    await stageXOps(\n      requireTargets(args, \"ids\").map((id) => ({\n        kind: \"targetingCriteria.remove\",\n        accountId,\n        target: id,\n        payload: {},\n      })),\n    );\n  },\n});\n"],"mappings":"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","names":[]}