@koda-sl/baker-cli 0.554.0 → 0.556.0

package/dist/posts-MVCGZV54.js

@@ -1,36 +0,0 @@
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/posts/index.ts
-import { defineCommand } from "citty";
-var postsCommand = defineCommand({
-  meta: {
-    name: "posts",
-    description: `The posts the company's followed accounts published \u2014 its own pages and its key people (CEO, CTO, head of sales\u2026) on LinkedIn, Instagram, TikTok, YouTube and Facebook \u2014 text-only ones included, with their likes, comments and views, and whether each can run as a paid ad (usable \xB7 needs the author's OK \xB7 can't). Accounts are followed with \`baker media-sources add\`. Subcommands: list, get, search, add, suggest, approved, tag, refresh.
-
-Examples:
-  baker posts list --role ceo --usable needs_approval      # the CEO's posts a Thought Leader ad can boost
-  baker posts list --account linkedin:acme --sort engagement --since 2026-09-01
-  baker posts list --about-company                         # people's posts that name the company (ABM)
-  baker posts search "series A"
-  baker posts get <post-id>
-  baker posts add https://www.linkedin.com/posts/jane-doe_activity-7477679889043750912-K2pu
-  baker posts suggest <post-id> --verdict usable --note "Best-performing CEO post this month"
-  baker posts approved <post-id> --account-id 513852526       # the user says the author already approved it
-  baker ads linkedin creatives create --format tla --post <post-id> --campaign <ad set>
-Full guide: __tooling__/docs/tools/baker/posts.md`
-  },
-  subCommands: {
-    list: () => import("./list-2NWMHKTR.js").then((m) => m.listCommand),
-    get: () => import("./get-X44ZCIFN.js").then((m) => m.getCommand),
-    search: () => import("./search-EKTUTXVN.js").then((m) => m.searchCommand),
-    add: () => import("./add-CSRB6GVJ.js").then((m) => m.addCommand),
-    suggest: () => import("./suggest-DSMKK4FP.js").then((m) => m.suggestCommand),
-    approved: () => import("./approved-RP5ADN7E.js").then((m) => m.approvedCommand),
-    tag: () => import("./tag-L2H5TSFJ.js").then((m) => m.tagCommand),
-    refresh: () => import("./refresh-BKYZXXRF.js").then((m) => m.refreshCommand)
-  }
-});
-export {
-  postsCommand
-};
-//# sourceMappingURL=posts-MVCGZV54.js.map

package/dist/preview-DMTQR6ZW.js

@@ -1,218 +0,0 @@
-import {
-  FACEBOOK_PREVIEW_FORMATS,
-  INSTAGRAM_PREVIEW_FORMATS,
-  PLATFORM_SCOPED_POSITIONS,
-  previewFormatForPosition
-} from "./chunk-GC5P4KWY.js";
-import "./chunk-GDFJOCDO.js";
-import {
-  handleMetaError
-} from "./chunk-QY7EK6Q4.js";
-import "./chunk-QALAJNBG.js";
-import {
-  writeAdsJson,
-  writeJsonEnvelope
-} from "./chunk-QYH2UZAK.js";
-import {
-  NO_CACHE_ARG
-} from "./chunk-GO6ISZUZ.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import {
-  apiPost
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import "./chunk-CCYZJMZ7.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-DMTQR6ZW.js.map

package/dist/preview-DMTQR6ZW.js.map

