@koda-sl/baker-cli 0.489.0 → 0.490.0

package/dist/page-photos-CXRG4AXV.js

@@ -0,0 +1,115 @@
+import {
+  bareAccountId,
+  failWriteValidation,
+  requireTarget,
+  stageOp
+} from "./chunk-5C35OW7L.js";
+import "./chunk-A4MVVPJ2.js";
+import "./chunk-HLVRHBKL.js";
+import "./chunk-QTOZ32SU.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-SFJW2KED.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-FNA277HP.js";
+import "./chunk-SWL4AAPP.js";
+import "./chunk-5WMTPYKT.js";
+import "./chunk-23H4ZJRP.js";
+import "./chunk-DWX44QL6.js";
+import "./chunk-2FSEESJU.js";
+import "./chunk-CVBKW75S.js";
+import "./chunk-BLAHHMPF.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-XDZVBX6L.js";
+import "./chunk-N5O67GK5.js";
+import "./chunk-EE72SSB2.js";
+import {
+  registerSchema
+} from "./chunk-WNSE7N75.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/page-photos.ts
+import { defineCommand } from "citty";
+var STAGED_NOTE = "Staged until publish \u2014 review with `baker ads meta draft`.";
+registerSchema({
+  command: "ads.meta.page-photos.upload",
+  description: "Stage a photo upload to a Facebook Page, NOT posted to its timeline, made at publish \u2014 for Instant Experience photo elements (`instant-experiences create --photo-id <ref>`). Needs the Page posts permission for Meta.",
+  args: {
+    "account-id": { type: "string", description: "Ad account the change is staged under", required: false },
+    "page-id": { type: "string", description: "The Facebook Page", required: true },
+    "image-id": { type: "string", description: "Baker library image id", required: false },
+    url: { type: "string", description: "Or a public https picture address", required: false },
+    caption: { type: "string", description: "Caption kept with the photo (never posted)", required: false }
+  }
+});
+var uploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: `Put a photo on a Facebook Page without posting it. ${STAGED_NOTE}
+Example: baker ads meta page-photos upload --account-id act_123 --page-id 904238019441800 --image-id <library image id>
+Then: baker ads meta instant-experiences create --page-id 904238019441800 --photo-id meta_temp_\u2026 \u2026`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or act_N" },
+    "page-id": { type: "string", description: "The Facebook Page \u2014 from `baker ads meta pages`" },
+    "image-id": { type: "string", description: "Baker library image id (`baker images library \u2026`)" },
+    url: { type: "string", description: "Or a public https picture address Meta can fetch" },
+    caption: { type: "string", description: "Caption kept with the photo; it is never posted" }
+  },
+  run: async ({ args }) => {
+    if (!args["image-id"] && !args.url) failWriteValidation("pass --image-id (a library image) or --url");
+    await stageOp(
+      {
+        kind: "pagePhoto.create",
+        accountId: bareAccountId(args),
+        payload: {
+          page_id: args["page-id"],
+          bakerImageId: args["image-id"],
+          url: args.url,
+          caption: args.caption
+        }
+      },
+      ["Use it in an Instant Experience with `instant-experiences create --photo-id <ref>`."]
+    );
+  }
+});
+registerSchema({
+  command: "ads.meta.page-photos.delete",
+  description: "Stage deleting a photo from a Facebook Page. An Instant Experience already made with it keeps it.",
+  args: {
+    id: { type: "positional", description: "Page photo id", required: true },
+    "account-id": { type: "string", description: "Ad account the change is staged under", required: false }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: `Delete a photo from its Facebook Page. ${STAGED_NOTE}
+Example: baker ads meta page-photos delete 122142489045161003 --account-id act_123`
+  },
+  args: {
+    id: { type: "positional", description: "Page photo id", required: true },
+    "account-id": { type: "string", description: "Numeric account ID or act_N" }
+  },
+  run: async ({ args }) => {
+    await stageOp({
+      kind: "pagePhoto.update",
+      accountId: bareAccountId(args),
+      target: requireTarget(args, "Page photo"),
+      payload: { status: "DELETED" }
+    });
+  }
+});
+var pagePhotosCommand = defineCommand({
+  meta: {
+    name: "page-photos",
+    description: `Photos on a Facebook Page that are never posted \u2014 for Instant Experiences and collection ads. Needs the Page posts permission for Meta.
+  baker ads meta page-photos upload --page-id <id> --image-id <library id>
+  baker ads meta page-photos delete <photo id>`
+  },
+  subCommands: { upload: uploadCommand, delete: deleteCommand }
+});
+export {
+  pagePhotosCommand
+};
+//# sourceMappingURL=page-photos-CXRG4AXV.js.map

