@koda-sl/baker-cli 0.489.0 → 0.490.0

package/dist/chunk-HLVRHBKL.js

@@ -0,0 +1,1078 @@
+// ../api/src/ads-meta/adStudies.ts
+import { z } from "zod";
+
+// ../api/src/ads-meta/limits.ts
+var META_LIMITS = {
+  /** Meta caps the labels on one object at 50 (`adlabels`, "max 50"); it documents no name length, so 255. */
+  adLabel: {
+    nameMax: 255,
+    perObjectMax: 50
+  },
+  campaign: {
+    nameMax: 400
+  },
+  adSet: {
+    nameMax: 400,
+    /**
+     * Meta's own bounds for a minimum ROAS, as a multiple of spend (2 = 200%):
+     * "roas_average_floor … should be larger than or equal to 0.001 and smaller
+     * than or equal to 1000" (subcode 1815888, live on v25.0, 2026-10-14).
+     */
+    minRoasMin: 1e-3,
+    minRoasMax: 1e3,
+    /** Frequency caps: `interval_days` and `max_frequency` are each 1–90 (Meta's #100 refusal, live v25.0). */
+    frequencyIntervalDaysMax: 90,
+    frequencyMaxImpressionsMax: 90,
+    /** "You can set up a maximum of 50 high demand periods per campaign or ad set" (High Demand Period reference). */
+    budgetSchedulesMax: 50
+  },
+  ad: {
+    nameMax: 400
+  },
+  creative: {
+    nameMax: 400,
+    /** Feed truncates the primary text past this with "… See more". */
+    messageSoftMax: 125,
+    messageHardMax: 5e3,
+    /** Below this, primary text reads as too thin to carry a hook + value + reason to act. */
+    messageGoodMin: 40,
+    headlineMax: 255,
+    descriptionMax: 300,
+    carouselCardsMin: 2,
+    carouselCardsMax: 10,
+    /** Carousels tell a fuller story and give Meta more to optimize at this many cards. */
+    carouselCardsGoodMin: 3,
+    dynamicTextsMin: 1,
+    dynamicTextsMax: 5,
+    /** Dynamic ads mix and match best with at least this many media assets. */
+    dynamicAssetsGoodMin: 3,
+    /**
+     * `asset_feed_spec` limits (Meta's Asset Feed Spec Options, "restrictions"):
+     * body text 1024 characters, titles and descriptions 255, at most 10
+     * images and 10 videos, 30 assets in all (the ad format counts as one).
+     */
+    assetFeedBodyMax: 1024,
+    assetFeedTitleMax: 255,
+    assetFeedImagesMax: 10,
+    assetFeedVideosMax: 10,
+    assetFeedAssetsMax: 30
+  },
+  audience: {
+    nameMax: 100,
+    /** Website/engagement audiences below this rarely serve. */
+    minLookalikeSourceRows: 100,
+    retentionDaysMax: 180
+  },
+  customConversion: {
+    nameMax: 100,
+    descriptionMax: 500,
+    /**
+     * Meta's hard cap per ad account. It matters because deleting a custom
+     * conversion archives it rather than removing it, so a chat that creates
+     * one per campaign spends slots that only a person, in Events Manager, can
+     * think about reclaiming.
+     */
+    perAccountMax: 100
+  }
+};
+var OBJECTIVES = [
+  "OUTCOME_TRAFFIC",
+  "OUTCOME_ENGAGEMENT",
+  "OUTCOME_LEADS",
+  "OUTCOME_SALES",
+  "OUTCOME_AWARENESS",
+  "OUTCOME_APP_PROMOTION"
+];
+var SPECIAL_AD_CATEGORIES = [
+  "NONE",
+  "HOUSING",
+  "EMPLOYMENT",
+  /** Deprecated by Meta on 2025-01-14 — replaced by FINANCIAL_PRODUCTS_SERVICES. Still accepted as input and mapped on the wire. */
+  "CREDIT",
+  "ISSUES_ELECTIONS_POLITICS",
+  "FINANCIAL_PRODUCTS_SERVICES",
+  "ONLINE_GAMBLING_AND_GAMING"
+];
+var SPECIAL_CATEGORIES_REQUIRING_COUNTRY = ["ISSUES_ELECTIONS_POLITICS"];
+var BUYING_TYPES = ["AUCTION", "RESERVED"];
+var BID_STRATEGIES = [
+  "LOWEST_COST_WITHOUT_CAP",
+  "LOWEST_COST_WITH_BID_CAP",
+  "COST_CAP",
+  "LOWEST_COST_WITH_MIN_ROAS"
+];
+var BID_STRATEGIES_REQUIRING_AMOUNT = ["LOWEST_COST_WITH_BID_CAP", "COST_CAP"];
+var ROAS_FLOOR_SCALE = 1e4;
+var BID_STRATEGIES_FORBIDDING_AMOUNT = [
+  "LOWEST_COST_WITHOUT_CAP",
+  "LOWEST_COST_WITH_MIN_ROAS"
+];
+var BILLING_EVENTS = [
+  "APP_INSTALLS",
+  "CLICKS",
+  "IMPRESSIONS",
+  "LINK_CLICKS",
+  "NONE",
+  "OFFER_CLAIMS",
+  "PAGE_LIKES",
+  "POST_ENGAGEMENT",
+  "THRUPLAY",
+  "PURCHASE",
+  "LISTING_INTERACTION"
+];
+var OPTIMIZATION_GOALS = [
+  "NONE",
+  "APP_INSTALLS",
+  "AD_RECALL_LIFT",
+  "ENGAGED_USERS",
+  "EVENT_RESPONSES",
+  "IMPRESSIONS",
+  "LEAD_GENERATION",
+  "QUALITY_LEAD",
+  "QUALITY_CALL",
+  "LINK_CLICKS",
+  "OFFSITE_CONVERSIONS",
+  "LANDING_PAGE_VIEWS",
+  "PAGE_LIKES",
+  "POST_ENGAGEMENT",
+  "REACH",
+  "THRUPLAY",
+  "VALUE",
+  "CONVERSATIONS",
+  "DERIVED_EVENTS",
+  // Added 2026-09-18 from Meta's own generated enum spec
+  // (facebook-business-sdk-codegen › AdSet_optimization_goal). Every one of these
+  // is a goal Meta accepts and Baker used to refuse at stage time — the messaging
+  // and Instagram-profile goals are the ones that cost real campaigns, because a
+  // click-to-WhatsApp ad set cannot be expressed without them.
+  "ADVERTISER_SILOED_VALUE",
+  "APP_INSTALLS_AND_OFFSITE_CONVERSIONS",
+  "AUTOMATIC_OBJECTIVE",
+  "ENGAGED_PAGE_VIEWS",
+  "IN_APP_VALUE",
+  "MEANINGFUL_CALL_ATTEMPT",
+  "MESSAGING_APPOINTMENT_CONVERSION",
+  "MESSAGING_DEEP_CONVERSATION_AND_FOLLOW",
+  "MESSAGING_PURCHASE_CONVERSION",
+  "PROFILE_AND_PAGE_ENGAGEMENT",
+  "PROFILE_VISIT",
+  "REMINDERS_SET",
+  "SUBSCRIBERS",
+  "VISIT_INSTAGRAM_PROFILE"
+];
+var OPTIMIZATION_GOALS_REQUIRING_PAGE = [
+  "LEAD_GENERATION",
+  "QUALITY_LEAD",
+  "PAGE_LIKES"
+];
+var OPTIMIZATION_GOALS_REQUIRING_PIXEL = ["OFFSITE_CONVERSIONS"];
+var OPTIMIZATION_GOALS_REQUIRING_CONVERSION_SOURCE = ["VALUE"];
+var OPTIMIZATION_GOALS_REQUIRING_APP = ["APP_INSTALLS"];
+var DESTINATION_TYPES = [
+  "WEBSITE",
+  "APP",
+  "MESSENGER",
+  "INSTAGRAM_DIRECT",
+  "ON_AD",
+  "ON_PAGE",
+  "ON_POST",
+  "ON_VIDEO",
+  "WHATSAPP",
+  "PHONE_CALL",
+  "INSTAGRAM_PROFILE",
+  "SHOP_AUTOMATIC",
+  // Added 2026-09-18 from adcampaign_destination_type. The four MESSAGING_* values
+  // are the click-to-message destinations (Messenger / Instagram Direct / WhatsApp
+  // in every combination Meta ships); without them Baker could not stage a
+  // click-to-WhatsApp ad set at all.
+  "APPLINKS_AUTOMATIC",
+  "FACEBOOK",
+  "FACEBOOK_LIVE",
+  "FACEBOOK_PAGE",
+  "IMAGINE",
+  "INSTAGRAM_LIVE",
+  "INSTAGRAM_PROFILE_AND_FACEBOOK_PAGE",
+  "MESSAGING_INSTAGRAM_DIRECT_MESSENGER",
+  "MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP",
+  "MESSAGING_INSTAGRAM_DIRECT_WHATSAPP",
+  "MESSAGING_MESSENGER_WHATSAPP",
+  "ON_EVENT"
+];
+var CUSTOM_EVENT_TYPES = [
+  "PURCHASE",
+  "LEAD",
+  "COMPLETE_REGISTRATION",
+  "ADD_TO_CART",
+  "ADD_PAYMENT_INFO",
+  "INITIATED_CHECKOUT",
+  "CONTENT_VIEW",
+  "SEARCH",
+  "SUBSCRIBE",
+  "START_TRIAL",
+  "CONTACT",
+  "OTHER",
+  // Added 2026-09-18 from AdPromotedObject_custom_event_type. SCHEDULE,
+  // SUBMIT_APPLICATION, SERVICE_BOOKING_REQUEST and
+  // MESSAGING_CONVERSATION_STARTED_7D are the conversions service businesses and
+  // click-to-message campaigns actually optimize toward.
+  "ACHIEVEMENT_UNLOCKED",
+  "ADD_TO_WISHLIST",
+  "AD_IMPRESSION",
+  "CUSTOMIZE_PRODUCT",
+  "D2_RETENTION",
+  "D7_RETENTION",
+  "DONATE",
+  "FIND_LOCATION",
+  "LEVEL_ACHIEVED",
+  "LISTING_INTERACTION",
+  "MESSAGING_CONVERSATION_STARTED_7D",
+  "RATE",
+  "SCHEDULE",
+  "SERVICE_BOOKING_REQUEST",
+  "SPENT_CREDITS",
+  "SUBMIT_APPLICATION",
+  "TUTORIAL_COMPLETION"
+];
+var OPTIMIZATION_GOALS_WITH_FREQUENCY_CAP = ["REACH", "THRUPLAY"];
+var FREQUENCY_CAP_EVENTS = [
+  "IMPRESSIONS",
+  "VIDEO_VIEWS",
+  "VIDEO_VIEWS_2S",
+  "VIDEO_VIEWS_15S",
+  "VIDEO_VIEWS_6S"
+];
+var FREQUENCY_CAP_TYPES = ["CAP", "TARGET"];
+var PACING_TYPES = ["standard", "no_pacing", "day_parting"];
+var SCHEDULE_TIMEZONE_TYPES = ["USER", "ADVERTISER"];
+var ATTRIBUTION_EVENT_TYPES = ["CLICK_THROUGH", "VIEW_THROUGH", "ENGAGED_VIDEO_VIEW"];
+var ATTRIBUTION_MAX_WINDOW_DAYS = {
+  CLICK_THROUGH: 7,
+  VIEW_THROUGH: 1,
+  ENGAGED_VIDEO_VIEW: 1
+};
+var ADVANTAGE_AUDIENCE_OPEN_AGE_MAX = 65;
+var ADVANTAGE_AUDIENCE_MAX_HARD_AGE_MIN = 25;
+var EU_DSA_COUNTRIES = /* @__PURE__ */ new Set([
+  "AT",
+  "BE",
+  "BG",
+  "HR",
+  "CY",
+  "CZ",
+  "DK",
+  "EE",
+  "FI",
+  "FR",
+  "DE",
+  "GR",
+  "HU",
+  "IE",
+  "IT",
+  "LV",
+  "LT",
+  "LU",
+  "MT",
+  "NL",
+  "PL",
+  "PT",
+  "RO",
+  "SK",
+  "SI",
+  "ES",
+  "SE"
+]);
+var CTA_TYPES = [
+  "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",
+  "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",
+  "WHATSAPP_MESSAGE",
+  "GET_MOBILE_APP",
+  "INSTALL_MOBILE_APP",
+  "USE_MOBILE_APP",
+  "INSTALL_APP",
+  "USE_APP",
+  "PLAY_GAME",
+  "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",
+  // Added 2026-09-18 from Meta's generated enum spec
+  // (AdCreative_call_to_action_type). Additive on purpose: 37 of the values above
+  // are absent from that spec and present in the live 400, which is the
+  // disagreement the note above is about — so the spec widens this list and never
+  // prunes it.
+  "AUDIO_CALL",
+  "BROWSE_SHOP",
+  "CONTACT",
+  "FIND_A_GROUP",
+  "FIND_OUT_MORE",
+  "FOLLOW_NEWS_STORYLINE",
+  "FOLLOW_PAGE",
+  "FOLLOW_USER",
+  "GET_DETAILS",
+  "GET_STARTED",
+  "SAY_THANKS",
+  "SEE_SHOP",
+  "SEND_A_GIFT",
+  "SEND_GIFT_MONEY",
+  "SHARE",
+  "SHOP_WITH_AI",
+  "SOTTO_SUBSCRIBE",
+  "TRY_ON_WITH_AI",
+  "VIDEO_ANNOTATION",
+  "VIDEO_CALL",
+  "VIEW_CART",
+  "VIEW_IN_CART",
+  "VISIT_PAGES_FEED",
+  "VISIT_WEBSITE",
+  "WOODHENGE_SUPPORT"
+];
+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",
+  "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",
+  "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",
+  "DOWNLOAD",
+  "GET_QUOTE",
+  "LEARN_MORE",
+  "SIGN_UP",
+  "SUBSCRIBE"
+];
+var AD_FORMATS = ["SINGLE_IMAGE", "CAROUSEL", "SINGLE_VIDEO", "AUTOMATIC_FORMAT"];
+var ENROLL_STATUSES = ["OPT_IN", "OPT_OUT"];
+var VISUAL_ENHANCEMENT_FEATURES = {
+  adapt_to_placement: "Adapt the picture to each placement",
+  add_text_overlay: "Add text on top of the media",
+  audio: "Add audio",
+  carousel_to_video: "Turn the carousel into a video",
+  creative_stickers: "Add stickers",
+  cv_transformation: "Visual transformations",
+  image_animation: "Animate the picture",
+  image_auto_crop: "Crop the picture automatically",
+  image_background_gen: "Generate a new background",
+  image_banner: "Add a banner",
+  image_brightness_and_contrast: "Adjust brightness and contrast",
+  image_end_card: "Add an end card",
+  image_enhancement: "Enhance the picture",
+  image_templates: "Put the picture in a template frame",
+  image_text_translation: "Translate text in the picture",
+  image_touchups: "Touch up the picture",
+  image_uncrop: "Expand the picture with AI",
+  media_liquidity_animated_image: "Animate the picture",
+  media_type_automation: "Turn the picture into a video",
+  multi_photo_to_video: "Turn several pictures into a video",
+  music_generation: "Generate music",
+  pac_genai_recomposition: "Recompose the media with AI per placement",
+  pac_recomposition: "Recompose the media per placement",
+  replace_media_text: "Replace text in the media",
+  reveal_details_over_time: "Reveal details over time",
+  text_overlay_translation: "Translate text overlays",
+  translate_voiceover: "Translate the voiceover",
+  video_auto_crop: "Crop the video automatically",
+  video_filtering: "Filter the video",
+  video_highlight: "Cut a highlight from the video",
+  video_highlights: "Cut highlights from the video",
+  video_to_image: "Turn the video into a picture",
+  video_uncrop: "Expand the video with AI",
+  video_uncrop_9x16_to_9x18: "Expand a vertical video",
+  ig_video_native_subtitle: "Add subtitles to the video"
+};
+var STAGEABLE_CREATE_STATUSES = ["ACTIVE", "PAUSED"];
+var UPDATE_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED", "DELETED"];
+var CREATIVE_UPDATE_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED", "DELETED"];
+var CUSTOM_AUDIENCE_SUBTYPES = ["CUSTOM", "WEBSITE", "ENGAGEMENT", "LOOKALIKE"];
+var CUSTOMER_FILE_SOURCES = [
+  "USER_PROVIDED_ONLY",
+  "PARTNER_PROVIDED_ONLY",
+  "BOTH_USER_AND_PARTNER_PROVIDED"
+];
+var MEDIA_KINDS = ["image", "video"];
+var CURRENCY_MINIMUMS = {
+  USD: { dailyBudgetMin: 1 },
+  EUR: { dailyBudgetMin: 1 },
+  GBP: { dailyBudgetMin: 1 }
+};
+var DEFAULT_CURRENCY_MINIMUM = { dailyBudgetMin: 1 };
+var TEMP_REF_REGEX = /^meta_temp_[A-Za-z0-9_-]{4,}$/;
+var NUMERIC_ID_REGEX = /^\d+$/;
+var IMAGE_HASH_REGEX = /^[A-Fa-f0-9]{16,}$/;
+
+// ../api/src/ads-meta/adStudies.ts
+var DAY_SECONDS = 86400;
+var entityRefSchema = z.string().refine((value) => NUMERIC_ID_REGEX.test(value) || TEMP_REF_REGEX.test(value), {
+  message: "expected a numeric Meta id or a meta_temp_* reference from this chat"
+});
+var adStudyCellSchema = z.strictObject({
+  name: z.string().min(1).max(100),
+  /** Share of the audience that sees this version, in percent. */
+  treatment_percentage: z.number().positive().max(100),
+  /** A lift study: the share of the audience held out from the ads, so what they do is the baseline. */
+  control_percentage: z.number().positive().max(100).optional(),
+  adsets: z.array(entityRefSchema).min(1).max(100).optional(),
+  campaigns: z.array(entityRefSchema).min(1).max(100).optional(),
+  /** A creative test: the one ad this version runs. */
+  ads: z.array(entityRefSchema).min(1).max(100).optional()
+});
+var AD_STUDY_CONFIDENCE_LEVELS = [0.8, 0.9, 0.95];
+var confidenceLevelSchema = z.number().refine((value) => AD_STUDY_CONFIDENCE_LEVELS.includes(value), {
+  message: "confidence_level must be 0.8, 0.9 or 0.95 (80%, 90% or 95%)"
+});
+var eventSourceSchema = z.strictObject({
+  id: z.string().regex(NUMERIC_ID_REGEX),
+  /** Pixel or app events counted, e.g. Lead, Purchase. Meta stores pixel events by their standard name. */
+  event_names: z.array(z.string().min(1)).min(1).optional()
+});
+var AD_STUDY_OBJECTIVE_TYPES = [
+  "CONVERSIONS",
+  "SALES",
+  "NONSALES",
+  "BRAND",
+  "BRANDLIFT",
+  "MAE",
+  "MAI"
+];
+var adStudyObjectiveSchema = z.strictObject({
+  name: z.string().min(1).max(100),
+  /** A split test is decided on CONVERSIONS; a lift study may measure sales, brand, app events (Meta's types). */
+  type: z.enum(AD_STUDY_OBJECTIVE_TYPES).default("CONVERSIONS"),
+  is_primary: z.boolean().optional(),
+  adspixels: z.array(eventSourceSchema).min(1).optional(),
+  customconversions: z.array(eventSourceSchema).min(1).optional(),
+  applications: z.array(eventSourceSchema).min(1).optional(),
+  offsite_datasets: z.array(eventSourceSchema).min(1).optional()
+});
+var OBJECTIVE_SOURCES = ["adspixels", "customconversions", "applications", "offsite_datasets"];
+var AD_STUDY_MIN_CELLS = 2;
+var AD_STUDY_MAX_CELLS = 150;
+function cellObjects(cell) {
+  return [...cell.adsets ?? [], ...cell.campaigns ?? [], ...cell.ads ?? []];
+}
+function adStudyLevel(cells) {
+  const levels = new Set(
+    cells.flatMap(
+      (cell) => [cell.adsets ? "adsets" : [], cell.campaigns ? "campaigns" : [], cell.ads ? "ads" : []].flat()
+    )
+  );
+  return levels.size === 1 ? [...levels][0] : void 0;
+}
+function levelIssues(cells) {
+  const issues = [];
+  cells.forEach((cell, index) => {
+    if (cellObjects(cell).length === 0) {
+      issues.push({
+        path: ["cells", index],
+        message: `version "${cell.name}" runs nothing \u2014 give it the ad sets (adsets) or campaigns (campaigns) it shows`
+      });
+    }
+  });
+  if (cells.some((cell) => cell.ads)) {
+    issues.push({
+      path: ["cells"],
+      message: 'an A/B test compares ad sets or campaigns \u2014 to compare single ads of one ad set, stage a creative test (type "SPLIT_TEST_V2", `--type creative`)'
+    });
+  }
+  const named = cells.filter((cell) => cellObjects(cell).length > 0);
+  if (named.length > 0 && adStudyLevel(named) === void 0) {
+    issues.push({
+      path: ["cells"],
+      message: "the versions must be all ad sets or all campaigns \u2014 comparing an ad set with a campaign compares two different things"
+    });
+  }
+  return issues;
+}
+function duplicateObjectIssues(cells) {
+  const seen = /* @__PURE__ */ new Map();
+  const issues = [];
+  cells.forEach((cell, index) => {
+    for (const id of cellObjects(cell)) {
+      const first = seen.get(id);
+      if (first !== void 0 && first !== index) {
+        issues.push({
+          path: ["cells", index],
+          message: `${id} is in more than one version \u2014 each version must run its own ad sets or campaigns, or it is compared with itself`
+        });
+      }
+      seen.set(id, first ?? index);
+    }
+  });
+  return issues;
+}
+function shareIssues(cells) {
+  const total = Math.round(cells.reduce((sum, cell) => sum + cell.treatment_percentage, 0) * 100) / 100;
+  if (total === 100) {
+    return [];
+  }
+  return [
+    {
+      path: ["cells"],
+      message: `the versions' shares must add up to 100% (now ${total}%) \u2014 every person in the test sees exactly one version`
+    }
+  ];
+}
+function cellIssues(cells) {
+  if (cells.length < AD_STUDY_MIN_CELLS) {
+    return [
+      {
+        path: ["cells"],
+        message: `an A/B test needs at least 2 versions (cells) \u2014 with ${cells.length} there is nothing to compare`
+      }
+    ];
+  }
+  const issues = [...shareIssues(cells)];
+  issues.push(...levelIssues(cells), ...duplicateObjectIssues(cells));
+  return issues;
+}
+var AD_STUDY_MIN_DAYS = 1;
+var AD_STUDY_MAX_DAYS = 30;
+function adStudyDays(startTime, endTime) {
+  return Math.round((endTime - startTime) / DAY_SECONDS * 10) / 10;
+}
+function scheduleIssues(startTime, endTime) {
+  if (endTime <= startTime) {
+    return [{ path: ["end_time"], message: "the test ends before it starts \u2014 end_time must be after start_time" }];
+  }
+  const days = adStudyDays(startTime, endTime);
+  if (endTime - startTime < AD_STUDY_MIN_DAYS * DAY_SECONDS) {
+    return [{ path: ["end_time"], message: `an A/B test runs for at least 1 day (this one: ${days} days)` }];
+  }
+  if (endTime - startTime > AD_STUDY_MAX_DAYS * DAY_SECONDS) {
+    return [
+      {
+        path: ["end_time"],
+        message: `an A/B test runs for at most 30 days, as in Ads Manager (this one: ${days} days) \u2014 split a longer question into two tests`
+      }
+    ];
+  }
+  return [];
+}
+function objectiveIssues(objectives) {
+  if (!objectives || objectives.length === 0) {
+    return [];
+  }
+  const issues = [];
+  objectives.forEach((objective, index) => {
+    if (!OBJECTIVE_SOURCES.some((source) => objective[source] !== void 0)) {
+      issues.push({
+        path: ["objectives", index],
+        message: `measure "${objective.name}" counts nothing \u2014 give it a pixel event (adspixels), a custom conversion (customconversions) or an app event (applications)`
+      });
+    }
+  });
+  const primaries = objectives.filter((objective) => objective.is_primary === true).length;
+  const implicitPrimary = objectives.length === 1 && objectives[0]?.is_primary === void 0;
+  if (primaries !== 1 && !implicitPrimary) {
+    issues.push({
+      path: ["objectives"],
+      message: `a test is decided on exactly one primary measure (is_primary: true) \u2014 ${primaries} are marked`
+    });
+  }
+  return issues;
+}
+var LIFT_MAX_DAYS = 90;
+function observationEndIssues(study) {
+  if (study.observation_end_time === void 0 || study.observation_end_time >= study.end_time) return [];
+  return [
+    {
+      path: ["observation_end_time"],
+      message: "observation_end_time must run at least until the study ends (end_time) \u2014 Meta reads results until then"
+    }
+  ];
+}
+function liftIssues(study) {
+  const issues = [];
+  if (study.cells.length === 0) issues.push({ path: ["cells"], message: "a lift study needs at least one cell" });
+  study.cells.forEach((cell, index) => {
+    const total = cell.treatment_percentage + (cell.control_percentage ?? 0);
+    if (cell.control_percentage === void 0) {
+      issues.push({
+        path: ["cells", index, "control_percentage"],
+        message: `cell "${cell.name}" holds nobody out \u2014 give it a control_percentage (the people who do not see the ads)`
+      });
+    } else if (total > 100) {
+      issues.push({
+        path: ["cells", index],
+        message: `cell "${cell.name}" splits ${total}% of its audience \u2014 at most 100%`
+      });
+    }
+    if (cell.ads)
+      issues.push({
+        path: ["cells", index, "ads"],
+        message: "a lift study measures campaigns or ad sets, not single ads"
+      });
+    else if (!cell.campaigns && !cell.adsets)
+      issues.push({
+        path: ["cells", index],
+        message: `cell "${cell.name}" runs nothing \u2014 give it the campaigns (campaigns) or ad sets (adsets) whose lift it measures`
+      });
+  });
+  issues.push(...observationEndIssues(study));
+  if (!study.objectives || study.objectives.length === 0) {
+    issues.push({
+      path: ["objectives"],
+      message: "a lift study needs a measure \u2014 the pixel event or conversion whose lift it reads"
+    });
+  }
+  if (study.end_time <= study.start_time) {
+    issues.push({ path: ["end_time"], message: "the study ends before it starts" });
+  } else if (study.end_time - study.start_time > LIFT_MAX_DAYS * DAY_SECONDS) {
+    issues.push({ path: ["end_time"], message: "a lift study runs for at most 90 days" });
+  }
+  return [...issues, ...duplicateObjectIssues(study.cells), ...objectiveIssues(study.objectives)].filter(
+    (issue, index, all) => all.findIndex((other) => other.message === issue.message) === index
+  );
+}
+var CREATIVE_TEST_MIN_CELLS = 2;
+var CREATIVE_TEST_MAX_CELLS = 5;
+function creativeTestIssues(study) {
+  const issues = [];
+  if (study.cells.length < CREATIVE_TEST_MIN_CELLS || study.cells.length > CREATIVE_TEST_MAX_CELLS) {
+    issues.push({ path: ["cells"], message: `a creative test compares 2 to 5 ads (now ${study.cells.length})` });
+  }
+  study.cells.forEach((cell, index) => {
+    if (cell.ads?.length !== 1 || cell.adsets || cell.campaigns) {
+      issues.push({ path: ["cells", index], message: `version "${cell.name}" runs exactly one ad (ads: [<ad id>])` });
+    }
+  });
+  if (!study.testDailyBudget) {
+    issues.push({
+      path: ["testDailyBudget"],
+      message: "a creative test needs testDailyBudget \u2014 the part of the ad set's daily budget the test spends"
+    });
+  }
+  return [
+    ...issues,
+    ...shareIssues(study.cells),
+    ...duplicateObjectIssues(study.cells),
+    ...scheduleIssues(study.start_time, study.end_time),
+    ...observationEndIssues(study)
+  ];
+}
+function adStudyIssues(study) {
+  if (study.type === "LIFT") return liftIssues(study);
+  if (study.type === "SPLIT_TEST_V2") return creativeTestIssues(study);
+  return [
+    ...cellIssues(study.cells),
+    ...scheduleIssues(study.start_time, study.end_time),
+    ...objectiveIssues(study.objectives)
+  ];
+}
+function addIssues(issues, ctx) {
+  for (const issue of issues) {
+    ctx.addIssue({ code: "custom", path: issue.path, message: issue.message });
+  }
+}
+var AD_STUDY_TYPES = ["SPLIT_TEST", "LIFT", "SPLIT_TEST_V2"];
+var adStudyCreateBaseSchema = z.strictObject({
+  name: z.string().min(1).max(255),
+  description: z.string().max(1e3).optional(),
+  type: z.enum(AD_STUDY_TYPES).default("SPLIT_TEST"),
+  start_time: z.number().int().positive(),
+  end_time: z.number().int().positive(),
+  /** A lift study or creative test: when Meta stops counting results (≥ the end). Defaults to the end. */
+  observation_end_time: z.number().int().positive().optional(),
+  /** A creative test: the part of the ad set's daily budget it spends, major units. */
+  testDailyBudget: z.strictObject({
+    amount: z.string().regex(/^\d+(\.\d{1,2})?$/, "expected a decimal amount like 2 or 2.50"),
+    currencyCode: z.string().length(3).optional()
+  }).optional(),
+  cells: z.array(adStudyCellSchema).max(AD_STUDY_MAX_CELLS),
+  /** How sure Meta must be before it names a winner; Meta applies its own when none is sent. */
+  confidence_level: confidenceLevelSchema.optional(),
+  /** What the test is decided on. Without one, Meta compares cost per result on the campaigns' objective. */
+  objectives: z.array(adStudyObjectiveSchema).max(10).optional(),
+  /** The Business that owns the test — Meta creates studies on a Business. Filled by the backend from the ad account. */
+  business_id: z.string().regex(NUMERIC_ID_REGEX).optional()
+});
+var adStudyCreateSchema = adStudyCreateBaseSchema.superRefine(
+  (study, ctx) => addIssues(adStudyIssues(study), ctx)
+);
+var START_SOON_SECONDS = 6 * 3600;
+var adStudyCellShareSchema = z.strictObject({
+  id: z.string().regex(NUMERIC_ID_REGEX),
+  treatment_percentage: z.number().positive().max(100)
+});
+var adStudyUpdateBaseSchema = z.strictObject({
+  name: z.string().min(1).max(255).optional(),
+  description: z.string().max(1e3).optional(),
+  start_time: z.number().int().positive().optional(),
+  end_time: z.number().int().positive().optional(),
+  /** A lift study or creative test: when Meta stops counting results (≥ the end). Moved out with a later end on its own (`carryObservationEnd`). */
+  observation_end_time: z.number().int().positive().optional(),
+  /** End the test at publish: the end is set a few minutes after the change applies (Meta refuses an end in the past). */
+  end_now: z.literal(true).optional(),
+  confidence_level: confidenceLevelSchema.optional(),
+  /** Every version's new share — Meta re-splits the whole audience at once, so name every cell. */
+  cells: z.array(adStudyCellShareSchema).min(AD_STUDY_MIN_CELLS).optional(),
+  /** Delete the test. Meta removes it, results and all; ending it keeps them. */
+  status: z.literal("DELETED").optional()
+});
+function updateShapeIssues(p) {
+  const set = Object.entries(p).filter(([, value]) => value !== void 0);
+  if (set.length === 0) {
+    return [{ path: [], message: "update needs at least one field" }];
+  }
+  if (p.status === "DELETED" && set.length > 1) {
+    return [{ path: ["status"], message: "delete alone \u2014 a deleted test takes no other change" }];
+  }
+  const issues = [];
+  if (p.end_now && p.end_time !== void 0) {
+    issues.push({ path: ["end_now"], message: "end now or set end_time, not both" });
+  }
+  if (p.observation_end_time !== void 0 && p.end_time !== void 0 && p.observation_end_time < p.end_time) {
+    issues.push({
+      path: ["observation_end_time"],
+      message: "observation_end_time must run at least until the study ends (end_time) \u2014 Meta reads results until then"
+    });
+  }
+  if (p.cells) {
+    issues.push(...shareIssues(p.cells));
+    const ids = p.cells.map((cell) => cell.id);
+    if (new Set(ids).size !== ids.length) {
+      issues.push({ path: ["cells"], message: "each version's share is given once" });
+    }
+  }
+  return issues;
+}
+var adStudyUpdateSchema = adStudyUpdateBaseSchema.superRefine(
+  (p, ctx) => addIssues(updateShapeIssues(p), ctx)
+);
+function unixSeconds(value) {
+  if (typeof value === "number") {
+    return value > 1e12 ? Math.floor(value / 1e3) : value;
+  }
+  if (typeof value !== "string" || value === "") {
+    return void 0;
+  }
+  const iso = value.replace(/([+-]\d{2})(\d{2})$/, "$1:$2");
+  const ms = Date.parse(iso);
+  return Number.isNaN(ms) ? void 0 : Math.floor(ms / 1e3);
+}
+function wireIds(edge, names) {
+  const rows = edge?.data;
+  if (!rows || rows.length === 0) {
+    return void 0;
+  }
+  return rows.flatMap((row) => {
+    if (typeof row.id !== "string") return [];
+    if (typeof row.name === "string") names[row.id] = row.name;
+    return [row.id];
+  });
+}
+function text(value) {
+  return typeof value === "string" && value !== "" ? value : void 0;
+}
+function wireSources(edge) {
+  const rows = edge?.data;
+  if (!rows || rows.length === 0) {
+    return void 0;
+  }
+  return rows.map((row) => ({
+    id: String(row.id ?? ""),
+    ...Array.isArray(row.event_names) && row.event_names.length > 0 ? { event_names: row.event_names.map(String) } : {}
+  }));
+}
+function objectivesFromWire(edge) {
+  const rows = edge?.data;
+  if (!rows || rows.length === 0) {
+    return void 0;
+  }
+  return rows.map((row) => {
+    const objective = {
+      name: String(row.name ?? ""),
+      type: "CONVERSIONS",
+      ...typeof row.is_primary === "boolean" ? { is_primary: row.is_primary } : {}
+    };
+    for (const source of OBJECTIVE_SOURCES) {
+      const sources = wireSources(row[source]);
+      if (sources) objective[source] = sources;
+    }
+    return objective;
+  });
+}
+function adStudyFromWire(node) {
+  const names = {};
+  const cellRows = node.cells?.data ?? [];
+  const cells = cellRows.map((cell) => {
+    const adsets = wireIds(cell.adsets, names);
+    const campaigns = wireIds(cell.campaigns, names);
+    const ads = wireIds(cell.ads, names);
+    return {
+      id: String(cell.id ?? ""),
+      name: String(cell.name ?? ""),
+      treatment_percentage: Number(cell.treatment_percentage ?? 0),
+      ...typeof cell.control_percentage === "number" ? { control_percentage: cell.control_percentage } : {},
+      ...adsets ? { adsets } : {},
+      ...campaigns ? { campaigns } : {},
+      ...ads ? { ads } : {}
+    };
+  });
+  const out = { id: String(node.id ?? ""), cells, names };
+  const fields = [
+    ["name", text(node.name)],
+    ["description", text(node.description)],
+    ["type", text(node.type)],
+    ["start_time", unixSeconds(node.start_time)],
+    ["end_time", unixSeconds(node.end_time)],
+    ["observation_end_time", unixSeconds(node.observation_end_time)],
+    ["business_id", text(node.business?.id)],
+    ["objectives", objectivesFromWire(node.objectives)]
+  ];
+  for (const [key, value] of fields) {
+    if (value !== void 0) out[key] = value;
+  }
+  return out;
+}
+
+export {
+  META_LIMITS,
+  OBJECTIVES,
+  SPECIAL_AD_CATEGORIES,
+  SPECIAL_CATEGORIES_REQUIRING_COUNTRY,
+  BUYING_TYPES,
+  BID_STRATEGIES,
+  BID_STRATEGIES_REQUIRING_AMOUNT,
+  ROAS_FLOOR_SCALE,
+  BID_STRATEGIES_FORBIDDING_AMOUNT,
+  BILLING_EVENTS,
+  OPTIMIZATION_GOALS,
+  OPTIMIZATION_GOALS_REQUIRING_PAGE,
+  OPTIMIZATION_GOALS_REQUIRING_PIXEL,
+  OPTIMIZATION_GOALS_REQUIRING_CONVERSION_SOURCE,
+  OPTIMIZATION_GOALS_REQUIRING_APP,
+  DESTINATION_TYPES,
+  CUSTOM_EVENT_TYPES,
+  OPTIMIZATION_GOALS_WITH_FREQUENCY_CAP,
+  FREQUENCY_CAP_EVENTS,
+  FREQUENCY_CAP_TYPES,
+  PACING_TYPES,
+  SCHEDULE_TIMEZONE_TYPES,
+  ATTRIBUTION_EVENT_TYPES,
+  ATTRIBUTION_MAX_WINDOW_DAYS,
+  ADVANTAGE_AUDIENCE_OPEN_AGE_MAX,
+  ADVANTAGE_AUDIENCE_MAX_HARD_AGE_MIN,
+  EU_DSA_COUNTRIES,
+  CTA_TYPES,
+  ASSET_FEED_CTA_TYPES,
+  LEAD_FORM_CTA_TYPES,
+  AD_FORMATS,
+  ENROLL_STATUSES,
+  VISUAL_ENHANCEMENT_FEATURES,
+  STAGEABLE_CREATE_STATUSES,
+  UPDATE_STATUSES,
+  CREATIVE_UPDATE_STATUSES,
+  CUSTOM_AUDIENCE_SUBTYPES,
+  CUSTOMER_FILE_SOURCES,
+  MEDIA_KINDS,
+  CURRENCY_MINIMUMS,
+  DEFAULT_CURRENCY_MINIMUM,
+  TEMP_REF_REGEX,
+  NUMERIC_ID_REGEX,
+  IMAGE_HASH_REGEX,
+  cellObjects,
+  adStudyCreateSchema,
+  adStudyUpdateSchema,
+  unixSeconds,
+  adStudyFromWire
+};
+//# sourceMappingURL=chunk-HLVRHBKL.js.map