@koda-sl/baker-cli 0.533.0 → 0.534.0-dev.4da06ee4d

package/dist/preview-LA3P4TAF.js

@@ -0,0 +1,218 @@
+import {
+  FACEBOOK_PREVIEW_FORMATS,
+  INSTAGRAM_PREVIEW_FORMATS,
+  PLATFORM_SCOPED_POSITIONS,
+  previewFormatForPosition
+} from "./chunk-GC5P4KWY.js";
+import "./chunk-GDFJOCDO.js";
+import {
+  handleMetaError
+} from "./chunk-PMKNHE6G.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-QG45DH5D.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-HBMHTFKS.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiPost
+} from "./chunk-IKZHHMG4.js";
+import "./chunk-DUWJG6QH.js";
+import "./chunk-XKJO6WSY.js";
+import "./chunk-ERCYMMBF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/preview.ts
+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}`;
+}
+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'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);
+      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-LA3P4TAF.js.map

package/dist/profile-VKYAKK5B.js

@@ -0,0 +1,159 @@
+import {
+  IDEA_HINT
+} from "./chunk-Q4L4Z2HT.js";
+import {
+  reportError
+} from "./chunk-CAYIC3ES.js";
+import {
+  apiGet
+} from "./chunk-IKZHHMG4.js";
+import "./chunk-DUWJG6QH.js";
+import "./chunk-XKJO6WSY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-ERCYMMBF.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-VKYAKK5B.js.map

package/dist/promoted-tweet-writes-2O75KPVF.js

@@ -0,0 +1,183 @@
+import {
+  csvArg,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-ZBKDD3SZ.js";
+import "./chunk-FIN4ZXGJ.js";
+import "./chunk-AZEJ727R.js";
+import "./chunk-QG45DH5D.js";
+import {
+  TARGETING_OPERATORS,
+  TARGETING_TYPES
+} from "./chunk-WNIDYKWO.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-MUS2UTWU.js";
+import "./chunk-IKZHHMG4.js";
+import "./chunk-DUWJG6QH.js";
+import "./chunk-XKJO6WSY.js";
+import {
+  registerSchema
+} from "./chunk-ERCYMMBF.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-2O75KPVF.js.map

package/dist/promoted-tweets-6TF3VYJ2.js

@@ -0,0 +1,119 @@
+import {
+  parseXApiError
+} from "./chunk-FIN4ZXGJ.js";
+import {
+  resolveXAccountId
+} from "./chunk-AZEJ727R.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-QG45DH5D.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-IKZHHMG4.js";
+import "./chunk-DUWJG6QH.js";
+import "./chunk-XKJO6WSY.js";
+import {
+  registerSchema
+} from "./chunk-ERCYMMBF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/promoted-tweets.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.promotedTweets",
+  description: "List promoted tweets for an X Ads account. Returns id, line_item_id, tweet_id, approval_status. Filter by line-item-ids (CSV).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var promotedTweetsListCommand = defineCommand({
+  meta: {
+    name: "promoted-tweets",
+    description: `List X Ads promoted tweets.
+
+Examples:
+  baker ads x promoted-tweets --account-id 18ce53xyz --line-item-ids abc,def`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs", required: false },
+    "with-deleted": { type: "boolean", description: "Include deleted", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const cacheKey = `promoted-tweets:${accountId}:${today}:${args["line-item-ids"] ?? ""}:${args["with-deleted"] ? "1" : "0"}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["line-item-ids"]) params["line-item-ids"] = args["line-item-ids"];
+      if (args["with-deleted"]) params["with-deleted"] = "true";
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/promoted-tweets", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+var promotedTweetsCommand = defineCommand({
+  meta: {
+    name: "promoted-tweets",
+    description: `Promoted posts \u2014 the association between a post and an ad group, which X Ads Manager calls an ad.
+
+There is no pause: removing the association is the only way to stop one serving,
+and it cannot be undone (re-promoting creates a new one). The post itself is
+never touched.
+
+Examples:
+  baker ads x promoted-tweets
+  baker ads x promoted-tweets create --line-item-id wiee9 --tweet-ids 2042198488033661285
+  baker ads x promoted-tweets remove ayyorn`
+  },
+  subCommands: {
+    list: promotedTweetsListCommand,
+    create: () => import("./promoted-tweet-writes-2O75KPVF.js").then((m) => m.promotedTweetsCreateCommand),
+    remove: () => import("./promoted-tweet-writes-2O75KPVF.js").then((m) => m.promotedTweetsRemoveCommand)
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID" },
+    "line-item-ids": { type: "string", description: "CSV of line item IDs" },
+    "with-deleted": { type: "boolean", description: "Include deleted" },
+    "no-cache": { type: "boolean", description: "Skip cache" },
+    output: { type: "string", description: "Format: json|csv|md", default: "json" }
+  },
+  default: "list"
+});
+export {
+  promotedTweetsCommand
+};
+//# sourceMappingURL=promoted-tweets-6TF3VYJ2.js.map