package/dist/page-photos-CXRG4AXV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/page-photos.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { bareAccountId, failWriteValidation, requireTarget, stageOp } from \"./write-shared.ts\";\n\n/**\n * Photos put on a Facebook Page without posting them — what an Instant\n * Experience's photo element takes, and what a collection ad's four-photo\n * experience is built from. Needs the Page posts permission for Meta.\n */\n\nconst STAGED_NOTE = \"Staged until publish — review with `baker ads meta draft`.\";\ntype Args = Record<string, unknown>;\n\nregisterSchema({\n  command: \"ads.meta.page-photos.upload\",\n  description:\n    \"Stage a photo upload to a Facebook Page, NOT posted to its timeline, made at publish — for Instant Experience photo elements (`instant-experiences create --photo-id <ref>`). Needs the Page posts permission for Meta.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: false },\n    \"page-id\": { type: \"string\", description: \"The Facebook Page\", required: true },\n    \"image-id\": { type: \"string\", description: \"Baker library image id\", required: false },\n    url: { type: \"string\", description: \"Or a public https picture address\", required: false },\n    caption: { type: \"string\", description: \"Caption kept with the photo (never posted)\", required: false },\n  },\n});\n\nconst uploadCommand = defineCommand({\n  meta: {\n    name: \"upload\",\n    description: `Put a photo on a Facebook Page without posting it. ${STAGED_NOTE}\nExample: baker ads meta page-photos upload --account-id act_123 --page-id 904238019441800 --image-id <library image id>\nThen: baker ads meta instant-experiences create --page-id 904238019441800 --photo-id meta_temp_… …`,\n  },\n  args: {\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n    \"page-id\": { type: \"string\", description: \"The Facebook Page — from `baker ads meta pages`\" },\n    \"image-id\": { type: \"string\", description: \"Baker library image id (`baker images library …`)\" },\n    url: { type: \"string\", description: \"Or a public https picture address Meta can fetch\" },\n    caption: { type: \"string\", description: \"Caption kept with the photo; it is never posted\" },\n  },\n  run: async ({ args }) => {\n    if (!args[\"image-id\"] && !args.url) failWriteValidation(\"pass --image-id (a library image) or --url\");\n    await stageOp(\n      {\n        kind: \"pagePhoto.create\",\n        accountId: bareAccountId(args as Args),\n        payload: {\n          page_id: args[\"page-id\"],\n          bakerImageId: args[\"image-id\"],\n          url: args.url,\n          caption: args.caption,\n        },\n      },\n      [\"Use it in an Instant Experience with `instant-experiences create --photo-id <ref>`.\"],\n    );\n  },\n});\n\nregisterSchema({\n  command: \"ads.meta.page-photos.delete\",\n  description: \"Stage deleting a photo from a Facebook Page. An Instant Experience already made with it keeps it.\",\n  args: {\n    id: { type: \"positional\", description: \"Page photo id\", required: true },\n    \"account-id\": { type: \"string\", description: \"Ad account the change is staged under\", required: false },\n  },\n});\n\nconst deleteCommand = defineCommand({\n  meta: {\n    name: \"delete\",\n    description: `Delete a photo from its Facebook Page. ${STAGED_NOTE}\nExample: baker ads meta page-photos delete 122142489045161003 --account-id act_123`,\n  },\n  args: {\n    id: { type: \"positional\", description: \"Page photo id\", required: true },\n    \"account-id\": { type: \"string\", description: \"Numeric account ID or act_N\" },\n  },\n  run: async ({ args }) => {\n    await stageOp({\n      kind: \"pagePhoto.update\",\n      accountId: bareAccountId(args as Args),\n      target: requireTarget(args as Args, \"Page photo\"),\n      payload: { status: \"DELETED\" },\n    });\n  },\n});\n\nexport const pagePhotosCommand = defineCommand({\n  meta: {\n    name: \"page-photos\",\n    description: `Photos on a Facebook Page that are never posted — for Instant Experiences and collection ads. Needs the Page posts permission for Meta.\n  baker ads meta page-photos upload --page-id <id> --image-id <library id>\n  baker ads meta page-photos delete <photo id>`,\n  },\n  subCommands: { upload: uploadCommand, delete: deleteCommand },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAU9B,IAAM,cAAc;AAGpB,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,IACtG,WAAW,EAAE,MAAM,UAAU,aAAa,qBAAqB,UAAU,KAAK;AAAA,IAC9E,YAAY,EAAE,MAAM,UAAU,aAAa,0BAA0B,UAAU,MAAM;AAAA,IACrF,KAAK,EAAE,MAAM,UAAU,aAAa,qCAAqC,UAAU,MAAM;AAAA,IACzF,SAAS,EAAE,MAAM,UAAU,aAAa,8CAA8C,UAAU,MAAM;AAAA,EACxG;AACF,CAAC;AAED,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,sDAAsD,WAAW;AAAA;AAAA;AAAA,EAGhF;AAAA,EACA,MAAM;AAAA,IACJ,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IAC3E,WAAW,EAAE,MAAM,UAAU,aAAa,uDAAkD;AAAA,IAC5F,YAAY,EAAE,MAAM,UAAU,aAAa,yDAAoD;AAAA,IAC/F,KAAK,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,IACvF,SAAS,EAAE,MAAM,UAAU,aAAa,kDAAkD;AAAA,EAC5F;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI,CAAC,KAAK,UAAU,KAAK,CAAC,KAAK,IAAK,qBAAoB,4CAA4C;AACpG,UAAM;AAAA,MACJ;AAAA,QACE,MAAM;AAAA,QACN,WAAW,cAAc,IAAY;AAAA,QACrC,SAAS;AAAA,UACP,SAAS,KAAK,SAAS;AAAA,UACvB,cAAc,KAAK,UAAU;AAAA,UAC7B,KAAK,KAAK;AAAA,UACV,SAAS,KAAK;AAAA,QAChB;AAAA,MACF;AAAA,MACA,CAAC,qFAAqF;AAAA,IACxF;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK;AAAA,IACvE,cAAc,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,EACxG;AACF,CAAC;AAED,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa,0CAA0C,WAAW;AAAA;AAAA,EAEpE;AAAA,EACA,MAAM;AAAA,IACJ,IAAI,EAAE,MAAM,cAAc,aAAa,iBAAiB,UAAU,KAAK;AAAA,IACvE,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,EAC7E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,QAAQ;AAAA,MACZ,MAAM;AAAA,MACN,WAAW,cAAc,IAAY;AAAA,MACrC,QAAQ,cAAc,MAAc,YAAY;AAAA,MAChD,SAAS,EAAE,QAAQ,UAAU;AAAA,IAC/B,CAAC;AAAA,EACH;AACF,CAAC;AAEM,IAAM,oBAAoB,cAAc;AAAA,EAC7C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA,EAGf;AAAA,EACA,aAAa,EAAE,QAAQ,eAAe,QAAQ,cAAc;AAC9D,CAAC;","names":[]}

