@koda-sl/baker-cli 0.573.0 → 0.574.0

package/dist/preview-HWM6KHV5.js

@@ -0,0 +1,245 @@
+import {
+  AD_PREVIEW_DIR,
+  renderAdPreviews
+} from "./chunk-EGVWSAWY.js";
+import "./chunk-VN3WDB4O.js";
+import {
+  FACEBOOK_PREVIEW_FORMATS,
+  INSTAGRAM_PREVIEW_FORMATS,
+  PLATFORM_SCOPED_POSITIONS,
+  previewFormatForPosition
+} from "./chunk-GC5P4KWY.js";
+import "./chunk-GDFJOCDO.js";
+import {
+  handleMetaError
+} from "./chunk-FCD5BPC5.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-VJUVTMHY.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-HPF3USL2.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/preview.ts
+import { createHash } from "crypto";
+import { writeFileSync } from "fs";
+import { defineCommand } from "citty";
+var VALID_AD_FORMATS = [
+  "AUDIENCE_NETWORK_INSTREAM_VIDEO",
+  "AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE",
+  "AUDIENCE_NETWORK_OUTSTREAM_VIDEO",
+  "AUDIENCE_NETWORK_REWARDED_VIDEO",
+  "BIZ_DISCO_FEED_MOBILE",
+  "DESKTOP_FEED_STANDARD",
+  "FACEBOOK_IFU_REELS_MOBILE",
+  "FACEBOOK_PROFILE_FEED_DESKTOP",
+  "FACEBOOK_PROFILE_FEED_MOBILE",
+  "FACEBOOK_PROFILE_REELS_MOBILE",
+  "FACEBOOK_REELS_BANNER",
+  "FACEBOOK_REELS_BANNER_DESKTOP",
+  "FACEBOOK_REELS_BANNER_FEED_ANDROID",
+  "FACEBOOK_REELS_BANNER_FEED_ANDROID_LARGE",
+  "FACEBOOK_REELS_BANNER_FULLSCREEN_IOS",
+  "FACEBOOK_REELS_BANNER_FULLSCREEN_MOBILE",
+  "FACEBOOK_REELS_MOBILE",
+  "FACEBOOK_REELS_POSTLOOP",
+  "FACEBOOK_REELS_POSTLOOP_FEED",
+  "FACEBOOK_REELS_SIMILAR_PRODUCTS_MOBILE",
+  "FACEBOOK_REELS_STICKER",
+  "FACEBOOK_STORY_MOBILE",
+  "FACEBOOK_STORY_STICKER_MOBILE",
+  "INSTAGRAM_EXPLORE_CONTEXTUAL",
+  "INSTAGRAM_EXPLORE_GRID_HOME",
+  "INSTAGRAM_EXPLORE_IMMERSIVE",
+  "INSTAGRAM_FEED_WEB",
+  "INSTAGRAM_FEED_WEB_M_SITE",
+  "INSTAGRAM_LEAD_GEN_MULTI_SUBMIT_ADS",
+  "INSTAGRAM_PROFILE_FEED",
+  "INSTAGRAM_PROFILE_REELS",
+  "INSTAGRAM_REELS",
+  "INSTAGRAM_REELS_OVERLAY",
+  "INSTAGRAM_REELS_WEB",
+  "INSTAGRAM_REELS_WEB_M_SITE",
+  "INSTAGRAM_SEARCH_CHAIN",
+  "INSTAGRAM_SEARCH_GRID",
+  "INSTAGRAM_SHOP",
+  "INSTAGRAM_STANDARD",
+  "INSTAGRAM_STORY",
+  "INSTAGRAM_STORY_EFFECT_TRAY",
+  "INSTAGRAM_STORY_WEB",
+  "INSTAGRAM_STORY_WEB_M_SITE",
+  "INSTANT_ARTICLE_RECIRCULATION_AD",
+  "INSTANT_ARTICLE_STANDARD",
+  "INSTREAM_BANNER_DESKTOP",
+  "INSTREAM_BANNER_FEED_IOS",
+  "INSTREAM_BANNER_FULLSCREEN_IOS",
+  "INSTREAM_BANNER_FULLSCREEN_MOBILE",
+  "INSTREAM_BANNER_IMMERSIVE_MOBILE",
+  "INSTREAM_BANNER_MOBILE",
+  "INSTREAM_VIDEO_DESKTOP",
+  "INSTREAM_VIDEO_FULLSCREEN_IOS",
+  "INSTREAM_VIDEO_FULLSCREEN_MOBILE",
+  "INSTREAM_VIDEO_IMAGE",
+  "INSTREAM_VIDEO_IMMERSIVE_MOBILE",
+  "INSTREAM_VIDEO_MOBILE",
+  "JOB_BROWSER_DESKTOP",
+  "JOB_BROWSER_MOBILE",
+  "MARKETPLACE_MOBILE",
+  "MESSENGER_MOBILE_INBOX_MEDIA",
+  "MESSENGER_MOBILE_STORY_MEDIA",
+  "MOBILE_BANNER",
+  "MOBILE_FEED_BASIC",
+  "MOBILE_FEED_STANDARD",
+  "MOBILE_FULLWIDTH",
+  "MOBILE_INTERSTITIAL",
+  "MOBILE_MEDIUM_RECTANGLE",
+  "MOBILE_NATIVE",
+  "RIGHT_COLUMN_STANDARD",
+  "SUGGESTED_VIDEO_DESKTOP",
+  "SUGGESTED_VIDEO_FULLSCREEN_MOBILE",
+  "SUGGESTED_VIDEO_IMMERSIVE_MOBILE",
+  "SUGGESTED_VIDEO_MOBILE",
+  "WATCH_FEED_HOME",
+  "WATCH_FEED_MOBILE",
+  "WHATSAPP_STATUS_MEDIA"
+];
+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 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}`;
+}
+function previewFileName(target) {
+  const id = target.adId ?? target.creativeId;
+  if (id) return `meta-${id}`;
+  return `meta-draft-${createHash("sha256").update(target.creative ?? "").digest("hex").slice(0, 12)}`;
+}
+var previewCommand = defineCommand({
+  meta: {
+    name: "preview",
+    description: `See a creative or ad as Meta renders it in one placement: shownText (the text people see, in order)
+plus a picture to Read for what text cannot tell (words in the artwork, cropping, how it looks).
+--out-file also saves Meta's raw iframe HTML (its URL holds a short-lived access token \u2014 treat as secret).
+
+Start here before saying anything about how an ad LOOKS (which text shows, the headline under the
+image, the button). Start here too 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-dir /tmp/review
+  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: "Also save Meta's iframe HTML to this path" },
+    "out-dir": { type: "string", description: `Folder for the picture (default: ${AD_PREVIEW_DIR})` },
+    "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's ad_format values: ${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);
+      if (args["out-file"]) {
+        writeFileSync(args["out-file"], data.map((d) => d.body).join("\n"), "utf-8");
+      }
+      const rendered = await renderAdPreviews(
+        data.map((d, i) => ({ placement: data.length > 1 ? `${adFormat}-${i + 1}` : adFormat, html: d.body })),
+        {
+          dir: args["out-dir"] ? String(args["out-dir"]) : AD_PREVIEW_DIR,
+          name: previewFileName({
+            adId: args["ad-id"],
+            creativeId: args["creative-id"],
+            creative: args.creative
+          })
+        }
+      );
+      const hints = placement ? [
+        `Rendered ${placement} as ad_format ${adFormat}. Meta does not document what it renders for a creative a placement cannot take, so the picture is the evidence.`,
+        ...rendered.hints
+      ] : rendered.hints;
+      writeJsonEnvelope({
+        ok: true,
+        data: { adFormat, previews: rendered.previews, ...args["out-file"] ? { file: args["out-file"] } : {} },
+        hints
+      });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+export {
+  previewCommand,
+  previewFileName
+};
+//# sourceMappingURL=preview-HWM6KHV5.js.map

