@koda-sl/baker-cli 0.259.0 → 0.260.0

package/dist/cli.js

@@ -19735,33 +19735,224 @@ var ATTRIBUTION_EVENT_TYPES = ["CLICK_THROUGH", "VIEW_THROUGH", "ENGAGED_VIDEO_V
 var ADVANTAGE_AUDIENCE_OPEN_AGE_MAX = 65;
 var ADVANTAGE_AUDIENCE_MAX_HARD_AGE_MIN = 25;
 var CTA_TYPES2 = [
+  "BOOK_TRAVEL",
+  "CONTACT_US",
+  "DONATE",
+  "DONATE_NOW",
+  "DOWNLOAD",
+  "GET_DIRECTIONS",
+  "GO_LIVE",
+  "INTERESTED",
   "LEARN_MORE",
+  "SEE_DETAILS",
+  "LIKE_PAGE",
+  "MESSAGE_PAGE",
+  "RAISE_MONEY",
+  "SAVE",
+  "SEND_TIP",
   "SHOP_NOW",
   "SIGN_UP",
-  "SUBSCRIBE",
-  "DOWNLOAD",
-  "GET_QUOTE",
-  "CONTACT_US",
-  "BOOK_TRAVEL",
-  "APPLY_NOW",
-  "GET_OFFER",
+  "VIEW_INSTAGRAM_PROFILE",
+  "INSTAGRAM_MESSAGE",
+  "LOYALTY_LEARN_MORE",
+  "PURCHASE_GIFT_CARDS",
+  "PAY_TO_ACCESS",
+  "SEE_MORE",
+  "TRY_IN_CAMERA",
+  "WHATSAPP_LINK",
+  "GET_IN_TOUCH",
+  "TRY_NOW",
+  "ASK_A_QUESTION",
+  "START_A_CHAT",
+  "CHAT_NOW",
+  "ASK_US",
+  "CHAT_WITH_US",
+  "BOOK_NOW",
+  "CHECK_AVAILABILITY",
   "ORDER_NOW",
-  "DONATE_NOW",
-  "REQUEST_TIME",
-  "SEE_MENU",
-  "MESSAGE_PAGE",
   "WHATSAPP_MESSAGE",
-  "CALL_NOW",
-  "GET_DIRECTIONS",
+  "GET_MOBILE_APP",
+  "INSTALL_MOBILE_APP",
+  "USE_MOBILE_APP",
+  "INSTALL_APP",
+  "USE_APP",
   "PLAY_GAME",
-  "LISTEN_NOW",
+  "TRY_DEMO",
+  "WATCH_VIDEO",
   "WATCH_MORE",
   "OPEN_LINK",
+  "NO_BUTTON",
+  "LISTEN_MUSIC",
+  "MOBILE_DOWNLOAD",
+  "GET_OFFER",
+  "GET_OFFER_VIEW",
+  "BUY_NOW",
+  "BUY_TICKETS",
+  "UPDATE_APP",
+  "BET_NOW",
+  "ADD_TO_CART",
+  "SELL_NOW",
+  "GET_SHOWTIMES",
+  "LISTEN_NOW",
+  "GET_EVENT_TICKETS",
+  "REMIND_ME",
+  "SEARCH_MORE",
+  "PRE_REGISTER",
+  "SWIPE_UP_PRODUCT",
+  "SWIPE_UP_SHOP",
+  "PLAY_GAME_ON_FACEBOOK",
+  "VISIT_WORLD",
+  "OPEN_INSTANT_APP",
+  "JOIN_GROUP",
+  "GET_PROMOTIONS",
+  "SEND_UPDATES",
+  "INQUIRE_NOW",
+  "VISIT_PROFILE",
+  "CHAT_ON_WHATSAPP",
+  "EXPLORE_MORE",
+  "CONFIRM",
+  "JOIN_CHANNEL",
+  "MAKE_AN_APPOINTMENT",
+  "ASK_ABOUT_SERVICES",
+  "BOOK_A_CONSULTATION",
+  "GET_A_QUOTE",
+  "BUY_VIA_MESSAGE",
+  "ASK_FOR_MORE_INFO",
+  "VIEW_PRODUCT",
+  "VIEW_CHANNEL",
+  "WATCH_LIVE_VIDEO",
+  "JOIN_LIVE_VIDEO",
+  "IMAGINE",
+  "CALL",
+  "MISSED_CALL",
+  "CALL_NOW",
+  "CALL_ME",
+  "APPLY_NOW",
+  "BUY",
+  "GET_QUOTE",
+  "SUBSCRIBE",
+  "RECORD_NOW",
+  "VOTE_NOW",
+  "GIVE_FREE_RIDES",
+  "REGISTER_NOW",
+  "OPEN_MESSENGER_EXT",
+  "EVENT_RSVP",
+  "CIVIC_ACTION",
+  "SEND_INVITES",
+  "REFER_FRIENDS",
+  "REQUEST_TIME",
+  "SEE_MENU",
+  "SEARCH",
+  "TRY_IT",
+  "TRY_ON",
+  "LINK_CARD",
+  "DIAL_CODE",
+  "FIND_YOUR_GROUPS",
+  "START_ORDER"
+];
+var ASSET_FEED_CTA_TYPES = [
+  "OPEN_LINK",
+  "LIKE_PAGE",
+  "SHOP_NOW",
+  "PLAY_GAME",
+  "INSTALL_APP",
+  "USE_APP",
+  "CALL",
+  "CALL_ME",
+  "VIDEO_CALL",
   "INSTALL_MOBILE_APP",
   "USE_MOBILE_APP",
-  "GET_SHOWTIMES",
+  "MOBILE_DOWNLOAD",
+  "BOOK_TRAVEL",
+  "LISTEN_MUSIC",
+  "WATCH_VIDEO",
+  "LEARN_MORE",
+  "SIGN_UP",
+  "DOWNLOAD",
+  "WATCH_MORE",
+  "NO_BUTTON",
+  "VISIT_PAGES_FEED",
+  "CALL_NOW",
+  "APPLY_NOW",
+  "CONTACT",
+  "BUY_NOW",
+  "GET_OFFER",
+  "GET_OFFER_VIEW",
   "BUY_TICKETS",
-  "NO_BUTTON"
+  "UPDATE_APP",
+  "GET_DIRECTIONS",
+  "BUY",
+  "SEND_UPDATES",
+  "MESSAGE_PAGE",
+  "DONATE",
+  "SUBSCRIBE",
+  "SAY_THANKS",
+  "SELL_NOW",
+  "SHARE",
+  "DONATE_NOW",
+  "GET_QUOTE",
+  "CONTACT_US",
+  "ORDER_NOW",
+  "START_ORDER",
+  "ADD_TO_CART",
+  "VIEW_CART",
+  "VIEW_IN_CART",
+  "VIDEO_ANNOTATION",
+  "RECORD_NOW",
+  "INQUIRE_NOW",
+  "CONFIRM",
+  "REFER_FRIENDS",
+  "REQUEST_TIME",
+  "GET_SHOWTIMES",
+  "LISTEN_NOW",
+  "TRY_DEMO",
+  "WOODHENGE_SUPPORT",
+  "SOTTO_SUBSCRIBE",
+  "FOLLOW_USER",
+  "RAISE_MONEY",
+  "SEE_SHOP",
+  "GET_DETAILS",
+  "FIND_OUT_MORE",
+  "VISIT_WEBSITE",
+  "BROWSE_SHOP",
+  "EVENT_RSVP",
+  "WHATSAPP_MESSAGE",
+  "FOLLOW_NEWS_STORYLINE",
+  "SEE_MORE",
+  "BOOK_NOW",
+  "FIND_A_GROUP",
+  "FIND_YOUR_GROUPS",
+  "PAY_TO_ACCESS",
+  "PURCHASE_GIFT_CARDS",
+  "FOLLOW_PAGE",
+  "SEND_A_GIFT",
+  "SWIPE_UP_SHOP",
+  "SWIPE_UP_PRODUCT",
+  "SEND_GIFT_MONEY",
+  "PLAY_GAME_ON_FACEBOOK",
+  "GET_STARTED",
+  "OPEN_INSTANT_APP",
+  "AUDIO_CALL",
+  "GET_PROMOTIONS",
+  "JOIN_CHANNEL",
+  "MAKE_AN_APPOINTMENT",
+  "ASK_ABOUT_SERVICES",
+  "BOOK_A_CONSULTATION",
+  "GET_A_QUOTE",
+  "BUY_VIA_MESSAGE",
+  "ASK_FOR_MORE_INFO",
+  "CHAT_WITH_US",
+  "VIEW_PRODUCT",
+  "VIEW_CHANNEL",
+  "GET_IN_TOUCH",
+  "ASK_A_QUESTION",
+  "START_A_CHAT",
+  "CHAT_NOW",
+  "ASK_US",
+  "WATCH_LIVE_VIDEO",
+  "JOIN_LIVE_VIDEO",
+  "SHOP_WITH_AI",
+  "TRY_ON_WITH_AI"
 ];
 var LEAD_FORM_CTA_TYPES = [
   "APPLY_NOW",
@@ -20336,9 +20527,28 @@ var dynamicCreativeSchema = z25.object({
   descriptions: z25.array(z25.object({ text: descriptionSchema })).max(DYN.dynamicTextsMax).optional(),
   images: z25.array(dynamicImageSchema).optional(),
   videos: z25.array(dynamicVideoSchema).optional(),
-  ad_formats: z25.array(z25.enum(AD_FORMATS2)).min(1),
-  call_to_action_types: z25.array(z25.enum(CTA_TYPES2)).optional(),
+  /**
+   * Optional: Meta infers the format from the assets when it is omitted, and
+   * every flexible creative read back off a live account omits it.
+   */
+  ad_formats: z25.array(z25.enum(AD_FORMATS2)).min(1).optional(),
+  call_to_action_types: z25.array(z25.string()).optional(),
+  /**
+   * The button on the creative's own `link_data` — a flexible ad carries both
+   * envelopes, and this is the one that takes `SEE_DETAILS`. Kept separate
+   * from `call_to_action_types` because Meta validates the two against
+   * different enums.
+   */
+  call_to_action: callToActionSchema.optional(),
   link_urls: z25.array(z25.object({ website_url: httpsUrlSchema3, display_url: z25.string().optional() })).min(1),
+  /**
+   * `asset_feed_spec.optimization_type` — passed through as a free string on
+   * purpose. Meta's own 400 enumerates ten values and then accepts
+   * `DEGREES_OF_FREEDOM`, which is not among them and is what every
+   * Advantage+ flexible creative on a live account reports. An enum here
+   * would refuse the value Meta itself hands back.
+   */
+  optimization_type: z25.string().optional(),
   /** Multi-language / placement customization — structural passthrough for v1. */
   asset_customization_rules: z25.array(z25.record(z25.string(), z25.unknown())).optional()
 }).superRefine((p, ctx) => {
@@ -20349,6 +20559,17 @@ var dynamicCreativeSchema = z25.object({
       message: "a dynamic creative needs at least one image or video"
     });
   }
+  p.call_to_action_types?.forEach((type, index) => {
+    if (ASSET_FEED_CTA_TYPES.some((allowed) => allowed === type)) {
+      return;
+    }
+    const isLinkButton = CTA_TYPES2.some((allowed) => allowed === type);
+    ctx.addIssue({
+      code: "custom",
+      path: ["call_to_action_types", index],
+      message: isLinkButton ? `${type} is not one of the buttons Meta accepts in asset_feed_spec.call_to_action_types \u2014 it is a link_data button. Pass it as call_to_action: { type: "${type}" } instead.` : `${type} is not a Meta call-to-action button.`
+    });
+  });
 });
 var existingPostCreativeSchema = z25.object({
   creativeType: z25.literal("existing_post"),
@@ -20359,11 +20580,33 @@ var existingPostCreativeSchema = z25.object({
   url_tags: creativeSharedFields.url_tags,
   enhancements: creativeSharedFields.enhancements
 });
+var specCreativeSchema = z25.object({
+  creativeType: z25.literal("spec"),
+  name: creativeSharedFields.name,
+  url_tags: creativeSharedFields.url_tags,
+  /** Promote the existing post — keeps the ad's likes, comments and shares. */
+  object_story_id: z25.string().regex(/^\d+_\d+$/, 'expected "<page_id>_<post_id>"').optional(),
+  object_story_spec: z25.record(z25.string(), z25.unknown()).optional(),
+  asset_feed_spec: z25.record(z25.string(), z25.unknown()).optional(),
+  degrees_of_freedom_spec: z25.record(z25.string(), z25.unknown()).optional(),
+  instagram_user_id: creativeSharedFields.instagram_user_id,
+  /** The creative this spec was cloned from, for the review diff. */
+  clonedFrom: z25.string().regex(NUMERIC_ID_REGEX3).optional()
+}).superRefine((p, ctx) => {
+  if (!(p.object_story_id || p.object_story_spec || p.asset_feed_spec)) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["object_story_spec"],
+      message: "a spec creative needs object_story_id, object_story_spec or asset_feed_spec"
+    });
+  }
+});
 var creativeContentSchema2 = z25.discriminatedUnion("creativeType", [
   singleCreativeSchema,
   carouselCreativeSchema2,
   dynamicCreativeSchema,
-  existingPostCreativeSchema
+  existingPostCreativeSchema,
+  specCreativeSchema
 ]);
 var adCreativeCreateSchema = creativeContentSchema2;
 var adCreativeUpdateSchema = z25.object({
@@ -20507,6 +20750,16 @@ var metaDraftDuplicateRequestSchema = z26.object({
   /** Pause the original after the copy publishes. */
   replace: z26.boolean().optional()
 });
+var metaDraftRetagRequestSchema = z26.object({
+  chatId: z26.string(),
+  accountId: z26.string(),
+  adId: z26.string(),
+  urlTags: z26.string().max(1e3).optional(),
+  set: z26.record(z26.string(), z26.string()).optional()
+}).refine(
+  (p) => p.urlTags === void 0 !== (p.set === void 0),
+  "pass either the whole tracking string or the key=value pairs to change, not both"
+);
 var metaDraftOpViewSchema = z26.object({
   ref: z26.string(),
   kind: metaDraftOpKindSchema,
@@ -21075,6 +21328,64 @@ Example: baker ads meta ads update 6123 --creative meta_temp_cr02`
     });
   }
 });
+var adsRetagCommand = defineCommand56({
+  meta: {
+    name: "retag",
+    description: `Stage new URL tracking parameters on a LIVE ad \u2014 the fix for a wrong utm_medium, a missing ad id, or any tag already running. ${STAGED_NOTE2}
+Start here when a report attributes paid traffic to the wrong channel: --set rewrites only the keys you name and leaves the rest of the string alone.
+Baker clones the ad's own creative behind the scenes, so every button, text variant and enhancement is carried across exactly as Meta holds them \u2014 nothing is retyped.
+Example: baker ads meta ads retag 120252158038400247 --set "utm_medium=paid-social&utm_placement={{placement}}"
+Example: baker ads meta ads retag 120252158038400247 --url-tags "utm_source={{site_source_name}}&utm_medium=paid-social&ad_id={{ad.id}}"`
+  },
+  args: {
+    id: { type: "positional", description: "Ad id (a live ad \u2014 not a meta_temp_* ref)", required: true },
+    ...accountArgs2,
+    "url-tags": { type: "string", description: "Replace the WHOLE tracking string" },
+    set: {
+      type: "string",
+      description: 'Rewrite only these keys, keeping the rest: "utm_medium=paid-social&ad_id={{ad.id}}"'
+    }
+  },
+  run: async ({ args }) => {
+    const { apiPost: apiPost2 } = await import("./client-VDCCDEHE.js");
+    const { requireChatId: requireChatId2 } = await import("./env-FWMZXMQK.js");
+    const { writeJsonEnvelope: writeJsonEnvelope2 } = await import("./output-JBYI5IVX.js");
+    const { handleMetaError: handleMetaError2 } = await import("./shared-GWFXJXKJ.js");
+    try {
+      const accountId = bareAccountId2(args);
+      const urlTags = typeof args["url-tags"] === "string" ? args["url-tags"] : void 0;
+      const setRaw = typeof args.set === "string" ? args.set : void 0;
+      if (urlTags === void 0 === (setRaw === void 0)) {
+        failWriteValidation3("pass either --url-tags (the whole string) or --set (the keys to change), not both");
+      }
+      const response = await apiPost2("/api/ads/meta/draft/retag", {
+        chatId: requireChatId2(),
+        accountId,
+        adId: requireTarget3(args, "ad"),
+        urlTags,
+        set: setRaw === void 0 ? void 0 : parseSetPairs(setRaw)
+      });
+      writeJsonEnvelope2(response);
+    } catch (err) {
+      handleMetaError2(err);
+    }
+  }
+});
+function parseSetPairs(raw) {
+  const pairs = {};
+  for (const part of raw.replace(/^[?&]+/, "").split("&")) {
+    if (part.length === 0) continue;
+    const eq = part.indexOf("=");
+    if (eq <= 0) {
+      failWriteValidation3(`--set expects key=value pairs joined by & \u2014 could not read "${part}"`);
+    }
+    pairs[part.slice(0, eq)] = part.slice(eq + 1);
+  }
+  if (Object.keys(pairs).length === 0) {
+    failWriteValidation3("--set needs at least one key=value pair");
+  }
+  return pairs;
+}
 var audiencesCreateCommand2 = defineCommand56({
   meta: {
     name: "create",
@@ -21257,7 +21568,7 @@ var listCommand4 = defineCommand57({
 var adsListCommand = defineCommand57({
   meta: {
     name: "ads",
-    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/duplicate).
+    description: `List ads in a Meta ad account, or stage writes (create/update/pause/resume/archive/duplicate/retag).
 Defaults to ACTIVE only \u2014 pass --all-statuses to widen. Write subcommands stage ops on this chat's draft.
 
 The dashboard shows effective_status (e.g. WITH_ISSUES, PENDING_REVIEW, DISAPPROVED, ADSET_PAUSED), not status.
@@ -21266,7 +21577,8 @@ Examples:
   baker ads meta ads --account-id act_123
   baker ads meta ads --adset-id 6123
   baker ads meta ads create --name "Ad 1" --adset meta_temp_as01 --creative meta_temp_cr01
-  baker ads meta ads pause 6123 --account-id act_123`
+  baker ads meta ads pause 6123 --account-id act_123
+  baker ads meta ads retag 6123 --set "utm_medium=paid-social"      \u2014 fix tracking on a LIVE ad, keeping everything else`
   },
   subCommands: {
     list: listCommand4,
@@ -21275,7 +21587,8 @@ Examples:
     pause: adsPauseCommand,
     resume: adsResumeCommand,
     archive: adsArchiveCommand,
-    duplicate: adsDuplicateCommand
+    duplicate: adsDuplicateCommand,
+    retag: adsRetagCommand
   },
   // `args` stays even though the parent has no `run`: citty scans rawArgs for the
   // subcommand name using THIS command's arg defs, so without them `--account-id act_1`