@@ -1 +0,0 @@
-{"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\n/**\n * The `ad_format` enum of `generatepreviews` as Meta's reference lists it (every value rendered live on v26.0, 2026-10-15)\n * (read 2026-10-14), plus INSTAGRAM_SHOP — dropped from that list yet still\n * rendered live the same day, so a format an older answer named keeps working.\n */\nconst VALID_AD_FORMATS = [\n  \"AUDIENCE_NETWORK_INSTREAM_VIDEO\",\n  \"AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE\",\n  \"AUDIENCE_NETWORK_OUTSTREAM_VIDEO\",\n  \"AUDIENCE_NETWORK_REWARDED_VIDEO\",\n  \"BIZ_DISCO_FEED_MOBILE\",\n  \"DESKTOP_FEED_STANDARD\",\n  \"FACEBOOK_IFU_REELS_MOBILE\",\n  \"FACEBOOK_PROFILE_FEED_DESKTOP\",\n  \"FACEBOOK_PROFILE_FEED_MOBILE\",\n  \"FACEBOOK_PROFILE_REELS_MOBILE\",\n  \"FACEBOOK_REELS_BANNER\",\n  \"FACEBOOK_REELS_BANNER_DESKTOP\",\n  \"FACEBOOK_REELS_BANNER_FEED_ANDROID\",\n  \"FACEBOOK_REELS_BANNER_FEED_ANDROID_LARGE\",\n  \"FACEBOOK_REELS_BANNER_FULLSCREEN_IOS\",\n  \"FACEBOOK_REELS_BANNER_FULLSCREEN_MOBILE\",\n  \"FACEBOOK_REELS_MOBILE\",\n  \"FACEBOOK_REELS_POSTLOOP\",\n  \"FACEBOOK_REELS_POSTLOOP_FEED\",\n  \"FACEBOOK_REELS_SIMILAR_PRODUCTS_MOBILE\",\n  \"FACEBOOK_REELS_STICKER\",\n  \"FACEBOOK_STORY_MOBILE\",\n  \"FACEBOOK_STORY_STICKER_MOBILE\",\n  \"INSTAGRAM_EXPLORE_CONTEXTUAL\",\n  \"INSTAGRAM_EXPLORE_GRID_HOME\",\n  \"INSTAGRAM_EXPLORE_IMMERSIVE\",\n  \"INSTAGRAM_FEED_WEB\",\n  \"INSTAGRAM_FEED_WEB_M_SITE\",\n  \"INSTAGRAM_LEAD_GEN_MULTI_SUBMIT_ADS\",\n  \"INSTAGRAM_PROFILE_FEED\",\n  \"INSTAGRAM_PROFILE_REELS\",\n  \"INSTAGRAM_REELS\",\n  \"INSTAGRAM_REELS_OVERLAY\",\n  \"INSTAGRAM_REELS_WEB\",\n  \"INSTAGRAM_REELS_WEB_M_SITE\",\n  \"INSTAGRAM_SEARCH_CHAIN\",\n  \"INSTAGRAM_SEARCH_GRID\",\n  \"INSTAGRAM_SHOP\",\n  \"INSTAGRAM_STANDARD\",\n  \"INSTAGRAM_STORY\",\n  \"INSTAGRAM_STORY_EFFECT_TRAY\",\n  \"INSTAGRAM_STORY_WEB\",\n  \"INSTAGRAM_STORY_WEB_M_SITE\",\n  \"INSTANT_ARTICLE_RECIRCULATION_AD\",\n  \"INSTANT_ARTICLE_STANDARD\",\n  \"INSTREAM_BANNER_DESKTOP\",\n  \"INSTREAM_BANNER_FEED_IOS\",\n  \"INSTREAM_BANNER_FULLSCREEN_IOS\",\n  \"INSTREAM_BANNER_FULLSCREEN_MOBILE\",\n  \"INSTREAM_BANNER_IMMERSIVE_MOBILE\",\n  \"INSTREAM_BANNER_MOBILE\",\n  \"INSTREAM_VIDEO_DESKTOP\",\n  \"INSTREAM_VIDEO_FULLSCREEN_IOS\",\n  \"INSTREAM_VIDEO_FULLSCREEN_MOBILE\",\n  \"INSTREAM_VIDEO_IMAGE\",\n  \"INSTREAM_VIDEO_IMMERSIVE_MOBILE\",\n  \"INSTREAM_VIDEO_MOBILE\",\n  \"JOB_BROWSER_DESKTOP\",\n  \"JOB_BROWSER_MOBILE\",\n  \"MARKETPLACE_MOBILE\",\n  \"MESSENGER_MOBILE_INBOX_MEDIA\",\n  \"MESSENGER_MOBILE_STORY_MEDIA\",\n  \"MOBILE_BANNER\",\n  \"MOBILE_FEED_BASIC\",\n  \"MOBILE_FEED_STANDARD\",\n  \"MOBILE_FULLWIDTH\",\n  \"MOBILE_INTERSTITIAL\",\n  \"MOBILE_MEDIUM_RECTANGLE\",\n  \"MOBILE_NATIVE\",\n  \"RIGHT_COLUMN_STANDARD\",\n  \"SUGGESTED_VIDEO_DESKTOP\",\n  \"SUGGESTED_VIDEO_FULLSCREEN_MOBILE\",\n  \"SUGGESTED_VIDEO_IMMERSIVE_MOBILE\",\n  \"SUGGESTED_VIDEO_MOBILE\",\n  \"WATCH_FEED_HOME\",\n  \"WATCH_FEED_MOBILE\",\n  \"WHATSAPP_STATUS_MEDIA\",\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 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'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.`,\n      );\n    }\n    const body: Record<string, unknown> = { adFormat };\n    if (args[\"creative-id\"]) body.creativeId = args[\"creative-id\"];\n    if (args[\"ad-id\"]) body.adId = args[\"ad-id\"];\n    if (args[\"account-id\"]) body.accountId = args[\"account-id\"];\n    if (args.creative) body.creative = args.creative;\n    if (args[\"no-cache\"]) body.skipCache = true;\n\n    try {\n      const data = await apiPost<Array<{ body: string }>>(\"/api/ads/meta/preview\", body);\n      const html = data.map((d) => d.body).join(\"\\n\");\n      const hints = placement\n        ? [\n            `Rendered ${placement} as ad_format ${adFormat}. Open the iframe to SEE it — Meta does not document what it renders for a creative a placement cannot take, so a preview you looked at is the evidence, and anything you did not look at stays unverified.`,\n          ]\n        : [];\n      if (args[\"out-file\"]) {\n        const summary = { ok: true as const, data: { file: args[\"out-file\"], rows: data.length, adFormat } };\n        writeFileSync(args[\"out-file\"] as string, html, \"utf-8\");\n        writeJsonEnvelope(hints.length > 0 ? { ...summary, hints } : summary);\n        return;\n      }\n      writeJsonEnvelope(hints.length > 0 ? { ok: true, data, hints } : { ok: true, data });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n"],"mappings":"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","names":[]}

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