package/dist/preview-JITAEUWU.js

@@ -0,0 +1,101 @@
+import {
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-SLTZC32B.js";
+import {
+  AD_PREVIEW_DIR,
+  renderAdPreviews
+} from "./chunk-EGVWSAWY.js";
+import "./chunk-VN3WDB4O.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-VJUVTMHY.js";
+import "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/preview.ts
+import { writeFileSync } from "fs";
+import { defineCommand } from "citty";
+var previewCommand = defineCommand({
+  meta: {
+    name: "preview",
+    description: `See an existing LinkedIn ad exactly as people see it in the feed \u2014 LinkedIn's own renderer,
+for desktop and mobile. Returns shownText (the text displayed, in order) and a picture of each;
+Read the picture only for what text cannot tell (words in the artwork, cropping, how it looks).
+
+Start here before saying anything about how an ad LOOKS (which text shows, whether the headline
+appears under the image, what the button says): the API fields say what is stored, the preview
+shows what is displayed. Works for single image, carousel, video, event and job ads that already
+exist on LinkedIn; staged (unpublished) ads have no preview yet.
+
+Examples:
+  baker ads linkedin preview 1611562694 --account-id 503001492
+  baker ads linkedin preview 1611562694 --placement mobile
+  baker ads linkedin preview 1611562694 --out-dir /tmp/review`
+  },
+  args: {
+    id: { type: "positional", description: "Creative id or urn:li:sponsoredCreative:N", required: true },
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    placement: { type: "string", description: "desktop|mobile|both (default: both)", default: "both" },
+    "out-dir": { type: "string", description: `Folder for the pictures (default: ${AD_PREVIEW_DIR})` },
+    "html-file": { type: "string", description: "Also save LinkedIn's raw preview iframes to this file" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    const placement = String(args.placement);
+    if (!["desktop", "mobile", "both"].includes(placement)) {
+      writeJsonEnvelope({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: "--placement must be desktop, mobile or both" }
+      });
+      process.exit(1);
+    }
+    try {
+      const body = { accountId, creativeId: String(args.id) };
+      const data = await apiPost("/api/ads/linkedin/preview", body);
+      const wanted = data.previews.filter((p) => placement === "both" || p.placement === placement);
+      if (wanted.length === 0) {
+        writeJsonEnvelope({
+          ok: true,
+          data: { creativeId: data.creativeId, previews: [] },
+          hints: [
+            "LinkedIn returned no preview for this ad (its format may not support one). Say its look could not be checked; do not describe it from the API fields."
+          ]
+        });
+        return;
+      }
+      if (args["html-file"]) {
+        writeFileSync(String(args["html-file"]), wanted.map((p) => p.html).join("\n"), "utf-8");
+      }
+      const rendered = await renderAdPreviews(wanted, {
+        dir: args["out-dir"] ? String(args["out-dir"]) : AD_PREVIEW_DIR,
+        name: `linkedin-${data.creativeId}`
+      });
+      writeJsonEnvelope({
+        ok: true,
+        data: { creativeId: data.creativeId, previews: rendered.previews },
+        hints: rendered.hints
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  previewCommand
+};
+//# sourceMappingURL=preview-JITAEUWU.js.map

package/dist/profile-OYCGBQWF.js

@@ -0,0 +1,159 @@
+import {
+  IDEA_HINT
+} from "./chunk-UDNN4POE.js";
+import {
+  reportError
+} from "./chunk-VRQ5HEVU.js";
+import {
+  apiGet
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.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-OYCGBQWF.js.map

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

@@ -0,0 +1,183 @@
+import {
+  csvArg,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-2NXACVED.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-RM5JT6XF.js";
+import "./chunk-VJUVTMHY.js";
+import {
+  TARGETING_OPERATORS,
+  TARGETING_TYPES
+} from "./chunk-AJ4OO3CV.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-3WOFZTGC.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.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-K7YJNRMS.js.map