package/dist/{pages-FTI44OSH.js → pages-PTWRXAZT.js}

@@ -1,7 +1,7 @@
 import {
   csvOrJson,
   handleMetaError
-} from "./chunk-OP7DNHD2.js";
+} from "./chunk-QTOZ32SU.js";
 import {
   writeAdsOutput,
   writeJsonEnvelope
@@ -63,4 +63,4 @@ export {
   pageSelectionHints,
   pagesCommand
 };
-//# sourceMappingURL=pages-FTI44OSH.js.map
+//# sourceMappingURL=pages-PTWRXAZT.js.map

package/dist/{pixels-6IUB3Y3H.js → pixels-MYT3TCHZ.js}

@@ -1,7 +1,7 @@
 import {
   schemaArgs,
   stageChatgptOp
-} from "./chunk-3UXMQ3K2.js";
+} from "./chunk-AQM4JH62.js";
 import {
   CHATGPT_ADS_REFERENCE
 } from "./chunk-IG627WWY.js";
@@ -57,4 +57,4 @@ export {
   pixelCreateOp,
   pixelsCommand
 };
-//# sourceMappingURL=pixels-6IUB3Y3H.js.map
+//# sourceMappingURL=pixels-MYT3TCHZ.js.map

package/dist/{pixels-MBKR4XPX.js → pixels-ZZCQUS3J.js}

