@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/pixels-TZPF746S.js

@@ -0,0 +1,60 @@
+import {
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-7J6EHOH6.js";
+import {
+  CHATGPT_ADS_REFERENCE
+} from "./chunk-FTWJFDIN.js";
+import "./chunk-VFIOJD5M.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/pixels.ts
+import { defineCommand } from "citty";
+var CREATE_ARGS = {
+  name: { type: "string", description: "What the pixel is called in Ads Manager, e.g. withbaker.com", required: true }
+};
+function pixelCreateOp(args) {
+  return { kind: "pixel.create", payload: { name: typeof args.name === "string" ? args.name.trim() : args.name } };
+}
+registerSchema({
+  command: "ads.chatgpt.pixels.create",
+  description: "Stage a new website pixel for the account, applied when the chat is published. Read `conversions` first: an account usually needs one pixel, installed on every page, and a second splits the site's events.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var pixelsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a new website pixel (applies when the chat is published).
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(pixelCreateOp(args), CHATGPT_ADS_REFERENCE.conversions, (staged) => [
+      `Define what it counts with \`baker ads chatgpt conversions create --pixel ${staged.ref} --name \u2026 --event \u2026\`.`,
+      "After the publish, read its Pixel ID with `baker ads chatgpt conversions` and install it on the site's pages as a tracking tag."
+    ]);
+  }
+});
+var pixelsCommand = defineCommand({
+  meta: {
+    name: "pixels",
+    description: `Website pixels \u2014 what a site installs so ChatGPT Ads can count its conversions. Read them with \`baker ads chatgpt conversions\`.
+
+Example:
+  baker ads chatgpt pixels create --name "withbaker.com"`
+  },
+  subCommands: { create: pixelsCreateCommand }
+});
+export {
+  pixelCreateOp,
+  pixelsCommand
+};
+//# sourceMappingURL=pixels-TZPF746S.js.map

package/dist/pixels-TZPF746S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/pixels.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { CHATGPT_ADS_REFERENCE } from \"./shared.ts\";\nimport { schemaArgs, stageChatgptOp } from \"./write-shared.ts\";\n\n/**\n * A new website pixel, staged like every write. Its Pixel ID — what the site\n * installs — exists only after the chat publishes; a conversion staged beside it\n * counts from it by its ref.\n */\n\nconst CREATE_ARGS = {\n  name: { type: \"string\", description: \"What the pixel is called in Ads Manager, e.g. withbaker.com\", required: true },\n} as const;\n\nexport function pixelCreateOp(args: Record<string, unknown>): Record<string, unknown> {\n  return { kind: \"pixel.create\", payload: { name: typeof args.name === \"string\" ? args.name.trim() : args.name } };\n}\n\nregisterSchema({\n  command: \"ads.chatgpt.pixels.create\",\n  description:\n    \"Stage a new website pixel for the account, applied when the chat is published. Read `conversions` first: an account usually needs one pixel, installed on every page, and a second splits the site's events.\",\n  args: schemaArgs(CREATE_ARGS),\n});\n\nconst pixelsCreateCommand = defineCommand({\n  meta: {\n    name: \"create\",\n    description: `Stage a new website pixel (applies when the chat is published).\n\nExample:\n  baker ads chatgpt pixels create --name \"withbaker.com\"`,\n  },\n  args: CREATE_ARGS,\n  run: async ({ args }) => {\n    await stageChatgptOp(pixelCreateOp(args), CHATGPT_ADS_REFERENCE.conversions, (staged) => [\n      `Define what it counts with \\`baker ads chatgpt conversions create --pixel ${staged.ref} --name … --event …\\`.`,\n      \"After the publish, read its Pixel ID with `baker ads chatgpt conversions` and install it on the site's pages as a tracking tag.\",\n    ]);\n  },\n});\n\nexport const pixelsCommand = defineCommand({\n  meta: {\n    name: \"pixels\",\n    description: `Website pixels — what a site installs so ChatGPT Ads can count its conversions. Read them with \\`baker ads chatgpt conversions\\`.\n\nExample:\n  baker ads chatgpt pixels create --name \"withbaker.com\"`,\n  },\n  subCommands: { create: pixelsCreateCommand },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAW9B,IAAM,cAAc;AAAA,EAClB,MAAM,EAAE,MAAM,UAAU,aAAa,+DAA+D,UAAU,KAAK;AACrH;AAEO,SAAS,cAAc,MAAwD;AACpF,SAAO,EAAE,MAAM,gBAAgB,SAAS,EAAE,MAAM,OAAO,KAAK,SAAS,WAAW,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,EAAE;AACjH;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,WAAW,WAAW;AAC9B,CAAC;AAED,IAAM,sBAAsB,cAAc;AAAA,EACxC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,eAAe,cAAc,IAAI,GAAG,sBAAsB,aAAa,CAAC,WAAW;AAAA,MACvF,6EAA6E,OAAO,GAAG;AAAA,MACvF;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,aAAa,EAAE,QAAQ,oBAAoB;AAC7C,CAAC;","names":[]}

