@redonvn/zalo-ads-sdk 0.2.7 → 0.2.13

package/dist/index.mjs

@@ -618,7 +618,10 @@ var ZaloAuthManager = class {
     let adsProfile;
     let formProfile;
     if (domain === "ads.zalo.me") {
-      await this.followOAuthRedirects("https://ads.zalo.me/api/login", cookies, true);
+      const explicitPlaySession = this.extraCookies?.PLAY_SESSION || cookies["PLAY_SESSION"];
+      if (!explicitPlaySession) {
+        await this.followOAuthRedirects("https://ads.zalo.me/api/login", cookies, true);
+      }
       const whoamiRes = await this.fetchImpl("https://ads.zalo.me/api/whoami", {
         method: "GET",
         headers: {
@@ -628,12 +631,17 @@ var ZaloAuthManager = class {
         }
       });
       this.mergeSetCookies(whoamiRes, cookies);
+      if (explicitPlaySession) {
+        cookies["PLAY_SESSION"] = explicitPlaySession;
+      }
       const whoamiJson = await whoamiRes.json().catch(() => null);
       if (whoamiJson?.data) {
         adsProfile = whoamiJson.data;
         if (adsProfile.id) {
           cookies["ads_user_id"] = String(adsProfile.id);
         }
+      } else if (this.extraCookies?.ads_user_id) {
+        cookies["ads_user_id"] = this.extraCookies.ads_user_id;
       }
     } else if (domain === "page.ads.zalo.me") {
       await this.followOAuthRedirects("https://page.ads.zalo.me/api/login", cookies, false);
@@ -1038,6 +1046,469 @@ async function resolveCookies(auth, context) {
   return { ...auth?.cookies ?? {}, ...await auth?.getCookies?.(context) ?? {} };
 }
 
+// src/dtos/ads.dto.ts
+var ZaloAdsFlowChildMessageDto = class {
+  /** Mẫu Zalo đã xác minh dùng 8 cho tin nhắn văn bản trong nhánh. */
+  type;
+  /** Nội dung phản hồi trong nhánh. */
+  text;
+};
+var ZaloAdsFlowButtonDto = class {
+  /** 3 = Gửi tin nhắn vào nhánh hội thoại; 10 = Mở website; 12 = Thực hiện cuộc gọi. */
+  type;
+  /** Nhãn nút hiển thị cho người dùng. */
+  text;
+  /** URL website; bắt buộc với type 10. */
+  url;
+  /** Cờ của nút website; dùng true với type 10. */
+  editable;
+  /** Số hotline, bắt buộc khi type là 12. */
+  phone;
+  /** Nhánh tin nhắn, bắt buộc khi type là 3. Với type 10 hoặc 12, để null hoặc bỏ qua. */
+  messages;
+};
+var ZaloAdsFlowMessageDto = class {
+  /** 1 = Tin nhắn văn bản; 2 = Tin nhắn kèm hình ảnh. */
+  type;
+  /** Nội dung tin nhắn, tối đa 1961 ký tự. Hỗ trợ biến: {{user_name}}, {{page_name}}, {{user_gender}}, {{user_id}}, {{page_id}}, {{date}}, {{datetime}}. */
+  text;
+  /** URL media hoặc null với tin nhắn văn bản thuần. Bắt buộc và không được null khi type = 2. */
+  url;
+  /** Các nút đi kèm tin nhắn. */
+  buttons;
+};
+var ZaloAdsCreateFlowRequest = class {
+  /** ID Official Account sở hữu kịch bản. */
+  oaId;
+  /** Luôn null khi tạo kịch bản mới. */
+  id;
+  /** Tên kịch bản, tối đa 33 ký tự theo giao diện Zalo Ads. */
+  name;
+  /** Các tin nhắn được gửi theo thứ tự trong kịch bản. */
+  messages;
+};
+var ZaloAdsCreateFlowResponse = class {
+  /** 0 khi tạo thành công; 1 khi lỗi (ví dụ: đã tới hạn mức 20 kịch bản). */
+  code;
+  /** Thông báo lỗi từ Zalo Ads khi code khác 0. */
+  msg;
+  /** ID kịch bản mới, truyền vào data.ZaloFlowId khi cập nhật quảng cáo Tin nhắn. */
+  data;
+};
+var ZaloAdsActionType = {
+  DAT_NGAY: 1,
+  MUA_NGAY: 2,
+  THU_NGAY: 3,
+  TAI_NGAY: 4,
+  XEM_THEM: 5,
+  QUAN_TAM_OA: 6,
+  NGHE_NGAY: 7,
+  CHOI_NGAY: 8,
+  DANG_KY: 9,
+  GOI_DIEN: 10
+};
+var ZaloAdsAgeRangeId = {
+  UNDER_18: 10282,
+  FROM_18_TO_24: 10283,
+  FROM_25_TO_34: 10284,
+  FROM_35_TO_44: 10285,
+  FROM_45_TO_54: 10286,
+  FROM_55_TO_64: 10287,
+  OVER_64: 10288
+};
+var ZaloAdsOsId = {
+  ANDROID: 0,
+  IOS: 1,
+  PC: 3
+};
+var ZaloAdsDeliveryType = {
+  STANDARD: 1,
+  ACCELERATED: 2
+};
+var ZaloAdsUpdateVideoAdRequest = class {
+  data;
+  est;
+  isBoostAd;
+  stt;
+};
+var ZaloAdsUpdateVideoAdResponse = class {
+  code;
+  msg;
+  data;
+};
+var ZaloAdsCreatePostCampaignRequest = class {
+  /** Cấu hình chiến dịch Bài viết (object hoặc chuỗi JSON). */
+  data;
+};
+var ZaloAdsCreatePostCampaignResponse = class {
+  code;
+  /** Chuỗi ID quảng cáo mới trong response Zalo Ads. */
+  msg;
+  data;
+};
+var ZaloAdsMessageAdUpdateDataDto = class {
+  AdId;
+  CampaignId;
+  MemberId;
+  /** Phiên bản lạc quan lấy từ bản quảng cáo hiện tại. */
+  RowVersion;
+  AdName;
+  /** 20 (hoặc 19) là quảng cáo Tin nhắn. */
+  Type;
+  Settings;
+  Status;
+  StartDate;
+  EndDate;
+  /** ID kịch bản, lấy từ createFlow hoặc listFlowsByOfficialAccount. */
+  ZaloFlowId;
+  ZaloPageId;
+  ZaloFormId;
+  ConversionId;
+  Report;
+};
+var ZaloAdsUpdateMessageAdRequest = class {
+  /** Payload quảng cáo đầy đủ (object hoặc chuỗi JSON); service tự tuần tự hóa thành field form data. */
+  data;
+  /** Tham số UI phụ trợ; capture Zalo Ads có giá trị literal "undefined". */
+  est;
+  /** 0 là quảng cáo thông thường, 1 là boost ad. */
+  isBoostAd;
+  /** Trạng thái thao tác của giao diện; mẫu đã ghi nhận 0. */
+  stt;
+};
+var ZaloAdsUpdateMessageAdResponse = class {
+  msg;
+  code;
+  data;
+};
+
+// src/validators/campaigns.validator.ts
+var VALID_CAMPAIGN_TYPES = {
+  WEBSITE: 6,
+  FORM: 17,
+  MESSAGE: 18,
+  OA: 3,
+  VIDEO: 14,
+  COMMERCE: 22,
+  ARTICLE: 4,
+  DISPLAY: 20
+};
+var VALID_AD_TYPES = {
+  WEBSITE: 5,
+  FORM: 18,
+  MESSAGE: 30,
+  OA: 2,
+  VIDEO: 11,
+  COMMERCE: 28,
+  // Server trả về 28 (không phải 23)
+  ARTICLE: 3,
+  DISPLAY: 21
+};
+var ALLOWED_CTAS_PER_AD_TYPE = {
+  // Website (Type 5): 9 CTAs
+  [VALID_AD_TYPES.WEBSITE]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.THU_NGAY,
+    ZaloAdsActionType.TAI_NGAY,
+    ZaloAdsActionType.XEM_THEM,
+    ZaloAdsActionType.NGHE_NGAY,
+    ZaloAdsActionType.CHOI_NGAY,
+    ZaloAdsActionType.DANG_KY,
+    ZaloAdsActionType.GOI_DIEN
+  ],
+  // Video (Type 11): 8 CTAs
+  [VALID_AD_TYPES.VIDEO]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.THU_NGAY,
+    ZaloAdsActionType.TAI_NGAY,
+    ZaloAdsActionType.XEM_THEM,
+    ZaloAdsActionType.NGHE_NGAY,
+    ZaloAdsActionType.CHOI_NGAY,
+    ZaloAdsActionType.DANG_KY
+  ],
+  // Article (Type 3): 7 CTAs
+  [VALID_AD_TYPES.ARTICLE]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.THU_NGAY,
+    ZaloAdsActionType.TAI_NGAY,
+    ZaloAdsActionType.XEM_THEM,
+    ZaloAdsActionType.CHOI_NGAY,
+    ZaloAdsActionType.DANG_KY
+  ],
+  // Form (Type 18): 5 CTAs
+  [VALID_AD_TYPES.FORM]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.THU_NGAY,
+    ZaloAdsActionType.XEM_THEM,
+    ZaloAdsActionType.DANG_KY
+  ],
+  // Commerce (Type 28): 3 CTAs
+  [VALID_AD_TYPES.COMMERCE]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.XEM_THEM
+  ],
+  // OA (Type 2): Cố định Quan tâm OA (6)
+  [VALID_AD_TYPES.OA]: [ZaloAdsActionType.QUAN_TAM_OA]
+};
+function validateCreateCampaignPayload(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("name l\xE0 b\u1EAFt bu\u1ED9c v\xE0 kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.");
+  } else if (payload.name.length > 255) {
+    errors.push("name kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  const validTypes = Object.values(VALID_CAMPAIGN_TYPES);
+  if (payload.campaignType === void 0 || payload.campaignType === null) {
+    errors.push("campaignType l\xE0 b\u1EAFt bu\u1ED9c.");
+  } else if (!validTypes.includes(payload.campaignType)) {
+    errors.push(
+      `campaignType: ${payload.campaignType} kh\xF4ng h\u1EE3p l\u1EC7. C\xE1c lo\u1EA1i h\u1ED7 tr\u1EE3: 6 (Website), 17 (Form), 18 (Message), 3 (OA), 14 (Video), 22 (Commerce), 4 (Article), 20 (Display).`
+    );
+  }
+  if (payload.campaignType !== VALID_CAMPAIGN_TYPES.DISPLAY) {
+    if (!payload.pageId || payload.pageId <= 0) {
+      errors.push("pageId c\u1EE7a Official Account l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi lo\u1EA1i chi\u1EBFn d\u1ECBch n\xE0y (ph\u1EA3i > 0).");
+    }
+  } else {
+    if (payload.pageId !== -1 && payload.pageId !== 0 && !payload.pageId) {
+      warnings.push("Qu\u1EA3ng c\xE1o Display th\u01B0\u1EDDng s\u1EED d\u1EE5ng pageId = -1.");
+    }
+  }
+  switch (payload.campaignType) {
+    case VALID_CAMPAIGN_TYPES.WEBSITE:
+      if (!payload.targetUrl || typeof payload.targetUrl !== "string" || !payload.targetUrl.trim()) {
+        errors.push("targetUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Website.");
+      } else if (!/^https?:\/\/.+/i.test(payload.targetUrl)) {
+        errors.push("targetUrl ph\u1EA3i l\xE0 m\u1ED9t \u0111\u01B0\u1EDDng link h\u1EE3p l\u1EC7 b\u1EAFt \u0111\u1EA7u b\u1EB1ng http:// ho\u1EB7c https://.");
+      }
+      break;
+    case VALID_CAMPAIGN_TYPES.ARTICLE:
+      if (!payload.articleId || payload.articleId <= 0) {
+        errors.push("articleId l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o B\xE0i Vi\u1EBFt (ph\u1EA3i > 0, l\u1EA5y t\u1EEB getOwnedArticles).");
+      }
+      break;
+    case VALID_CAMPAIGN_TYPES.COMMERCE:
+      if (payload.productId === void 0 || payload.productId === null) {
+        warnings.push("Qu\u1EA3ng c\xE1o Commerce n\xEAn ch\u1EC9 \u0111\u1ECBnh productId (ho\u1EB7c -1/0 khi d\xF9ng Instant Page s\u1EA3n ph\u1EA9m).");
+      }
+      break;
+    case VALID_CAMPAIGN_TYPES.FORM:
+    case VALID_CAMPAIGN_TYPES.MESSAGE:
+      break;
+  }
+  if (payload.budgetType !== void 0 && payload.budgetlimit !== void 0) {
+    if (payload.budgetType === 2) {
+      if (payload.budgetlimit > 0 && payload.budgetlimit < 6e5) {
+        errors.push("Ng\xE2n s\xE1ch cho To\xE0n l\u1ECBch ch\u1EA1y t\u1ED1i thi\u1EC3u l\xE0 600,000 VN\u0110.");
+      }
+    } else if (payload.budgetType === 1) {
+      if (payload.budgetlimit > 0 && payload.budgetlimit < 50) {
+        warnings.push("S\u1ED1 l\u01B0\u1EE3ng t\u01B0\u01A1ng t\xE1c m\u1ED7i ng\xE0y t\u1ED1i thi\u1EC3u \u0111\u01B0\u1EE3c khuy\u1EBFn ngh\u1ECB t\u1EEB 50 l\u01B0\u1EE3t.");
+      }
+    }
+  }
+  if (payload.campaignId && payload.campaignId > 0) {
+    if (payload.adId !== 0) {
+      warnings.push("Khi th\xEAm Ad m\u1EDBi v\xE0o chi\u1EBFn d\u1ECBch hi\u1EC7n c\xF3 (Multi-Ad), adId n\xEAn \u0111\u1EC3 b\u1EB1ng 0.");
+    }
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateUpdateAdPayload(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.AdId || payload.AdId <= 0) {
+    errors.push("AdId l\xE0 b\u1EAFt bu\u1ED9c (ph\u1EA3i > 0).");
+  }
+  if (!payload.CampaignId || payload.CampaignId <= 0) {
+    errors.push("CampaignId l\xE0 b\u1EAFt bu\u1ED9c (ph\u1EA3i > 0).");
+  }
+  if (!payload.AdName || !payload.AdName.trim()) {
+    errors.push("AdName l\xE0 b\u1EAFt bu\u1ED9c v\xE0 kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.");
+  } else if (payload.AdName.length > 255) {
+    errors.push(`AdName qu\xE1 d\xE0i (${payload.AdName.length}/255 k\xFD t\u1EF1).`);
+  }
+  const adInfo = payload.Settings?.AdInfo;
+  if (!adInfo) {
+    errors.push("Settings.AdInfo l\xE0 b\u1EAFt bu\u1ED9c.");
+  } else {
+    if (!adInfo.Caption || !adInfo.Caption.trim()) {
+      errors.push("Settings.AdInfo.Caption l\xE0 b\u1EAFt bu\u1ED9c.");
+    } else {
+      const captionLen = adInfo.Caption.trim().length;
+      if (captionLen < 35) {
+        errors.push(`Settings.AdInfo.Caption qu\xE1 ng\u1EAFn (${captionLen}/35 k\xFD t\u1EF1 t\u1ED1i thi\u1EC3u).`);
+      } else if (captionLen > 90) {
+        errors.push(`Settings.AdInfo.Caption qu\xE1 d\xE0i (${captionLen}/90 k\xFD t\u1EF1 t\u1ED1i \u0111a).`);
+      }
+    }
+    if (adInfo.MoreInfo && adInfo.MoreInfo.trim()) {
+      const moreInfoLen = adInfo.MoreInfo.trim().length;
+      if (moreInfoLen < 90) {
+        warnings.push(`Ch\xFA th\xEDch m\u1EDF r\u1ED9ng n\xEAn \u0111\u1EA1t t\u1ED1i thi\u1EC3u 90 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${moreInfoLen}).`);
+      } else if (moreInfoLen > 2e3) {
+        errors.push(`Ch\xFA th\xEDch m\u1EDF r\u1ED9ng v\u01B0\u1EE3t qu\xE1 gi\u1EDBi h\u1EA1n t\u1ED1i \u0111a 2000 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${moreInfoLen}).`);
+      }
+    }
+    if (adInfo.Action !== void 0 && payload.Type) {
+      const allowedCtas = ALLOWED_CTAS_PER_AD_TYPE[payload.Type];
+      if (allowedCtas && !allowedCtas.includes(adInfo.Action)) {
+        warnings.push(
+          `M\xE3 h\xE0nh \u0111\u1ED9ng Action: ${adInfo.Action} c\xF3 th\u1EC3 kh\xF4ng n\u1EB1m trong danh m\u1EE5c n\xFAt CTA h\u1ED7 tr\u1EE3 cho Ad Type ${payload.Type}.`
+        );
+      }
+    }
+  }
+  const price = payload.Settings?.Price;
+  if (!price) {
+    errors.push("Settings.Price l\xE0 b\u1EAFt bu\u1ED9c.");
+  } else {
+    if (payload.Type === VALID_AD_TYPES.WEBSITE) {
+      if (price.Type !== 1) {
+        errors.push(
+          "\u0110\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Website (Type 5), Price.Type b\u1EAFt bu\u1ED9c ph\u1EA3i b\u1EB1ng 1 (CPC). N\u1EBFu truy\u1EC1n 2 s\u1EBD b\u1ECB m\xE1y ch\u1EE7 l\u1ED7i."
+        );
+      }
+      if (price.LimitType === 1) {
+        errors.push(
+          "Qu\u1EA3ng c\xE1o Website kh\xF4ng h\u1ED7 tr\u1EE3 LimitType: 1 (t\u1ED5ng ng\xE2n s\xE1ch). B\u1EAFt bu\u1ED9c ph\u1EA3i d\xF9ng LimitType: 0 (ng\xE2n s\xE1ch ng\xE0y)."
+        );
+      }
+    } else if (payload.Type === VALID_AD_TYPES.COMMERCE || payload.Type === VALID_AD_TYPES.OA || payload.Type === VALID_AD_TYPES.ARTICLE || payload.Type === VALID_AD_TYPES.VIDEO || payload.Type === VALID_AD_TYPES.FORM || payload.Type === VALID_AD_TYPES.MESSAGE) {
+      if (price.Type !== 2) {
+        errors.push(
+          `\u0110\u1ED1i v\u1EDBi Ad Type ${payload.Type}, Price.Type b\u1EAFt bu\u1ED9c ph\u1EA3i b\u1EB1ng 2. N\u1EBFu truy\u1EC1n 1, Zalo Ads s\u1EBD b\xE1o l\u1ED7i code 14 (\u0110\u1EB7t gi\xE1 theo L\u01B0\u1EE3t hi\u1EC3n th\u1ECB kh\xF4ng h\u1ED7 tr\u1EE3).`
+        );
+      }
+    }
+    if (price.Limit !== void 0 && price.Limit > 0 && price.Limit < 50) {
+      warnings.push("S\u1ED1 l\u01B0\u1EE3ng l\u01B0\u1EE3t t\u01B0\u01A1ng t\xE1c \u0111\u1EB7t m\u1ED7i ng\xE0y t\u1ED1i thi\u1EC3u l\xE0 50 l\u01B0\u1EE3t.");
+    }
+  }
+  const targeting = payload.Settings?.Targeting;
+  if (targeting) {
+    if (targeting.AgeRanges && targeting.AgeRanges.length > 0) {
+      const validAges = Object.values(ZaloAdsAgeRangeId);
+      const invalidAges = targeting.AgeRanges.filter((a) => !validAges.includes(a));
+      if (invalidAges.length > 0) {
+        errors.push(`M\xE3 kho\u1EA3ng tu\u1ED5i kh\xF4ng h\u1EE3p l\u1EC7: ${invalidAges.join(", ")}. H\u1EE3p l\u1EC7: ${validAges.join(", ")}.`);
+      }
+    }
+    if (targeting.OsTypes && targeting.OsTypes.length > 0) {
+      const validOs = Object.values(ZaloAdsOsId);
+      const invalidOs = targeting.OsTypes.filter((os) => !validOs.includes(os));
+      if (invalidOs.length > 0) {
+        errors.push(`M\xE3 h\u1EC7 \u0111i\u1EC1u h\xE0nh kh\xF4ng h\u1EE3p l\u1EC7: ${invalidOs.join(", ")}. H\u1EE3p l\u1EC7: 0 (Android), 1 (iOS), 3 (PC).`);
+      }
+    }
+    const deliveryType = payload.Settings?.DeliveryType;
+    if (deliveryType !== void 0 && deliveryType !== 1 && deliveryType !== 2) {
+      warnings.push("DeliveryType n\xEAn l\xE0 1 (Ti\xEAu chu\u1EA9n) ho\u1EB7c 2 (T\u0103ng t\u1ED1c).");
+    }
+  }
+  if (payload.Type === VALID_AD_TYPES.FORM) {
+    if (!payload.ZaloFormId || !payload.ZaloFormId.trim()) {
+      errors.push("ZaloFormId l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Form (Ad Type 18).");
+    }
+  } else if (payload.Type === VALID_AD_TYPES.MESSAGE) {
+    if (!payload.Settings?.Image?.LogoUrl) {
+      errors.push("Settings.Image.LogoUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Tin Nh\u1EAFn (Ad Type 30).");
+    }
+    if (!payload.ZaloFlowId && !payload.MiniPageId) {
+      warnings.push("Qu\u1EA3ng c\xE1o Tin Nh\u1EAFn n\xEAn g\u1EAFn ZaloFlowId ho\u1EB7c MiniPageId (Template 4 k\u1ECBch b\u1EA3n tin nh\u1EAFn).");
+    }
+  } else if (payload.Type === VALID_AD_TYPES.COMMERCE) {
+    if (!payload.MiniPageId || payload.MiniPageId <= 0) {
+      errors.push("MiniPageId l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Commerce (Ad Type 28, Template 1/2/3).");
+    }
+  } else if (payload.Type === VALID_AD_TYPES.VIDEO) {
+    if (!payload.ZaloVideoId && !payload.Settings?.Image?.VideoUrl) {
+      errors.push("ZaloVideoId ho\u1EB7c Settings.Image.VideoUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Video (Ad Type 11).");
+    }
+    if (payload.Settings?.Image?.VideoUrl && !payload.Settings.Image.VideoUrl.includes("zascdn.me")) {
+      warnings.push("VideoUrl n\xEAn l\xE0 \u0111\u01B0\u1EDDng d\u1EABn CDN ch\xEDnh th\u1EE9c c\u1EE7a Zalo Ads (*.zascdn.me).");
+    }
+  } else if (payload.Type === VALID_AD_TYPES.ARTICLE) {
+    if (!payload.ZaloFeedId && !payload.articleId) {
+      errors.push("ZaloFeedId ho\u1EB7c articleId l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o B\xE0i Vi\u1EBFt (Ad Type 3).");
+    }
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateRenameCampaignParams(params) {
+  const errors = [];
+  const warnings = [];
+  const id = params.campid || params.campaignId;
+  const name = params.newname || params.newName || params.name;
+  if (!id || id <= 0) {
+    errors.push("ID chi\u1EBFn d\u1ECBch (campid/campaignId) l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i > 0.");
+  }
+  if (!name || !name.trim()) {
+    errors.push("T\xEAn m\u1EDBi c\u1EE7a chi\u1EBFn d\u1ECBch (newname/name) l\xE0 b\u1EAFt bu\u1ED9c v\xE0 kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.");
+  } else if (name.length > 255) {
+    errors.push(`T\xEAn chi\u1EBFn d\u1ECBch qu\xE1 d\xE0i (${name.length}/255 k\xFD t\u1EF1).`);
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateChangeCampaignStatusParams(params) {
+  const errors = [];
+  const warnings = [];
+  if (!params.campaignId || params.campaignId <= 0) {
+    errors.push("campaignId l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i > 0.");
+  }
+  if (![1, 2, -2].includes(params.status)) {
+    errors.push(`status: ${params.status} kh\xF4ng h\u1EE3p l\u1EC7. C\xE1c tr\u1EA1ng th\xE1i h\u1EE3p l\u1EC7: 1 (B\u1EADt), 2 (T\u1EA1m d\u1EEBng), -2 (X\xF3a).`);
+  }
+  if (params.status === 2 && params.isDraft) {
+    warnings.push(
+      "Chi\u1EBFn d\u1ECBch nh\xE1p ch\u01B0a c\xF3 qu\u1EA3ng c\xE1o ho\u1EA1t \u0111\u1ED9ng khi g\u1ECDi status: 2 (T\u1EA1m d\u1EEBng) s\u1EBD b\u1ECB m\xE1y ch\u1EE7 n\xE9m l\u1ED7i HTTP 500 Internal Server Error. \u0110\u1EC3 d\u1ECDn d\u1EB9p h\xE3y d\xF9ng status: -2 (X\xF3a)."
+    );
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function validateDuplicateAdParams(params) {
+  const errors = [];
+  const warnings = [];
+  const id = params.adid || params.adId;
+  if (!id || id <= 0) {
+    errors.push("ID m\u1EABu qu\u1EA3ng c\xE1o g\u1ED1c c\u1EA7n nh\xE2n b\u1EA3n (adid/adId) l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i > 0.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+var ZaloCampaignsValidator = {
+  createCampaign: validateCreateCampaignPayload,
+  updateAd: validateUpdateAdPayload,
+  renameCampaign: validateRenameCampaignParams,
+  changeStatus: validateChangeCampaignStatusParams,
+  duplicateAd: validateDuplicateAdParams
+};
+
 // src/services/campaigns.service.ts
 var OP_ZaloAdsUpdateVideoAd = {
   operationId: "ZaloAds_updateVideoAd",
@@ -1158,7 +1629,9 @@ var OP_ZaloAdsGetAdById = {
   "binaryFields": [],
   "pathFields": [],
   "queryFields": [
-    "adId"
+    "adId",
+    "v",
+    "newWard"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -1230,7 +1703,9 @@ var OP_ZaloAdsGetZaapiGetadsfromcampaignid = {
   "pathFields": [],
   "queryFields": [
     "campaignId",
-    "campId"
+    "campId",
+    "dataType",
+    "v"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -1531,6 +2006,18 @@ var OP_ZaloAdsDeleteCampaign = {
     "status"
   ]
 };
+var OP_ZaloAdsDuplicateAd = {
+  operationId: "zalo_ads_duplicate_ad",
+  method: "POST",
+  endpoint: "/zaapi/DuplicateAd",
+  baseUrl: "https://ads.zalo.me",
+  binaryFields: [],
+  pathFields: [],
+  queryFields: [],
+  headerFields: [],
+  cookieFields: [],
+  bodyFields: ["adid"]
+};
 var OP_ZaloAdsCreateSpellCheckV3Job = {
   operationId: "zalo_ads_create_spell_check_v3_job",
   method: "POST",
@@ -1559,6 +2046,8 @@ var ZaloCampaignsService = class {
   constructor(client) {
     this.client = client;
   }
+  validator = ZaloCampaignsValidator;
+  static validator = ZaloCampaignsValidator;
   updateVideoAd(request, options) {
     return this.client.requestFormUrlEncoded(OP_ZaloAdsUpdateVideoAd, this.client.toTransportInput(OP_ZaloAdsUpdateVideoAd, request), options);
   }
@@ -1615,10 +2104,19 @@ var ZaloCampaignsService = class {
     return this.createPostCampaign(request, options);
   }
   getAdById(request = {}, options) {
-    return this.client.requestWithoutBody(OP_ZaloAdsGetAdById, this.client.toTransportInput(OP_ZaloAdsGetAdById, request), options);
+    const normalized = {
+      adId: request.adId,
+      v: request.v ?? 2,
+      newWard: request.newWard ?? true
+    };
+    return this.client.requestWithoutBody(OP_ZaloAdsGetAdById, this.client.toTransportInput(OP_ZaloAdsGetAdById, normalized), options);
   }
   getAdChangeLog(request, options) {
-    return this.client.requestWithoutBody(OP_ZaloAdsGetAdChangeLog, this.client.toTransportInput(OP_ZaloAdsGetAdChangeLog, request), options);
+    const normalized = {
+      adId: request.adId,
+      type: request.type ?? 1
+    };
+    return this.client.requestWithoutBody(OP_ZaloAdsGetAdChangeLog, this.client.toTransportInput(OP_ZaloAdsGetAdChangeLog, normalized), options);
   }
   getApiPlaceGetalldistricts(request = {}, options) {
     return this.client.requestWithoutBody(OP_ZaloAdsGetApiPlaceGetalldistricts, this.client.toTransportInput(OP_ZaloAdsGetApiPlaceGetalldistricts, request), options);
@@ -1630,7 +2128,16 @@ var ZaloCampaignsService = class {
     return this.client.requestWithoutBody(OP_ZaloAdsGetZaapiCheckcamphasmanyads, this.client.toTransportInput(OP_ZaloAdsGetZaapiCheckcamphasmanyads, request), options);
   }
   getZaapiGetadsfromcampaignid(request = {}, options) {
-    return this.client.requestWithoutBody(OP_ZaloAdsGetZaapiGetadsfromcampaignid, this.client.toTransportInput(OP_ZaloAdsGetZaapiGetadsfromcampaignid, request), options);
+    const normalized = {
+      campaignId: request.campaignId ?? request.campId,
+      dataType: request.dataType ?? 1,
+      v: request.v ?? 2
+    };
+    return this.client.requestWithoutBody(OP_ZaloAdsGetZaapiGetadsfromcampaignid, this.client.toTransportInput(OP_ZaloAdsGetZaapiGetadsfromcampaignid, normalized), options);
+  }
+  /** Alias lấy danh sách quảng cáo của chiến dịch kèm metadata extend và extra.appliedRuleInfo */
+  getAdsFromCampaignId(request = {}, options) {
+    return this.getZaapiGetadsfromcampaignid(request, options);
   }
   getZaapiGetallpages(request = {}, options) {
     return this.client.requestWithoutBody(OP_ZaloAdsGetZaapiGetallpages, this.client.toTransportInput(OP_ZaloAdsGetZaapiGetallpages, request), options);
@@ -1660,7 +2167,11 @@ var ZaloCampaignsService = class {
     return this.client.requestWithoutBody(OP_ZaloAdsPostZaapiDeletead, this.client.toTransportInput(OP_ZaloAdsPostZaapiDeletead, request), options);
   }
   renameCampaign(request, options) {
-    return this.client.requestFormUrlEncoded(OP_ZaloAdsRenameCampaign, this.client.toTransportInput(OP_ZaloAdsRenameCampaign, request), options);
+    const normalized = {
+      campid: request.campid ?? request.campaignId,
+      newname: request.newname ?? request.campaignName ?? request.name
+    };
+    return this.client.requestFormUrlEncoded(OP_ZaloAdsRenameCampaign, this.client.toTransportInput(OP_ZaloAdsRenameCampaign, normalized), options);
   }
   updateEcommerceAd(request, options) {
     return this.client.requestFormUrlEncoded(OP_ZaloAdsUpdateEcommerceAd, this.client.toTransportInput(OP_ZaloAdsUpdateEcommerceAd, request), options);
@@ -1746,6 +2257,20 @@ var ZaloCampaignsService = class {
     }
     throw new Error(`[SpellCheckV3] Qu\xE1 th\u1EDDi gian ch\u1EDD (${timeoutMs}ms) cho t\xE1c v\u1EE5 ki\u1EC3m tra ch\xEDnh t\u1EA3 jobId: ${jobId}`);
   }
+  /**
+   * Nhân bản (sao chép / duplicate) một mẫu quảng cáo đã tồn tại trên Zalo Ads (POST /zaapi/DuplicateAd).
+   * Giúp tạo nhanh một bản sao Ad mới trong cùng chiến dịch để thực hiện A/B testing.
+   */
+  duplicateAd(request, options) {
+    const payload = {
+      adid: request.adid ?? request.adId
+    };
+    return this.client.requestFormUrlEncoded(
+      OP_ZaloAdsDuplicateAd,
+      this.client.toTransportInput(OP_ZaloAdsDuplicateAd, payload),
+      options
+    );
+  }
 };
 
 // src/services/account.service.ts
@@ -2647,6 +3172,25 @@ var OP_ZaloAdsUpsertCustomReport = {
     "isDefault"
   ]
 };
+var OP_ZaloAdsDownloadReport = {
+  operationId: "zalo_ads_download_report",
+  method: "POST",
+  endpoint: "/api/collect",
+  baseUrl: "https://ads.zalo.me",
+  binaryFields: [],
+  pathFields: [],
+  queryFields: [],
+  headerFields: [],
+  cookieFields: [],
+  bodyFields: [
+    "t",
+    "adIds",
+    "status",
+    "dateFilter",
+    "reportKind",
+    "et"
+  ]
+};
 var ZaloReportsService = class {
   constructor(client) {
     this.client = client;
@@ -2709,6 +3253,18 @@ var ZaloReportsService = class {
   getCampaignReportLegacy(...args) {
     return this.getZaapiCampaignReportcampaign(...args);
   }
+  /** Xuất và tải trực tiếp tệp tin Excel (.xlsx / Blob) báo cáo hiệu quả quảng cáo (POST /api/collect) */
+  downloadReport(request, options) {
+    const payload = {
+      t: request.t ?? "cd.download.report",
+      status: request.status ?? 2,
+      dateFilter: request.dateFilter ?? 0,
+      reportKind: request.reportKind ?? 100001,
+      et: request.et ?? Math.floor(Date.now() / 1e3),
+      adIds: request.adIds
+    };
+    return this.client.requestJson(OP_ZaloAdsDownloadReport, this.client.toTransportInput(OP_ZaloAdsDownloadReport, payload), options);
+  }
 };
 
 // src/services/conversions.service.ts
@@ -4967,7 +5523,7 @@ function validateUpdateInstantPageRequest(input) {
   if (obj.status !== void 0 && obj.status !== null) {
     const st = Number(obj.status);
     if (![0, 1, 2, 3].includes(st)) {
-      errors.push("Tr\u01B0\u1EDDng 'status' ph\u1EA3i l\xE0 m\u1ED9t trong c\xE1c m\xE3: 0 (B\u1EA3n sao m\u1EDBi), 1 (B\u1EA3n nh\xE1p), 2 (\u0110\xE3 xu\u1EA5t b\u1EA3n), 3 (L\u01B0u tr\u1EEF).");
+      errors.push("Tr\u01B0\u1EDDng 'status' ph\u1EA3i l\xE0 m\u1ED9t trong c\xE1c m\xE3: 0 (B\u1EA3n sao m\u1EDBi t\u1EA1o ch\u01B0a l\u01B0u), 1 (\u0110ang ho\u1EA1t \u0111\u1ED9ng / \u0110\xE3 xu\u1EA5t b\u1EA3n), 3 (\u0110\xE3 k\u1EBFt th\xFAc / L\u01B0u tr\u1EEF).");
     } else {
       data.status = st;
     }
@@ -5875,112 +6431,6 @@ var ZaloAdsIntegrationManager = class {
   }
 };
 
-// src/dtos/ads.dto.ts
-var ZaloAdsFlowChildMessageDto = class {
-  /** Mẫu Zalo đã xác minh dùng 8 cho tin nhắn văn bản trong nhánh. */
-  type;
-  /** Nội dung phản hồi trong nhánh. */
-  text;
-};
-var ZaloAdsFlowButtonDto = class {
-  /** 3 = Gửi tin nhắn vào nhánh hội thoại; 10 = Mở website; 12 = Thực hiện cuộc gọi. */
-  type;
-  /** Nhãn nút hiển thị cho người dùng. */
-  text;
-  /** URL website; bắt buộc với type 10. */
-  url;
-  /** Cờ của nút website; dùng true với type 10. */
-  editable;
-  /** Số hotline, bắt buộc khi type là 12. */
-  phone;
-  /** Nhánh tin nhắn, bắt buộc khi type là 3. Với type 10 hoặc 12, để null hoặc bỏ qua. */
-  messages;
-};
-var ZaloAdsFlowMessageDto = class {
-  /** 1 = Tin nhắn văn bản; 2 = Tin nhắn kèm hình ảnh. */
-  type;
-  /** Nội dung tin nhắn, tối đa 1961 ký tự. Hỗ trợ biến: {{user_name}}, {{page_name}}, {{user_gender}}, {{user_id}}, {{page_id}}, {{date}}, {{datetime}}. */
-  text;
-  /** URL media hoặc null với tin nhắn văn bản thuần. Bắt buộc và không được null khi type = 2. */
-  url;
-  /** Các nút đi kèm tin nhắn. */
-  buttons;
-};
-var ZaloAdsCreateFlowRequest = class {
-  /** ID Official Account sở hữu kịch bản. */
-  oaId;
-  /** Luôn null khi tạo kịch bản mới. */
-  id;
-  /** Tên kịch bản, tối đa 33 ký tự theo giao diện Zalo Ads. */
-  name;
-  /** Các tin nhắn được gửi theo thứ tự trong kịch bản. */
-  messages;
-};
-var ZaloAdsCreateFlowResponse = class {
-  /** 0 khi tạo thành công; 1 khi lỗi (ví dụ: đã tới hạn mức 20 kịch bản). */
-  code;
-  /** Thông báo lỗi từ Zalo Ads khi code khác 0. */
-  msg;
-  /** ID kịch bản mới, truyền vào data.ZaloFlowId khi cập nhật quảng cáo Tin nhắn. */
-  data;
-};
-var ZaloAdsUpdateVideoAdRequest = class {
-  data;
-  est;
-  isBoostAd;
-  stt;
-};
-var ZaloAdsUpdateVideoAdResponse = class {
-  code;
-  msg;
-  data;
-};
-var ZaloAdsCreatePostCampaignRequest = class {
-  /** Cấu hình chiến dịch Bài viết (object hoặc chuỗi JSON). */
-  data;
-};
-var ZaloAdsCreatePostCampaignResponse = class {
-  code;
-  /** Chuỗi ID quảng cáo mới trong response Zalo Ads. */
-  msg;
-  data;
-};
-var ZaloAdsMessageAdUpdateDataDto = class {
-  AdId;
-  CampaignId;
-  MemberId;
-  /** Phiên bản lạc quan lấy từ bản quảng cáo hiện tại. */
-  RowVersion;
-  AdName;
-  /** 20 (hoặc 19) là quảng cáo Tin nhắn. */
-  Type;
-  Settings;
-  Status;
-  StartDate;
-  EndDate;
-  /** ID kịch bản, lấy từ createFlow hoặc listFlowsByOfficialAccount. */
-  ZaloFlowId;
-  ZaloPageId;
-  ZaloFormId;
-  ConversionId;
-  Report;
-};
-var ZaloAdsUpdateMessageAdRequest = class {
-  /** Payload quảng cáo đầy đủ (object hoặc chuỗi JSON); service tự tuần tự hóa thành field form data. */
-  data;
-  /** Tham số UI phụ trợ; capture Zalo Ads có giá trị literal "undefined". */
-  est;
-  /** 0 là quảng cáo thông thường, 1 là boost ad. */
-  isBoostAd;
-  /** Trạng thái thao tác của giao diện; mẫu đã ghi nhận 0. */
-  stt;
-};
-var ZaloAdsUpdateMessageAdResponse = class {
-  msg;
-  code;
-  data;
-};
-
 // src/dtos/instant-pages.dto.ts
 var ZaloInstantPageBlockType = /* @__PURE__ */ ((ZaloInstantPageBlockType2) => {
   ZaloInstantPageBlockType2[ZaloInstantPageBlockType2["CAROUSEL_SLIDER"] = 1] = "CAROUSEL_SLIDER";
@@ -6004,21 +6454,28 @@ var ZaloInstantPageBlockType = /* @__PURE__ */ ((ZaloInstantPageBlockType2) => {
   return ZaloInstantPageBlockType2;
 })(ZaloInstantPageBlockType || {});
 export {
+  ALLOWED_CTAS_PER_AD_TYPE,
   ALL_ZALO_ADS_DOMAINS,
   MemoryZaloSessionStore,
   RedisZaloSessionStore,
   TieredZaloSessionStore,
+  VALID_AD_TYPES,
+  VALID_CAMPAIGN_TYPES,
   ZaloAccountService,
   ZaloAdsIntegrationManager as ZaloAdsAccountPool,
+  ZaloAdsActionType,
+  ZaloAdsAgeRangeId,
   ZaloAdsCreateFlowRequest,
   ZaloAdsCreateFlowResponse,
   ZaloAdsCreatePostCampaignRequest,
   ZaloAdsCreatePostCampaignResponse,
+  ZaloAdsDeliveryType,
   ZaloAdsFlowButtonDto,
   ZaloAdsFlowChildMessageDto,
   ZaloAdsFlowMessageDto,
   ZaloAdsIntegrationManager,
   ZaloAdsMessageAdUpdateDataDto,
+  ZaloAdsOsId,
   ZaloAdsSdk,
   ZaloAdsService,
   ZaloAdsUpdateMessageAdRequest,
@@ -6030,6 +6487,7 @@ export {
   ZaloAuthManager,
   ZaloAutomatedRulesService,
   ZaloCampaignsService,
+  ZaloCampaignsValidator,
   ZaloChatWidgetService,
   ZaloConversionsService,
   ZaloFlowsService,
@@ -6052,7 +6510,9 @@ export {
   defaultSharedMemorySessionStore,
   deriveAccountKeyFromZpsid,
   parseZaloCookieInput,
+  validateChangeCampaignStatusParams,
   validateCloneInstantPageRequest,
+  validateCreateCampaignPayload,
   validateCreateFlowRequest,
   validateCreateFormEventAudienceRequest,
   validateCreateFormRequest,
@@ -6061,6 +6521,7 @@ export {
   validateCreateMessagePersonalEventAudienceRequest,
   validateCreatePhoneAudienceRequest,
   validateCreateSavedAudienceRequest,
+  validateDuplicateAdParams,
   validateEstimateAudienceRequest,
   validateGetInstantPageDetailRequest,
   validateGetInstantPageSharedUserRequest,
@@ -6074,7 +6535,9 @@ export {
   validateListInstantPageUsersRequest,
   validateListMiniPageTemplatesRequest,
   validateListOfficialAccountsRequest,
+  validateRenameCampaignParams,
   validateSearchInstantPagesRequest,
+  validateUpdateAdPayload,
   validateUpdateFlowRequest,
   validateUpdateInstantPageRequest,
   validateUpsertInstantPageFormRequest