@@ -4,7 +4,7 @@ import {
   handleMetaError,
   resolveAccountIdArg,
   todayIso
-} from "./chunk-OP7DNHD2.js";
+} from "./chunk-QTOZ32SU.js";
 import {
   writeAdsJson,
   writeAdsOutput
@@ -105,4 +105,4 @@ export {
   pixelWarnings,
   pixelsCommand
 };
-//# sourceMappingURL=pixels-MBKR4XPX.js.map
+//# sourceMappingURL=pixels-ZZCQUS3J.js.map

package/dist/{preview-V4YBD45S.js → preview-XOXAAPMQ.js}

@@ -3,10 +3,11 @@ import {
   INSTAGRAM_PREVIEW_FORMATS,
   PLATFORM_SCOPED_POSITIONS,
   previewFormatForPosition
-} from "./chunk-GOJXKIFQ.js";
+} from "./chunk-A4MVVPJ2.js";
+import "./chunk-HLVRHBKL.js";
 import {
   handleMetaError
-} from "./chunk-OP7DNHD2.js";
+} from "./chunk-QTOZ32SU.js";
 import {
   writeAdsJson,
   writeJsonEnvelope
@@ -26,38 +27,83 @@ import "./chunk-YQSBHWOI.js";
 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",
-  "MOBILE_FEED_STANDARD",
-  "MOBILE_FEED_BASIC",
-  "RIGHT_COLUMN_STANDARD",
-  "MOBILE_FULLWIDTH",
-  "MOBILE_INTERSTITIAL",
-  "MOBILE_BANNER",
-  "MOBILE_MEDIUM_RECTANGLE",
-  "MOBILE_NATIVE",
-  "FACEBOOK_STORY_MOBILE",
+  "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",
-  "INSTAGRAM_STORY",
-  "INSTAGRAM_REELS",
-  "INSTAGRAM_REELS_OVERLAY",
-  "INSTAGRAM_STANDARD",
+  "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_PROFILE_FEED",
+  "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",
-  "FACEBOOK_REELS_BANNER",
-  "FACEBOOK_REELS_STICKER",
+  "JOB_BROWSER_DESKTOP",
+  "JOB_BROWSER_MOBILE",
+  "MARKETPLACE_MOBILE",
   "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"
+  "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 } });
@@ -78,7 +124,7 @@ function resolvePlacement(position, 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()}`
+    `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() {
@@ -136,7 +182,7 @@ Examples:
     }
     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.`
+        `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 };
@@ -166,4 +212,4 @@ Examples:
 export {
   previewCommand
 };