package/dist/pixels-ZFF4BGUH.js

@@ -0,0 +1,108 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleMetaError,
+  resolveAccountIdArg,
+  todayIso
+} from "./chunk-KLNKEVIY.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-VFIOJD5M.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import {
+  apiGet
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/pixels.ts
+import { defineCommand } from "citty";
+var pixelsCommand = defineCommand({
+  meta: {
+    name: "pixels",
+    description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.
+
+Examples:
+  baker ads meta pixels --account-id act_123
+  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`
+  },
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID" },
+    "pixel-id": { type: "string", description: "Pixel ID for --stats" },
+    stats: { type: "boolean", description: "Fetch firing stats for the pixel" },
+    aggregation: {
+      type: "string",
+      description: "stats aggregation: event|browser_type|host|pixel_fire",
+      default: "event"
+    },
+    days: { type: "string", description: "Lookback days for --stats (default 7)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "Output format", default: "json" }
+  },
+  run: async ({ args }) => {
+    try {
+      if (args.stats) {
+        await runStats(args);
+        return;
+      }
+      await runList(args);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+async function runStats(args) {
+  const pixelId = args["pixel-id"];
+  if (!pixelId) {
+    handleMetaError(new Error("--pixel-id is required when --stats is set"));
+  }
+  const days = args.days ? Number(args.days) : 7;
+  if (!Number.isInteger(days) || days <= 0 || days > 90) {
+    handleMetaError(new Error("--days must be a positive integer \u2264 90"));
+  }
+  const params = {
+    "pixel-id": pixelId,
+    aggregation: args.aggregation ?? "event",
+    "start-time": daysAgoIso(days),
+    "end-time": todayIso()
+  };
+  if (args["no-cache"]) params["skip-cache"] = "true";
+  const data = await apiGet("/api/ads/meta/pixel-stats", params);
+  emit(data, args);
+}
+async function runList(args) {
+  const accountId = resolveAccountIdArg(args);
+  const params = { "account-id": accountId };
+  if (args["no-cache"]) params["skip-cache"] = "true";
+  const { pixels, restrictedFields } = await apiGet("/api/ads/meta/pixels", params);
+  emit(pixels, args, pixelWarnings(restrictedFields));
+}
+function pixelWarnings(restrictedFields) {
+  if (restrictedFields.length === 0) {
+    return [];
+  }
+  return [
+    {
+      code: "PIXEL_FIELDS_RESTRICTED",
+      message: `Meta withheld ${restrictedFields.join(", ")} for these pixels \u2014 the connected user holds no role in the Business that owns them. IDs, names, creation and last-fired times are complete; install code and setup details are not. To get them, the client assigns the pixel to the connected user in Meta Business settings \u2192 Data sources \u2192 Datasets.`
+    }
+  ];
+}
+function emit(data, args, warnings = []) {
+  const fmt = csvOrJson(args);
+  if (fmt !== "json") {
+    writeAdsOutput(data, fmt);
+    return;
+  }
+  writeAdsJson({ ok: true, data, ...warnings.length > 0 ? { warnings } : {} });
+}
+export {
+  pixelWarnings,
+  pixelsCommand
+};
+//# sourceMappingURL=pixels-ZFF4BGUH.js.map

package/dist/pixels-ZFF4BGUH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/pixels.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport type { AdsWarning } from \"../types.ts\";\nimport { csvOrJson, daysAgoIso, handleMetaError, resolveAccountIdArg, todayIso } from \"./shared.ts\";\n\nexport const pixelsCommand = defineCommand({\n  meta: {\n    name: \"pixels\",\n    description: `List Meta Pixels for an ad account, or fetch firing stats for one pixel.\n\nExamples:\n  baker ads meta pixels --account-id act_123\n  baker ads meta pixels --account-id act_123 --pixel-id 9876 --stats --days 7`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n    \"pixel-id\": { type: \"string\", description: \"Pixel ID for --stats\" },\n    stats: { type: \"boolean\", description: \"Fetch firing stats for the pixel\" },\n    aggregation: {\n      type: \"string\",\n      description: \"stats aggregation: event|browser_type|host|pixel_fire\",\n      default: \"event\",\n    },\n    days: { type: \"string\", description: \"Lookback days for --stats (default 7)\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"Output format\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    try {\n      if (args.stats) {\n        await runStats(args);\n        return;\n      }\n      await runList(args);\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nasync function runStats(args: Record<string, unknown>): Promise<void> {\n  const pixelId = args[\"pixel-id\"] as string | undefined;\n  if (!pixelId) {\n    handleMetaError(new Error(\"--pixel-id is required when --stats is set\"));\n  }\n  const days = args.days ? Number(args.days) : 7;\n  if (!Number.isInteger(days) || days <= 0 || days > 90) {\n    handleMetaError(new Error(\"--days must be a positive integer ≤ 90\"));\n  }\n  const params: Record<string, string> = {\n    \"pixel-id\": pixelId,\n    aggregation: (args.aggregation as string) ?? \"event\",\n    \"start-time\": daysAgoIso(days),\n    \"end-time\": todayIso(),\n  };\n  if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n  const data = await apiGet<Array<Record<string, unknown>>>(\"/api/ads/meta/pixel-stats\", params);\n  emit(data, args);\n}\n\nasync function runList(args: Record<string, unknown>): Promise<void> {\n  const accountId = resolveAccountIdArg(args);\n  const params: Record<string, string> = { \"account-id\": accountId };\n  if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n  const { pixels, restrictedFields } = await apiGet<{\n    pixels: Array<Record<string, unknown>>;\n    restrictedFields: string[];\n  }>(\"/api/ads/meta/pixels\", params);\n  emit(pixels, args, pixelWarnings(restrictedFields));\n}\n\n/**\n * A listing Meta trimmed is still a listing — IDs, names and firing times are\n * complete. Say which setup fields are missing and how to get them, so the gap\n * reads as a client-side access grant rather than as a pixel that isn't there.\n */\nexport function pixelWarnings(restrictedFields: string[]): AdsWarning[] {\n  if (restrictedFields.length === 0) {\n    return [];\n  }\n  return [\n    {\n      code: \"PIXEL_FIELDS_RESTRICTED\",\n      message:\n        `Meta withheld ${restrictedFields.join(\", \")} for these pixels — the connected user holds no role in the Business that owns them. ` +\n        \"IDs, names, creation and last-fired times are complete; install code and setup details are not. \" +\n        \"To get them, the client assigns the pixel to the connected user in Meta Business settings → Data sources → Datasets.\",\n    },\n  ];\n}\n\nfunction emit(data: Array<Record<string, unknown>>, args: Record<string, unknown>, warnings: AdsWarning[] = []): void {\n  const fmt = csvOrJson(args);\n  if (fmt !== \"json\") {\n    writeAdsOutput(data, fmt);\n    return;\n  }\n  writeAdsJson({ ok: true, data, ...(warnings.length > 0 ? { warnings } : {}) });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAOvB,IAAM,gBAAgB,cAAc;AAAA,EACzC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKf;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,qBAAqB;AAAA,IAClE,YAAY,EAAE,MAAM,UAAU,aAAa,uBAAuB;AAAA,IAClE,OAAO,EAAE,MAAM,WAAW,aAAa,mCAAmC;AAAA,IAC1E,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA,MAAM,EAAE,MAAM,UAAU,aAAa,wCAAwC;AAAA,IAC7E,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,iBAAiB,SAAS,OAAO;AAAA,EAC1E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,UAAI,KAAK,OAAO;AACd,cAAM,SAAS,IAAI;AACnB;AAAA,MACF;AACA,YAAM,QAAQ,IAAI;AAAA,IACpB,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;AAED,eAAe,SAAS,MAA8C;AACpE,QAAM,UAAU,KAAK,UAAU;AAC/B,MAAI,CAAC,SAAS;AACZ,oBAAgB,IAAI,MAAM,4CAA4C,CAAC;AAAA,EACzE;AACA,QAAM,OAAO,KAAK,OAAO,OAAO,KAAK,IAAI,IAAI;AAC7C,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,QAAQ,KAAK,OAAO,IAAI;AACrD,oBAAgB,IAAI,MAAM,6CAAwC,CAAC;AAAA,EACrE;AACA,QAAM,SAAiC;AAAA,IACrC,YAAY;AAAA,IACZ,aAAc,KAAK,eAA0B;AAAA,IAC7C,cAAc,WAAW,IAAI;AAAA,IAC7B,YAAY,SAAS;AAAA,EACvB;AACA,MAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,QAAM,OAAO,MAAM,OAAuC,6BAA6B,MAAM;AAC7F,OAAK,MAAM,IAAI;AACjB;AAEA,eAAe,QAAQ,MAA8C;AACnE,QAAM,YAAY,oBAAoB,IAAI;AAC1C,QAAM,SAAiC,EAAE,cAAc,UAAU;AACjE,MAAI,KAAK,UAAU,EAAG,QAAO,YAAY,IAAI;AAC7C,QAAM,EAAE,QAAQ,iBAAiB,IAAI,MAAM,OAGxC,wBAAwB,MAAM;AACjC,OAAK,QAAQ,MAAM,cAAc,gBAAgB,CAAC;AACpD;AAOO,SAAS,cAAc,kBAA0C;AACtE,MAAI,iBAAiB,WAAW,GAAG;AACjC,WAAO,CAAC;AAAA,EACV;AACA,SAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,SACE,iBAAiB,iBAAiB,KAAK,IAAI,CAAC;AAAA,IAGhD;AAAA,EACF;AACF;AAEA,SAAS,KAAK,MAAsC,MAA+B,WAAyB,CAAC,GAAS;AACpH,QAAM,MAAM,UAAU,IAAI;AAC1B,MAAI,QAAQ,QAAQ;AAClB,mBAAe,MAAM,GAAG;AACxB;AAAA,EACF;AACA,eAAa,EAAE,IAAI,MAAM,MAAM,GAAI,SAAS,SAAS,IAAI,EAAE,SAAS,IAAI,CAAC,EAAG,CAAC;AAC/E;","names":[]}

package/dist/preview-AD4GKYIA.js

@@ -0,0 +1,169 @@
+import {
+  FACEBOOK_PREVIEW_FORMATS,
+  INSTAGRAM_PREVIEW_FORMATS,
+  PLATFORM_SCOPED_POSITIONS,
+  previewFormatForPosition
+} from "./chunk-GOJXKIFQ.js";
+import {
+  handleMetaError
+} from "./chunk-KLNKEVIY.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-VFIOJD5M.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import {
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import "./chunk-NU7JSWVA.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-AD4GKYIA.js.map

package/dist/preview-AD4GKYIA.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":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAO9B,SAAS,qBAAqB;AAM9B,IAAM,mBAAmB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,SAAS,sBAAsB,SAAwB;AACrD,eAAa,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,oBAAoB,QAAQ,EAAE,CAAC;AACxE,UAAQ,KAAK,CAAC;AAChB;AASA,SAAS,iBAAiB,UAAkB,UAA2B;AACrE,QAAM,cAAc,OAAO,aAAa,WAAW,SAAS,YAAY,IAAI;AAC5E,MAAI,eAAe,gBAAgB,cAAc,gBAAgB,aAAa;AAC5E,0BAAsB,0CAA0C;AAAA,EAClE;AACA,QAAM,SAAS,yBAAyB,UAAU,WAAW;AAC7D,MAAI,QAAQ;AACV,WAAO;AAAA,EACT;AACA,MAAI,0BAA0B,IAAI,QAAQ,KAAK,CAAC,aAAa;AAC3D;AAAA,MACE,eAAe,QAAQ;AAAA,IACzB;AAAA,EACF;AACA;AAAA,IACE,sDAAsD,QAAQ,qbAAgb,eAAe,CAAC;AAAA,EAChgB;AACF;AAEA,SAAS,iBAAyB;AAChC,QAAM,WAAW,OAAO,KAAK,wBAAwB,EAAE,KAAK,IAAI;AAChE,QAAM,YAAY,OAAO,KAAK,yBAAyB,EAAE,KAAK,IAAI;AAClE,SAAO,mBAAc,QAAQ,sBAAiB,SAAS;AACzD;AAEO,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaf;AAAA,EACA,MAAM;AAAA,IACJ,eAAe,EAAE,MAAM,UAAU,aAAa,uBAAuB;AAAA,IACrE,SAAS,EAAE,MAAM,UAAU,aAAa,iBAAiB;AAAA,IACzD,cAAc,EAAE,MAAM,UAAU,aAAa,0DAA0D;AAAA,IACvG,UAAU,EAAE,MAAM,UAAU,aAAa,gEAAgE;AAAA,IACzG,aAAa,EAAE,MAAM,UAAU,aAAa,yDAAyD;AAAA,IACrG,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aACE;AAAA,IACJ;AAAA,IACA,UAAU,EAAE,MAAM,UAAU,aAAa,6EAAwE;AAAA,IACjH,gBAAgB,EAAE,MAAM,WAAW,aAAa,+DAA+D;AAAA,IAC/G,YAAY,EAAE,MAAM,UAAU,aAAa,gCAAgC;AAAA,IAC3E,YAAY;AAAA,EACd;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI,KAAK,cAAc,GAAG;AACxB,mBAAa;AAAA,QACX,IAAI;AAAA,QACJ,MAAM;AAAA,UACJ,WAAW;AAAA,UACX,YAAY,EAAE,UAAU,0BAA0B,WAAW,0BAA0B;AAAA,QACzF;AAAA,MACF,CAAC;AACD;AAAA,IACF;AAEA,UAAM,YAAY,KAAK;AACvB,UAAM,WAAW,YAAY,iBAAiB,WAAW,KAAK,QAAQ,IAAK,KAAK,WAAW;AAC3F,QAAI,CAAC,UAAU;AACb,4BAAsB,sDAAsD;AAAA,IAC9E;AACA,QAAI,CAAC,iBAAiB,SAAS,QAAQ,GAAG;AACxC;AAAA,QACE,wBAAwB,QAAQ,6EAA6E,iBAAiB,KAAK,IAAI,CAAC;AAAA,MAC1I;AAAA,IACF;AACA,UAAM,OAAgC,EAAE,SAAS;AACjD,QAAI,KAAK,aAAa,EAAG,MAAK,aAAa,KAAK,aAAa;AAC7D,QAAI,KAAK,OAAO,EAAG,MAAK,OAAO,KAAK,OAAO;AAC3C,QAAI,KAAK,YAAY,EAAG,MAAK,YAAY,KAAK,YAAY;AAC1D,QAAI,KAAK,SAAU,MAAK,WAAW,KAAK;AACxC,QAAI,KAAK,UAAU,EAAG,MAAK,YAAY;AAEvC,QAAI;AACF,YAAM,OAAO,MAAM,QAAiC,yBAAyB,IAAI;AACjF,YAAM,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,IAAI;AAC9C,YAAM,QAAQ,YACV;AAAA,QACE,YAAY,SAAS,iBAAiB,QAAQ;AAAA,MAChD,IACA,CAAC;AACL,UAAI,KAAK,UAAU,GAAG;AACpB,cAAM,UAAU,EAAE,IAAI,MAAe,MAAM,EAAE,MAAM,KAAK,UAAU,GAAG,MAAM,KAAK,QAAQ,SAAS,EAAE;AACnG,sBAAc,KAAK,UAAU,GAAa,MAAM,OAAO;AACvD,0BAAkB,MAAM,SAAS,IAAI,EAAE,GAAG,SAAS,MAAM,IAAI,OAAO;AACpE;AAAA,MACF;AACA,wBAAkB,MAAM,SAAS,IAAI,EAAE,IAAI,MAAM,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IACrF,SAAS,KAAK;AACZ,sBAAgB,GAAG;AAAA,IACrB;AAAA,EACF;AACF,CAAC;","names":[]}

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

@@ -0,0 +1,180 @@
+import {
+  csvArg,
+  requireTargets,
+  stageAccountId,
+  stageXOp,
+  stageXOps
+} from "./chunk-OKG6GX2F.js";
+import "./chunk-M6UNISGO.js";
+import "./chunk-C6U6UDHJ.js";
+import "./chunk-VFIOJD5M.js";
+import {
+  TARGETING_OPERATORS,
+  TARGETING_TYPES
+} from "./chunk-XWH7CCBL.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-WYCVJIHD.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-XML7AJM3.js";
+import "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.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-F76YIMB6.js.map

package/dist/promoted-tweet-writes-F76YIMB6.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":[]}