@@ -1,183 +0,0 @@
-import {
-  csvArg,
-  requireTargets,
-  stageAccountId,
-  stageXOp,
-  stageXOps
-} from "./chunk-ESXUIV6V.js";
-import "./chunk-FIN4ZXGJ.js";
-import "./chunk-H6GTG665.js";
-import "./chunk-QYH2UZAK.js";
-import {
-  TARGETING_OPERATORS,
-  TARGETING_TYPES
-} from "./chunk-RCNAKWK7.js";
-import "./chunk-QV6AST5T.js";
-import "./chunk-WCU362Z6.js";
-import "./chunk-GIWHHCD6.js";
-import "./chunk-SOPVIIUW.js";
-import "./chunk-G4FG5EQO.js";
-import "./chunk-R7XDGNZD.js";
-import "./chunk-MSMTG6OC.js";
-import "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.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-S2HP5DEI.js.map

package/dist/promoted-tweets-WZT4N5IR.js

@@ -1,119 +0,0 @@
-import {
-  parseXApiError
-} from "./chunk-FIN4ZXGJ.js";
-import {
-  resolveXAccountId
-} from "./chunk-H6GTG665.js";
-import {
-  cacheGet,
-  cacheSet,
-  writeAdsJson,
-  writeAdsOutput
-} from "./chunk-QYH2UZAK.js";
-import {
-  ApiError,
-  apiGet
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.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-S2HP5DEI.js").then((m) => m.promotedTweetsCreateCommand),
-    remove: () => import("./promoted-tweet-writes-S2HP5DEI.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-WZT4N5IR.js.map