-//# sourceMappingURL=preview-V4YBD45S.js.map
+//# sourceMappingURL=preview-XOXAAPMQ.js.map

package/dist/preview-XOXAAPMQ.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\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/{rerun-A2XHGFZS.js → rerun-5THJLQQJ.js}

@@ -1,44 +1,44 @@
 import {
   executeCanvasRun
-} from "./chunk-LBO2YAZY.js";
-import "./chunk-NPMAATZG.js";
-import "./chunk-R3EKM2P2.js";
+} from "./chunk-UNX6BS4U.js";
+import "./chunk-6NCJGU6I.js";
+import "./chunk-C7NWUCLQ.js";
 import "./chunk-WN4KX7GE.js";
-import "./chunk-H5HDZ7IC.js";
+import "./chunk-DCBZ5CHZ.js";
 import "./chunk-IVIJJXXT.js";
 import "./chunk-MJQBXFW6.js";
-import "./chunk-Q6ULQMWG.js";
 import "./chunk-KKJ4KJCW.js";
+import "./chunk-Q6ULQMWG.js";
 import "./chunk-3ACMDRSE.js";
-import "./chunk-C6EYCD5J.js";
-import "./chunk-UWXDNVS5.js";
-import "./chunk-FUKDI2UK.js";
-import "./chunk-AVNSH2JE.js";
+import "./chunk-FVHJCERJ.js";
+import "./chunk-ZJSGGJ5R.js";
+import "./chunk-3W6G6ARX.js";
+import "./chunk-KOXDXSKN.js";
 import "./chunk-PA4W7BCQ.js";
-import "./chunk-EOY6BK4C.js";
-import "./chunk-QE3JEJXF.js";
-import "./chunk-2XRMPSEV.js";
+import "./chunk-GSZZLW5Q.js";
+import "./chunk-LXQB4ZGE.js";
 import "./chunk-PTGYM4J6.js";
 import "./chunk-LCW3U4EA.js";
+import "./chunk-EOY6BK4C.js";
 import "./chunk-VD73V44J.js";
 import "./chunk-G2LGMWNG.js";
 import "./chunk-P3W6SRSQ.js";
 import "./chunk-BL2MX6CR.js";
 import "./chunk-JYALBYN7.js";
-import "./chunk-BITS62MF.js";
+import "./chunk-G6XKD7QE.js";
 import "./chunk-FNA277HP.js";
 import "./chunk-5WMTPYKT.js";
 import "./chunk-23H4ZJRP.js";
-import "./chunk-6WXV5GTA.js";
-import "./chunk-62JQQUAU.js";
+import "./chunk-JVH5A3XC.js";
+import "./chunk-JQH5VG6F.js";
 import "./chunk-E2RFM6R2.js";
 import "./chunk-DGCUPJZD.js";
 import "./chunk-BTY4LZBG.js";
 import "./chunk-4AMIHNNP.js";
 import "./chunk-IKCP5NCE.js";
 import "./chunk-MCJ5I5LR.js";
-import "./chunk-KPYDTIAI.js";
-import "./chunk-KIGGMKAE.js";
+import "./chunk-2WZI36D3.js";
+import "./chunk-65Y3RCWP.js";
 import "./chunk-DWX44QL6.js";
 import "./chunk-2FSEESJU.js";
 import "./chunk-CVBKW75S.js";
@@ -87,4 +87,4 @@ var rerunCommand = defineCommand({
 export {
   rerunCommand
 };
-//# sourceMappingURL=rerun-A2XHGFZS.js.map
+//# sourceMappingURL=rerun-5THJLQQJ.js.map

package/dist/{research-BLDY5UWH.js → research-JHDWWFL7.js}

@@ -59,4 +59,4 @@ Full guide: __tooling__/docs/tools/baker/research.md`
 export {
   researchCommand
 };
-//# sourceMappingURL=research-BLDY5UWH.js.map
+//# sourceMappingURL=research-JHDWWFL7.js.map