@redonvn/zalo-ads-sdk 0.2.4 → 0.2.13

package/dist/index.js

@@ -30,21 +30,28 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ALLOWED_CTAS_PER_AD_TYPE: () => ALLOWED_CTAS_PER_AD_TYPE,
   ALL_ZALO_ADS_DOMAINS: () => ALL_ZALO_ADS_DOMAINS,
   MemoryZaloSessionStore: () => MemoryZaloSessionStore,
   RedisZaloSessionStore: () => RedisZaloSessionStore,
   TieredZaloSessionStore: () => TieredZaloSessionStore,
+  VALID_AD_TYPES: () => VALID_AD_TYPES,
+  VALID_CAMPAIGN_TYPES: () => VALID_CAMPAIGN_TYPES,
   ZaloAccountService: () => ZaloAccountService,
   ZaloAdsAccountPool: () => ZaloAdsIntegrationManager,
+  ZaloAdsActionType: () => ZaloAdsActionType,
+  ZaloAdsAgeRangeId: () => ZaloAdsAgeRangeId,
   ZaloAdsCreateFlowRequest: () => ZaloAdsCreateFlowRequest,
   ZaloAdsCreateFlowResponse: () => ZaloAdsCreateFlowResponse,
   ZaloAdsCreatePostCampaignRequest: () => ZaloAdsCreatePostCampaignRequest,
   ZaloAdsCreatePostCampaignResponse: () => ZaloAdsCreatePostCampaignResponse,
+  ZaloAdsDeliveryType: () => ZaloAdsDeliveryType,
   ZaloAdsFlowButtonDto: () => ZaloAdsFlowButtonDto,
   ZaloAdsFlowChildMessageDto: () => ZaloAdsFlowChildMessageDto,
   ZaloAdsFlowMessageDto: () => ZaloAdsFlowMessageDto,
   ZaloAdsIntegrationManager: () => ZaloAdsIntegrationManager,
   ZaloAdsMessageAdUpdateDataDto: () => ZaloAdsMessageAdUpdateDataDto,
+  ZaloAdsOsId: () => ZaloAdsOsId,
   ZaloAdsSdk: () => ZaloAdsSdk,
   ZaloAdsService: () => ZaloAdsService,
   ZaloAdsUpdateMessageAdRequest: () => ZaloAdsUpdateMessageAdRequest,
@@ -52,13 +59,17 @@ __export(index_exports, {
   ZaloAdsUpdateVideoAdRequest: () => ZaloAdsUpdateVideoAdRequest,
   ZaloAdsUpdateVideoAdResponse: () => ZaloAdsUpdateVideoAdResponse,
   ZaloAudiencesService: () => ZaloAudiencesService,
+  ZaloAudiencesValidator: () => ZaloAudiencesValidator,
   ZaloAuthManager: () => ZaloAuthManager,
   ZaloAutomatedRulesService: () => ZaloAutomatedRulesService,
   ZaloCampaignsService: () => ZaloCampaignsService,
+  ZaloCampaignsValidator: () => ZaloCampaignsValidator,
   ZaloChatWidgetService: () => ZaloChatWidgetService,
   ZaloConversionsService: () => ZaloConversionsService,
   ZaloFlowsService: () => ZaloFlowsService,
+  ZaloFlowsValidator: () => ZaloFlowsValidator,
   ZaloFormsService: () => ZaloFormsService,
+  ZaloFormsValidator: () => ZaloFormsValidator,
   ZaloInstantPageBlockType: () => ZaloInstantPageBlockType,
   ZaloInstantPagesService: () => ZaloInstantPagesService,
   ZaloInstantPagesValidator: () => ZaloInstantPagesValidator,
@@ -75,9 +86,24 @@ __export(index_exports, {
   defaultSharedMemorySessionStore: () => defaultSharedMemorySessionStore,
   deriveAccountKeyFromZpsid: () => deriveAccountKeyFromZpsid,
   parseZaloCookieInput: () => parseZaloCookieInput,
+  validateChangeCampaignStatusParams: () => validateChangeCampaignStatusParams,
   validateCloneInstantPageRequest: () => validateCloneInstantPageRequest,
+  validateCreateCampaignPayload: () => validateCreateCampaignPayload,
+  validateCreateFlowRequest: () => validateCreateFlowRequest,
+  validateCreateFormEventAudienceRequest: () => validateCreateFormEventAudienceRequest,
+  validateCreateFormRequest: () => validateCreateFormRequest,
+  validateCreateLookalikeAudienceRequest: () => validateCreateLookalikeAudienceRequest,
+  validateCreateMessageOaEventAudienceRequest: () => validateCreateMessageOaEventAudienceRequest,
+  validateCreateMessagePersonalEventAudienceRequest: () => validateCreateMessagePersonalEventAudienceRequest,
+  validateCreatePhoneAudienceRequest: () => validateCreatePhoneAudienceRequest,
+  validateCreateSavedAudienceRequest: () => validateCreateSavedAudienceRequest,
+  validateDuplicateAdParams: () => validateDuplicateAdParams,
+  validateEstimateAudienceRequest: () => validateEstimateAudienceRequest,
   validateGetInstantPageDetailRequest: () => validateGetInstantPageDetailRequest,
   validateGetInstantPageSharedUserRequest: () => validateGetInstantPageSharedUserRequest,
+  validateListFlowsByOfficialAccountRequest: () => validateListFlowsByOfficialAccountRequest,
+  validateListFormLeadsRequest: () => validateListFormLeadsRequest,
+  validateListFormsByOfficialAccountRequest: () => validateListFormsByOfficialAccountRequest,
   validateListInstantPageEditHistoryRequest: () => validateListInstantPageEditHistoryRequest,
   validateListInstantPageFormRecordsRequest: () => validateListInstantPageFormRecordsRequest,
   validateListInstantPageLeadsRequest: () => validateListInstantPageLeadsRequest,
@@ -85,7 +111,10 @@ __export(index_exports, {
   validateListInstantPageUsersRequest: () => validateListInstantPageUsersRequest,
   validateListMiniPageTemplatesRequest: () => validateListMiniPageTemplatesRequest,
   validateListOfficialAccountsRequest: () => validateListOfficialAccountsRequest,
+  validateRenameCampaignParams: () => validateRenameCampaignParams,
   validateSearchInstantPagesRequest: () => validateSearchInstantPagesRequest,
+  validateUpdateAdPayload: () => validateUpdateAdPayload,
+  validateUpdateFlowRequest: () => validateUpdateFlowRequest,
   validateUpdateInstantPageRequest: () => validateUpdateInstantPageRequest,
   validateUpsertInstantPageFormRequest: () => validateUpsertInstantPageFormRequest
 });
@@ -711,7 +740,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: {
@@ -721,12 +753,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);
@@ -1131,6 +1168,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",
@@ -1251,7 +1751,9 @@ var OP_ZaloAdsGetAdById = {
   "binaryFields": [],
   "pathFields": [],
   "queryFields": [
-    "adId"
+    "adId",
+    "v",
+    "newWard"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -1323,7 +1825,9 @@ var OP_ZaloAdsGetZaapiGetadsfromcampaignid = {
   "pathFields": [],
   "queryFields": [
     "campaignId",
-    "campId"
+    "campId",
+    "dataType",
+    "v"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -1624,10 +2128,48 @@ 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",
+  endpoint: "/api/spell-check/v3",
+  baseUrl: "https://ads.zalo.me",
+  binaryFields: [],
+  pathFields: [],
+  queryFields: [],
+  headerFields: [],
+  cookieFields: [],
+  bodyFields: ["title", "caption"]
+};
+var OP_ZaloAdsGetSpellCheckV3Job = {
+  operationId: "zalo_ads_get_spell_check_v3_job",
+  method: "GET",
+  endpoint: "/api/spell-check/v3/{jobId}",
+  baseUrl: "https://ads.zalo.me",
+  binaryFields: [],
+  pathFields: ["jobId"],
+  queryFields: [],
+  headerFields: [],
+  cookieFields: [],
+  bodyFields: []
+};
 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);
   }
@@ -1684,10 +2226,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);
@@ -1699,7 +2250,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);
@@ -1729,7 +2289,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);
@@ -1773,6 +2337,62 @@ var ZaloCampaignsService = class {
   getSpellCheckV2(...args) {
     return this.getApiSpellCheckV2(...args);
   }
+  /**
+   * Khởi tạo tác vụ kiểm tra chính tả và vi phạm quy chuẩn quảng cáo AI V3 (POST /api/spell-check/v3).
+   */
+  createSpellCheckV3Job(request, options) {
+    return this.client.requestJson(
+      OP_ZaloAdsCreateSpellCheckV3Job,
+      this.client.toTransportInput(OP_ZaloAdsCreateSpellCheckV3Job, request),
+      options
+    );
+  }
+  /**
+   * Lấy kết quả kiểm tra chính tả AI V3 theo jobId (GET /api/spell-check/v3/{jobId}).
+   */
+  getSpellCheckV3Job(request, options) {
+    return this.client.requestWithoutBody(
+      OP_ZaloAdsGetSpellCheckV3Job,
+      this.client.toTransportInput(OP_ZaloAdsGetSpellCheckV3Job, request),
+      options
+    );
+  }
+  /**
+   * Helper kiểm tra chính tả AI V3 trọn gói: Gửi kiểm tra và tự động polling cho đến khi hoàn thành (hoặc timeout).
+   * @param request Tiêu đề (title) và chú thích (caption) cần kiểm tra.
+   * @param pollIntervalMs Chu kỳ polling kiểm tra trạng thái (mặc định: 600ms).
+   * @param timeoutMs Thời gian chờ tối đa (mặc định: 15.000ms = 15 giây).
+   */
+  async checkSpellV3AndWait(request, pollIntervalMs = 600, timeoutMs = 15e3, options) {
+    const jobRes = await this.createSpellCheckV3Job(request, options);
+    const jobId = jobRes?.data?.jobId;
+    if (!jobId) {
+      throw new Error(`[SpellCheckV3] Kh\xF4ng nh\u1EADn \u0111\u01B0\u1EE3c jobId t\u1EEB Zalo Ads (code: ${jobRes?.code})`);
+    }
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+      await new Promise((r) => setTimeout(r, pollIntervalMs));
+      const res = await this.getSpellCheckV3Job({ jobId }, options);
+      if (res?.data?.status === "COMPLETED") {
+        return res;
+      }
+    }
+    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
@@ -1927,6 +2547,365 @@ var ZaloAccountService = class {
   }
 };
 
+// src/validators/audiences.validator.ts
+function validateCreateSavedAudienceRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const name = typeof raw.name === "string" ? raw.name.trim() : "";
+  if (!name) {
+    errors.push("T\xEAn nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng 'name' l\xE0 b\u1EAFt bu\u1ED9c.");
+  } else if (name.length < 2 || name.length > 255) {
+    errors.push("T\xEAn nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng 'name' ph\u1EA3i t\u1EEB 2 \u0111\u1EBFn 255 k\xFD t\u1EF1.");
+  }
+  let targetingObj;
+  if (typeof raw.targeting === "string") {
+    try {
+      targetingObj = JSON.parse(raw.targeting);
+    } catch {
+      errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 chu\u1ED7i JSON kh\xF4ng h\u1EE3p l\u1EC7.");
+      targetingObj = {};
+    }
+  } else if (raw.targeting && typeof raw.targeting === "object") {
+    targetingObj = raw.targeting;
+  } else {
+    errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 b\u1EAFt bu\u1ED9c (chu\u1ED7i JSON ho\u1EB7c Object c\u1EA5u h\xECnh targeting).");
+    targetingObj = {};
+  }
+  const gender = typeof targetingObj.Gender === "number" ? targetingObj.Gender : 0;
+  if (![0, 1, 2].includes(gender)) {
+    errors.push("Tr\u01B0\u1EDDng 'Gender' ph\u1EA3i l\xE0 0 (T\u1EA5t c\u1EA3), 1 (Nam), ho\u1EB7c 2 (N\u1EEF).");
+  }
+  const VALID_AGE_RANGES = [10282, 10283, 10284, 10285, 10286, 10287, 10288];
+  const newAgeRanges = Array.isArray(targetingObj.NewAgeRanges) && targetingObj.NewAgeRanges.length > 0 ? targetingObj.NewAgeRanges.map(Number) : VALID_AGE_RANGES;
+  for (const age of newAgeRanges) {
+    if (!VALID_AGE_RANGES.includes(age)) {
+      errors.push(`M\xE3 \u0111\u1ED9 tu\u1ED5i '${age}' kh\xF4ng h\u1EE3p l\u1EC7. C\xE1c m\xE3 cho ph\xE9p: ${VALID_AGE_RANGES.join(", ")}.`);
+    }
+  }
+  const VALID_OS = [0, 1, 2, 3];
+  const os = Array.isArray(targetingObj.Os) && targetingObj.Os.length > 0 ? targetingObj.Os.map(Number) : [0, 1, 3];
+  for (const o of os) {
+    if (!VALID_OS.includes(o)) {
+      errors.push(`M\xE3 h\u1EC7 \u0111i\u1EC1u h\xE0nh '${o}' kh\xF4ng h\u1EE3p l\u1EC7 (0: Android, 1: iOS, 2: Windows Phone, 3: PC).`);
+    }
+  }
+  let location = targetingObj.Location;
+  if (!location || typeof location !== "object") {
+    location = {
+      Addresses: [],
+      Cities: [],
+      WardTargeting: { Includes: [], Excludes: [] }
+    };
+  } else {
+    location = {
+      Addresses: Array.isArray(location.Addresses) ? location.Addresses : [],
+      Cities: Array.isArray(location.Cities) ? location.Cities : [],
+      WardTargeting: location.WardTargeting && typeof location.WardTargeting === "object" ? location.WardTargeting : { Includes: [], Excludes: [] }
+    };
+    if (location.WardTargeting.Includes && !Array.isArray(location.WardTargeting.Includes)) {
+      errors.push("Tr\u01B0\u1EDDng 'Location.WardTargeting.Includes' ph\u1EA3i l\xE0 m\u1ED9t m\u1EA3ng khu v\u1EF1c.");
+    } else if (Array.isArray(location.WardTargeting.Includes)) {
+      for (const inc of location.WardTargeting.Includes) {
+        if (![1, 2, 3].includes(Number(inc.Id))) {
+          errors.push(`M\xE3 v\xF9ng mi\u1EC1n Id='${inc.Id}' kh\xF4ng h\u1EE3p l\u1EC7 (1: Mi\u1EC1n B\u1EAFc, 2: Mi\u1EC1n Trung, 3: Mi\u1EC1n Nam).`);
+        }
+        if (inc.Provinces && !Array.isArray(inc.Provinces)) {
+          errors.push(`Tr\u01B0\u1EDDng 'Provinces' trong v\xF9ng mi\u1EC1n Id=${inc.Id} ph\u1EA3i l\xE0 m\u1ED9t m\u1EA3ng t\u1EC9nh/th\xE0nh.`);
+        }
+      }
+    }
+  }
+  const finalTargeting = {
+    ...targetingObj,
+    CustomAudienceId: 0,
+    Gender: gender,
+    NewAgeRanges: newAgeRanges,
+    Os: os,
+    Location: location
+  };
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      name,
+      caType: 1,
+      targeting: JSON.stringify(finalTargeting)
+    } : void 0
+  };
+}
+function validateCreatePhoneAudienceRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const name = typeof raw.name === "string" ? raw.name.trim() : "";
+  if (!name || name.length < 2 || name.length > 255) {
+    errors.push("T\xEAn nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng 'name' ph\u1EA3i t\u1EEB 2 \u0111\u1EBFn 255 k\xFD t\u1EF1.");
+  }
+  let targetingObj = {};
+  if (typeof raw.targeting === "string") {
+    try {
+      targetingObj = JSON.parse(raw.targeting);
+    } catch {
+      errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 chu\u1ED7i JSON kh\xF4ng h\u1EE3p l\u1EC7.");
+    }
+  } else if (raw.targeting && typeof raw.targeting === "object") {
+    targetingObj = raw.targeting;
+  } else {
+    errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 b\u1EAFt bu\u1ED9c.");
+  }
+  const path = typeof targetingObj.Path === "string" ? targetingObj.Path.trim() : "";
+  if (!path) {
+    errors.push("Tr\u01B0\u1EDDng 'Path' (URL file .txt sau khi upload) l\xE0 b\u1EAFt bu\u1ED9c.");
+  }
+  const total = typeof targetingObj.Total === "number" ? targetingObj.Total : 0;
+  if (total <= 0) {
+    errors.push("Tr\u01B0\u1EDDng 'Total' (s\u1ED1 l\u01B0\u1EE3ng S\u0110T trong file) ph\u1EA3i l\u1EDBn h\u01A1n 0.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      name,
+      caType: 3,
+      targeting: JSON.stringify({
+        Name: String(targetingObj.Name || "phones.txt"),
+        Path: path,
+        Total: total,
+        ZaloId: Number(targetingObj.ZaloId || 0),
+        OriginAudience: 0
+      })
+    } : void 0
+  };
+}
+function validateCreateLookalikeAudienceRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const name = typeof raw.name === "string" ? raw.name.trim() : "";
+  if (!name || name.length < 2 || name.length > 255) {
+    errors.push("T\xEAn nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng 'name' ph\u1EA3i t\u1EEB 2 \u0111\u1EBFn 255 k\xFD t\u1EF1.");
+  }
+  let targetingObj = {};
+  if (typeof raw.targeting === "string") {
+    try {
+      targetingObj = JSON.parse(raw.targeting);
+    } catch {
+      errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 chu\u1ED7i JSON kh\xF4ng h\u1EE3p l\u1EC7.");
+    }
+  } else if (raw.targeting && typeof raw.targeting === "object") {
+    targetingObj = raw.targeting;
+  } else {
+    errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 b\u1EAFt bu\u1ED9c.");
+  }
+  const originAudience = Number(targetingObj.OriginAudience);
+  if (!originAudience || originAudience <= 0) {
+    errors.push("Tr\u01B0\u1EDDng 'OriginAudience' (ID nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng S\u0110T g\u1ED1c) l\xE0 b\u1EAFt bu\u1ED9c.");
+  }
+  const total = Number(targetingObj.Total);
+  if (![1e6, 15e5, 2e6].includes(total)) {
+    errors.push("Tr\u01B0\u1EDDng 'Total' c\u1EE7a Lookalike ch\u1EC9 ch\u1EA5p nh\u1EADn c\xE1c m\u1ED1c: 1.000.000, 1.500.000 ho\u1EB7c 2.000.000.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      name,
+      caType: 6,
+      targeting: JSON.stringify({
+        OriginAudience: originAudience,
+        Total: total,
+        Name: String(targetingObj.Name || "Lookalike Audience"),
+        Path: String(targetingObj.Path || "")
+      })
+    } : void 0
+  };
+}
+function validateCreateFormEventAudienceRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const name = typeof raw.name === "string" ? raw.name.trim() : "";
+  if (!name || name.length < 2 || name.length > 255) {
+    errors.push("T\xEAn nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng 'name' ph\u1EA3i t\u1EEB 2 \u0111\u1EBFn 255 k\xFD t\u1EF1.");
+  }
+  let targetingObj = {};
+  if (typeof raw.targeting === "string") {
+    try {
+      targetingObj = JSON.parse(raw.targeting);
+    } catch {
+      errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 chu\u1ED7i JSON kh\xF4ng h\u1EE3p l\u1EC7.");
+    }
+  } else if (raw.targeting && typeof raw.targeting === "object") {
+    targetingObj = raw.targeting;
+  }
+  const eventType = Number(targetingObj.EventType);
+  if (![1, 2, 3, 4].includes(eventType)) {
+    errors.push("Tr\u01B0\u1EDDng 'EventType' ph\u1EA3i l\xE0 1 (\u0110\xE3 xem ch\u01B0a g\u1EEDi), 2 (\u0110\xE3 xem & g\u1EEDi), 3 (\u0110\xE3 xem), ho\u1EB7c 4 (M\u1EDF chat t\u1EEB Form).");
+  }
+  const oaId = typeof targetingObj.OaId === "string" ? targetingObj.OaId.trim() : String(targetingObj.OaId || "");
+  if (!oaId) {
+    errors.push("Tr\u01B0\u1EDDng 'OaId' (d\u1EA1ng chu\u1ED7i c\u1EE7a pageId ho\u1EB7c noisedId) l\xE0 b\u1EAFt bu\u1ED9c.");
+  }
+  const numDays = Number(targetingObj.NumDays);
+  if (isNaN(numDays) || numDays < 1 || numDays > 90) {
+    errors.push("Tr\u01B0\u1EDDng 'NumDays' ph\u1EA3i n\u1EB1m trong kho\u1EA3ng t\u1EEB 1 \u0111\u1EBFn 90 ng\xE0y.");
+  }
+  const formIds = Array.isArray(targetingObj.FormIds) ? targetingObj.FormIds : [];
+  if (formIds.length === 0) {
+    errors.push("Tr\u01B0\u1EDDng 'FormIds' ph\u1EA3i ch\u1EE9a \xEDt nh\u1EA5t 1 ID Form.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      name,
+      caType: 12,
+      targeting: JSON.stringify({
+        EventType: eventType,
+        OaId: oaId,
+        NumDays: numDays,
+        FormIds: formIds
+      })
+    } : void 0
+  };
+}
+function validateCreateMessageOaEventAudienceRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const name = typeof raw.name === "string" ? raw.name.trim() : "";
+  if (!name || name.length < 2 || name.length > 255) {
+    errors.push("T\xEAn nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng 'name' ph\u1EA3i t\u1EEB 2 \u0111\u1EBFn 255 k\xFD t\u1EF1.");
+  }
+  let targetingObj = {};
+  if (typeof raw.targeting === "string") {
+    try {
+      targetingObj = JSON.parse(raw.targeting);
+    } catch {
+      errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 chu\u1ED7i JSON kh\xF4ng h\u1EE3p l\u1EC7.");
+    }
+  } else if (raw.targeting && typeof raw.targeting === "object") {
+    targetingObj = raw.targeting;
+  }
+  const eventId = Number(targetingObj.EventId ?? targetingObj.EventType ?? 1);
+  const oaId = typeof targetingObj.OaId === "string" ? targetingObj.OaId.trim() : String(targetingObj.OaId || "");
+  if (!oaId) {
+    errors.push("Tr\u01B0\u1EDDng 'OaId' (chu\u1ED7i pageId ho\u1EB7c noisedId c\u1EE7a OA) l\xE0 b\u1EAFt bu\u1ED9c.");
+  }
+  const numDays = Number(targetingObj.NumDays);
+  if (isNaN(numDays) || numDays < 1 || numDays > 90) {
+    errors.push("Tr\u01B0\u1EDDng 'NumDays' ph\u1EA3i n\u1EB1m trong kho\u1EA3ng t\u1EEB 1 \u0111\u1EBFn 90 ng\xE0y.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      name,
+      caType: 11,
+      targeting: JSON.stringify({
+        EventId: eventId,
+        OaId: oaId,
+        NumDays: numDays
+      })
+    } : void 0
+  };
+}
+function validateCreateMessagePersonalEventAudienceRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const name = typeof raw.name === "string" ? raw.name.trim() : "";
+  if (!name || name.length < 2 || name.length > 255) {
+    errors.push("T\xEAn nh\xF3m \u0111\u1ED1i t\u01B0\u1EE3ng 'name' ph\u1EA3i t\u1EEB 2 \u0111\u1EBFn 255 k\xFD t\u1EF1.");
+  }
+  let targetingObj = {};
+  if (typeof raw.targeting === "string") {
+    try {
+      targetingObj = JSON.parse(raw.targeting);
+    } catch {
+      errors.push("Tr\u01B0\u1EDDng 'targeting' l\xE0 chu\u1ED7i JSON kh\xF4ng h\u1EE3p l\u1EC7.");
+    }
+  } else if (raw.targeting && typeof raw.targeting === "object") {
+    targetingObj = raw.targeting;
+  }
+  const eventId = Number(targetingObj.EventId ?? targetingObj.EventType ?? 1);
+  if (![1, 2, 3].includes(eventId)) {
+    errors.push("Tr\u01B0\u1EDDng 'EventId' ph\u1EA3i l\xE0 1 (\u0110\xE3 li\xEAn h\u1EC7), 2 (\u0110\xE3 xem kh\xF4ng li\xEAn h\u1EC7), ho\u1EB7c 3 (Xem carousel kh\xF4ng li\xEAn h\u1EC7).");
+  }
+  const numDays = Number(targetingObj.NumDays);
+  if (isNaN(numDays) || numDays < 1 || numDays > 90) {
+    errors.push("Tr\u01B0\u1EDDng 'NumDays' ph\u1EA3i n\u1EB1m trong kho\u1EA3ng t\u1EEB 1 \u0111\u1EBFn 90 ng\xE0y.");
+  }
+  const pageIds = Array.isArray(targetingObj.PageIds) ? targetingObj.PageIds.map(String) : [];
+  if (pageIds.length === 0) {
+    errors.push("Tr\u01B0\u1EDDng 'PageIds' ph\u1EA3i ch\u1EE9a \xEDt nh\u1EA5t 1 ID trang c\xE1 nh\xE2n.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      name,
+      caType: 14,
+      targeting: JSON.stringify({
+        EventId: eventId,
+        NumDays: numDays,
+        PageIds: pageIds
+      })
+    } : void 0
+  };
+}
+function validateEstimateAudienceRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const gender = typeof raw.gender === "number" ? raw.gender : 0;
+  if (![0, 1, 2].includes(gender)) {
+    errors.push("Tr\u01B0\u1EDDng 'gender' ph\u1EA3i l\xE0 0, 1 ho\u1EB7c 2.");
+  }
+  const ageRanges = Array.isArray(raw.ageRanges) && raw.ageRanges.length > 0 ? raw.ageRanges.map(Number) : [10283, 10284, 10285, 10286, 10287];
+  const platforms = Array.isArray(raw.platforms) && raw.platforms.length > 0 ? raw.platforms.map(Number) : [0, 1, 3];
+  const priceType = typeof raw.priceType === "number" ? raw.priceType : 2;
+  const wardsTargeting = typeof raw.wardsTargeting === "string" && raw.wardsTargeting.trim() ? raw.wardsTargeting.trim() : JSON.stringify({ Includes: [], Excludes: [] });
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      gender,
+      ageRanges,
+      platforms,
+      locations: typeof raw.locations === "string" ? raw.locations : "",
+      provinces: Array.isArray(raw.provinces) ? raw.provinces.map(Number) : [],
+      wardsTargeting,
+      priceType,
+      number: typeof raw.number === "string" ? raw.number : String(raw.number || "0")
+    } : void 0
+  };
+}
+var ZaloAudiencesValidator = {
+  createSavedAudience: validateCreateSavedAudienceRequest,
+  createPhoneAudience: validateCreatePhoneAudienceRequest,
+  createLookalikeAudience: validateCreateLookalikeAudienceRequest,
+  createFormEventAudience: validateCreateFormEventAudienceRequest,
+  createMessageOaEventAudience: validateCreateMessageOaEventAudienceRequest,
+  createMessagePersonalEventAudience: validateCreateMessagePersonalEventAudienceRequest,
+  estimateAudience: validateEstimateAudienceRequest
+};
+
 // src/services/audiences.service.ts
 var OP_ZaloAdsCreateCustomAudience = {
   "operationId": "ZaloAds_createCustomAudience",
@@ -2027,6 +3006,7 @@ var ZaloAudiencesService = class {
   constructor(client) {
     this.client = client;
   }
+  static validator = ZaloAudiencesValidator;
   postApiAdEstimateaudience(request, options) {
     return this.client.requestJson(OP_ZaloAdsPostApiAdEstimateaudience, this.client.toTransportInput(OP_ZaloAdsPostApiAdEstimateaudience, request), options);
   }
@@ -2079,7 +3059,22 @@ var ZaloAudiencesService = class {
   }
   /** Tạo mới Nhóm đối tượng phát sinh sự kiện trên Kịch bản Tin nhắn cá nhân (`caType = 14` - `MESSAGE_PERSONAL_EVENT_AUDIENCE`). */
   createMessagePersonalEventAudience(request, options) {
-    const targetingStr = typeof request.targeting === "string" ? request.targeting : JSON.stringify(request.targeting);
+    let targetingObj;
+    if (typeof request.targeting === "string") {
+      try {
+        targetingObj = JSON.parse(request.targeting);
+      } catch {
+        targetingObj = null;
+      }
+    } else if (request.targeting && typeof request.targeting === "object") {
+      targetingObj = { ...request.targeting };
+    }
+    if (targetingObj && typeof targetingObj === "object") {
+      if (targetingObj.EventId === void 0 && targetingObj.EventType !== void 0) {
+        targetingObj.EventId = targetingObj.EventType;
+      }
+    }
+    const targetingStr = targetingObj ? JSON.stringify(targetingObj) : typeof request.targeting === "string" ? request.targeting : JSON.stringify(request.targeting);
     return this.createCustomAudience({ name: request.name, caType: 14, targeting: targetingStr }, options);
   }
   /** Tạo mới Nhóm đối tượng từ Trung tâm Lead - Zalo Form (`caType = 10` - `FORM_AUDIENCE`). */
@@ -2299,6 +3294,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;
@@ -2361,6 +3375,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
@@ -2627,12 +3653,242 @@ var ZaloAutomatedRulesService = class {
   changeAutomatedRuleStatus(request, options) {
     return this.client.requestJson(OP_ZaloAdsChangeAutomatedRuleStatus, this.client.toTransportInput(OP_ZaloAdsChangeAutomatedRuleStatus, request), options);
   }
-  getAutomatedRuleHistory(request, options) {
-    return this.client.requestWithoutBody(OP_ZaloAdsGetAutomatedRuleHistory, this.client.toTransportInput(OP_ZaloAdsGetAutomatedRuleHistory, request), options);
+  getAutomatedRuleHistory(request, options) {
+    return this.client.requestWithoutBody(OP_ZaloAdsGetAutomatedRuleHistory, this.client.toTransportInput(OP_ZaloAdsGetAutomatedRuleHistory, request), options);
+  }
+  deleteAutomatedRule(request, options) {
+    return this.client.requestJson(OP_ZaloAdsDeleteAutomatedRule, this.client.toTransportInput(OP_ZaloAdsDeleteAutomatedRule, request), options);
+  }
+};
+
+// src/validators/flows.validator.ts
+var MAX_INT_32 = 2147483647;
+function is32BitPositiveInteger(val) {
+  if (typeof val === "number") {
+    return Number.isInteger(val) && val > 0 && val <= MAX_INT_32;
+  }
+  if (typeof val === "string" && val.trim() !== "") {
+    const num = Number(val);
+    return Number.isInteger(num) && num > 0 && num <= MAX_INT_32;
+  }
+  return false;
+}
+function isPositiveInteger(val) {
+  if (typeof val === "number") return Number.isInteger(val) && val > 0;
+  if (typeof val === "string" && val.trim() !== "") {
+    const num = Number(val);
+    return Number.isInteger(num) && num > 0;
+  }
+  return false;
+}
+function isNonNegativeInteger(val) {
+  if (typeof val === "number") return Number.isInteger(val) && val >= 0;
+  if (typeof val === "string" && val.trim() !== "") {
+    const num = Number(val);
+    return Number.isInteger(num) && num >= 0;
+  }
+  return false;
+}
+function toPositiveInteger(val) {
+  return typeof val === "number" ? Math.floor(val) : parseInt(String(val), 10);
+}
+function validateFlowButtons(buttons, errors, prefix) {
+  if (!Array.isArray(buttons)) {
+    errors.push(`${prefix}: Tr\u01B0\u1EDDng 'buttons' ph\u1EA3i l\xE0 m\u1ED9t m\u1EA3ng.`);
+    return [];
+  }
+  const cleanButtons = [];
+  buttons.forEach((btn, idx) => {
+    const btnPrefix = `${prefix}.buttons[${idx}]`;
+    if (!btn || typeof btn !== "object") {
+      errors.push(`${btnPrefix}: N\xFAt b\u1EA5m ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng.`);
+      return;
+    }
+    const b = btn;
+    if (typeof b.text !== "string" || b.text.trim() === "") {
+      errors.push(`${btnPrefix}: Nh\xE3n n\xFAt 'text' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.`);
+    }
+    const btnType = Number(b.type);
+    if (![3, 10, 12].includes(btnType)) {
+      errors.push(`${btnPrefix}: Lo\u1EA1i n\xFAt 'type' ph\u1EA3i l\xE0 3 (nh\xE1nh h\u1ED9i tho\u1EA1i), 10 (m\u1EDF website), ho\u1EB7c 12 (g\u1ECDi hotline).`);
+    }
+    const cleanBtn = {
+      type: btnType,
+      text: String(b.text ?? "").trim(),
+      editable: b.editable !== false
+    };
+    if (btnType === 10) {
+      if (typeof b.url !== "string" || b.url.trim() === "") {
+        errors.push(`${btnPrefix}: N\xFAt lo\u1EA1i 10 (m\u1EDF website) b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 tr\u01B0\u1EDDng 'url' h\u1EE3p l\u1EC7.`);
+      } else {
+        cleanBtn.url = b.url.trim();
+      }
+    } else if (btnType === 12) {
+      if (typeof b.phone !== "string" || b.phone.trim() === "") {
+        errors.push(`${btnPrefix}: N\xFAt lo\u1EA1i 12 (g\u1ECDi hotline) b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 tr\u01B0\u1EDDng 'phone' h\u1EE3p l\u1EC7.`);
+      } else {
+        cleanBtn.phone = b.phone.trim();
+      }
+    } else if (btnType === 3) {
+      if (!Array.isArray(b.messages) || b.messages.length === 0) {
+        errors.push(`${btnPrefix}: N\xFAt lo\u1EA1i 3 (nh\xE1nh h\u1ED9i tho\u1EA1i) b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 m\u1EA3ng 'messages' ch\u1EE9a \xEDt nh\u1EA5t 1 tin nh\u1EAFn con ph\u1EA3n h\u1ED3i.`);
+      } else {
+        const cleanChildMsgs = [];
+        b.messages.forEach((child, cIdx) => {
+          const childPrefix = `${btnPrefix}.messages[${cIdx}]`;
+          if (!child || typeof child !== "object") {
+            errors.push(`${childPrefix}: Tin nh\u1EAFn con ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng.`);
+            return;
+          }
+          const c = child;
+          if (typeof c.text !== "string" || c.text.trim() === "") {
+            errors.push(`${childPrefix}: N\u1ED9i dung tin nh\u1EAFn con 'text' kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.`);
+          } else if (c.text.length > 1961) {
+            errors.push(`${childPrefix}: N\u1ED9i dung tin nh\u1EAFn con v\u01B0\u1EE3t qu\xE1 1961 k\xFD t\u1EF1 (hi\u1EC7n c\xF3 ${c.text.length} k\xFD t\u1EF1).`);
+          }
+          cleanChildMsgs.push({
+            type: 8,
+            text: String(c.text ?? "").trim()
+          });
+        });
+        cleanBtn.messages = cleanChildMsgs;
+      }
+    }
+    cleanButtons.push(cleanBtn);
+  });
+  return cleanButtons;
+}
+function validateFlowMessages(messages, errors) {
+  if (!Array.isArray(messages)) {
+    errors.push("Tr\u01B0\u1EDDng 'messages' ph\u1EA3i l\xE0 m\u1ED9t m\u1EA3ng ch\u1EE9a tin nh\u1EAFn k\u1ECBch b\u1EA3n.");
+    return [];
+  }
+  if (messages.length !== 1) {
+    errors.push(`Zalo Ads ch\u1EC9 cho ph\xE9p k\u1ECBch b\u1EA3n ch\u1EE9a DUY NH\u1EA4T 1 tin nh\u1EAFn ch\xE0o m\u1EEBng c\u1EA5p cao (hi\u1EC7n c\xF3 ${messages.length} tin nh\u1EAFn). C\xE1c nh\xE1nh h\u1ED9i tho\u1EA1i ti\u1EBFp theo ph\u1EA3i c\u1EA5u h\xECnh b\xEAn trong n\xFAt b\u1EA5m lo\u1EA1i 3 (type=3).`);
+    return [];
+  }
+  const msg = messages[0];
+  if (!msg || typeof msg !== "object") {
+    errors.push("Tin nh\u1EAFn k\u1ECBch b\u1EA3n ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng.");
+    return [];
+  }
+  const m = msg;
+  const msgType = Number(m.type);
+  if (![1, 2].includes(msgType)) {
+    errors.push("Lo\u1EA1i tin nh\u1EAFn 'type' ph\u1EA3i l\xE0 1 (v\u0103n b\u1EA3n) ho\u1EB7c 2 (k\xE8m h\xECnh \u1EA3nh).");
+  }
+  if (typeof m.text !== "string" || m.text.trim() === "") {
+    errors.push("N\u1ED9i dung tin nh\u1EAFn 'text' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.");
+  } else if (m.text.length > 1961) {
+    errors.push(`N\u1ED9i dung tin nh\u1EAFn v\u01B0\u1EE3t qu\xE1 1961 k\xFD t\u1EF1 (hi\u1EC7n c\xF3 ${m.text.length} k\xFD t\u1EF1).`);
+  }
+  const cleanMsg = {
+    type: msgType,
+    text: String(m.text ?? "").trim()
+  };
+  if (msgType === 2) {
+    if (typeof m.url !== "string" || m.url.trim() === "") {
+      errors.push("Tin nh\u1EAFn lo\u1EA1i 2 (k\xE8m \u1EA3nh) b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 tr\u01B0\u1EDDng 'url' ch\u1EE9a \u0111\u01B0\u1EDDng d\u1EABn h\xECnh \u1EA3nh.");
+    } else {
+      cleanMsg.url = m.url.trim();
+    }
+  }
+  if (m.buttons !== void 0 && m.buttons !== null) {
+    cleanMsg.buttons = validateFlowButtons(m.buttons, errors, "messages[0]");
+  }
+  return [cleanMsg];
+}
+function validateListFlowsByOfficialAccountRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u l\u1EA5y danh s\xE1ch k\u1ECBch b\u1EA3n ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng."] };
+  }
+  const obj = input;
+  if (!is32BitPositiveInteger(obj.oaId)) {
+    errors.push("Tr\u01B0\u1EDDng 'oaId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 m\xE3 pageId n\u1ED9i b\u1ED9 ki\u1EC3u s\u1ED1 nguy\xEAn 32-bit (<= 2,147,483,647). Kh\xF4ng truy\u1EC1n chu\u1ED7i noisedId c\xF4ng khai (18 ch\u1EEF s\u1ED1) v\xEC backend Play Framework s\u1EBD t\u1EEB ch\u1ED1i.");
+  }
+  if (!isPositiveInteger(obj.limit)) {
+    errors.push("Tr\u01B0\u1EDDng 'limit' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
+  }
+  if (obj.offset !== void 0 && obj.offset !== null && !isNonNegativeInteger(obj.offset)) {
+    errors.push("Tr\u01B0\u1EDDng 'offset' n\u1EBFu c\xF3 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn kh\xF4ng \xE2m (>= 0).");
+  }
+  if (obj.flowId !== void 0 && obj.flowId !== null && !isPositiveInteger(obj.flowId)) {
+    errors.push("Tr\u01B0\u1EDDng 'flowId' n\u1EBFu c\xF3 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
+  }
+  const cleanData = {
+    oaId: toPositiveInteger(obj.oaId),
+    limit: toPositiveInteger(obj.limit)
+  };
+  if (obj.offset !== void 0 && obj.offset !== null) cleanData.offset = toPositiveInteger(obj.offset);
+  if (obj.flowId !== void 0 && obj.flowId !== null) cleanData.flowId = toPositiveInteger(obj.flowId);
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? cleanData : void 0
+  };
+}
+function validateCreateFlowRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u t\u1EA1o k\u1ECBch b\u1EA3n ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng."] };
   }
-  deleteAutomatedRule(request, options) {
-    return this.client.requestJson(OP_ZaloAdsDeleteAutomatedRule, this.client.toTransportInput(OP_ZaloAdsDeleteAutomatedRule, request), options);
+  const obj = input;
+  if (!is32BitPositiveInteger(obj.oaId)) {
+    errors.push("Tr\u01B0\u1EDDng 'oaId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 m\xE3 pageId n\u1ED9i b\u1ED9 ki\u1EC3u s\u1ED1 nguy\xEAn 32-bit (<= 2,147,483,647).");
+  }
+  if (typeof obj.name !== "string" || obj.name.trim() === "") {
+    errors.push("Tr\u01B0\u1EDDng 'name' (t\xEAn k\u1ECBch b\u1EA3n) l\xE0 b\u1EAFt bu\u1ED9c v\xE0 kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.");
+  } else if (obj.name.trim().length > 50) {
+    errors.push(`T\xEAn k\u1ECBch b\u1EA3n kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 50 k\xFD t\u1EF1 (hi\u1EC7n c\xF3 ${obj.name.trim().length} k\xFD t\u1EF1).`);
+  }
+  const cleanMessages = validateFlowMessages(obj.messages, errors);
+  const cleanData = {
+    oaId: toPositiveInteger(obj.oaId),
+    id: null,
+    name: String(obj.name ?? "").trim(),
+    messages: cleanMessages
+  };
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? cleanData : void 0
+  };
+}
+function validateUpdateFlowRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u c\u1EADp nh\u1EADt k\u1ECBch b\u1EA3n ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng."] };
   }
+  const obj = input;
+  if (!isPositiveInteger(obj.id)) {
+    errors.push("Tr\u01B0\u1EDDng 'id' (ID Flow c\u1EA7n c\u1EADp nh\u1EADt) l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
+  }
+  if (!is32BitPositiveInteger(obj.oaId)) {
+    errors.push("Tr\u01B0\u1EDDng 'oaId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 m\xE3 pageId n\u1ED9i b\u1ED9 ki\u1EC3u s\u1ED1 nguy\xEAn 32-bit (<= 2,147,483,647).");
+  }
+  if (typeof obj.name !== "string" || obj.name.trim() === "") {
+    errors.push("Tr\u01B0\u1EDDng 'name' (t\xEAn k\u1ECBch b\u1EA3n) l\xE0 b\u1EAFt bu\u1ED9c v\xE0 kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng.");
+  } else if (obj.name.trim().length > 50) {
+    errors.push(`T\xEAn k\u1ECBch b\u1EA3n kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 50 k\xFD t\u1EF1 (hi\u1EC7n c\xF3 ${obj.name.trim().length} k\xFD t\u1EF1).`);
+  }
+  const cleanMessages = validateFlowMessages(obj.messages, errors);
+  const cleanData = {
+    id: toPositiveInteger(obj.id),
+    oaId: toPositiveInteger(obj.oaId),
+    name: String(obj.name ?? "").trim(),
+    messages: cleanMessages
+  };
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? cleanData : void 0
+  };
+}
+var ZaloFlowsValidator = {
+  listFlowsByOfficialAccount: validateListFlowsByOfficialAccountRequest,
+  createFlow: validateCreateFlowRequest,
+  updateFlow: validateUpdateFlowRequest
 };
 
 // src/services/flows.service.ts
@@ -2676,6 +3932,12 @@ var ZaloFlowsService = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Bộ công cụ kiểm tra tính hợp lệ dữ liệu (Standalone Validators) cho Message Flows APIs.
+   * Dùng để validate dữ liệu đầu vào trước khi lưu DB hoặc gọi Zalo Ads.
+   */
+  static validator = ZaloFlowsValidator;
+  validator = ZaloFlowsValidator;
   listFlowsByOfficialAccount(request, options) {
     return this.client.requestWithoutBody(OP_ZaloAdsListFlowsByOfficialAccount, this.client.toTransportInput(OP_ZaloAdsListFlowsByOfficialAccount, request), options);
   }
@@ -3589,7 +4851,301 @@ var ZaloChatWidgetService = class {
   }
 };
 
+// src/validators/forms.validator.ts
+function isValidUrl(val) {
+  if (typeof val !== "string" || val.trim() === "") return false;
+  try {
+    const url = new URL(val);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function validateCreateFormRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return {
+      isValid: false,
+      errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u t\u1EA1o Form ph\u1EA3i l\xE0 m\u1ED9t object."],
+      data: void 0
+    };
+  }
+  let raw = input;
+  if (typeof input.data === "string") {
+    try {
+      raw = JSON.parse(input.data);
+    } catch {
+      errors.push("Tr\u01B0\u1EDDng 'data' kh\xF4ng ph\u1EA3i l\xE0 chu\u1ED7i JSON h\u1EE3p l\u1EC7.");
+      return { isValid: false, errors, data: void 0 };
+    }
+  } else if (typeof input.data === "object" && input.data !== null) {
+    raw = input.data;
+  }
+  const oaIdRaw = raw.oaId;
+  let cleanOaId = "";
+  if (typeof oaIdRaw === "string" && /^[0-9]+$/.test(oaIdRaw.trim())) {
+    cleanOaId = oaIdRaw.trim();
+  } else if (typeof oaIdRaw === "number" && Number.isInteger(oaIdRaw) && oaIdRaw > 0) {
+    cleanOaId = String(oaIdRaw);
+  } else {
+    errors.push("Tr\u01B0\u1EDDng 'oaId' b\u1EAFt bu\u1ED9c ph\u1EA3i l\xE0 chu\u1ED7i s\u1ED1 nguy\xEAn d\u01B0\u01A1ng \u0111\u1EA1i di\u1EC7n cho pageId n\u1ED9i b\u1ED9 c\u1EE7a OA (v\xED d\u1EE5: '429753475').");
+  }
+  const title = typeof raw.title === "string" ? raw.title.trim() : "";
+  if (!title) {
+    errors.push("Tr\u01B0\u1EDDng 'title' (ti\xEAu \u0111\u1EC1 form) l\xE0 b\u1EAFt bu\u1ED9c.");
+  } else if (title.length < 2 || title.length > 40) {
+    errors.push(`Tr\u01B0\u1EDDng 'title' ph\u1EA3i c\xF3 \u0111\u1ED9 d\xE0i t\u1EEB 2 \u0111\u1EBFn 40 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${title.length} k\xFD t\u1EF1).`);
+  }
+  const formName = typeof raw.formName === "string" ? raw.formName.trim() : "";
+  if (!formName) {
+    errors.push("Tr\u01B0\u1EDDng 'formName' (t\xEAn qu\u1EA3n tr\u1ECB form) l\xE0 b\u1EAFt bu\u1ED9c.");
+  } else if (formName.length < 2 || formName.length > 100) {
+    errors.push(`Tr\u01B0\u1EDDng 'formName' ph\u1EA3i c\xF3 \u0111\u1ED9 d\xE0i t\u1EEB 2 \u0111\u1EBFn 100 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${formName.length} k\xFD t\u1EF1).`);
+  }
+  let cleanDescription = void 0;
+  if (raw.description !== void 0 && raw.description !== null) {
+    const desc = String(raw.description).trim();
+    if (desc.length > 600) {
+      errors.push(`Tr\u01B0\u1EDDng 'description' kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 600 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${desc.length} k\xFD t\u1EF1).`);
+    } else {
+      cleanDescription = desc;
+    }
+  }
+  const coverPhoto = typeof raw.coverPhoto === "string" ? raw.coverPhoto.trim() : "";
+  if (!coverPhoto) {
+    errors.push("Tr\u01B0\u1EDDng 'coverPhoto' (\u1EA3nh b\xECa form) l\xE0 b\u1EAFt bu\u1ED9c.");
+  } else if (!isValidUrl(coverPhoto)) {
+    errors.push(`Tr\u01B0\u1EDDng 'coverPhoto' ph\u1EA3i l\xE0 URL h\u1EE3p l\u1EC7 (http:// ho\u1EB7c https://).`);
+  }
+  const submitTitle = typeof raw.submitTitle === "string" && raw.submitTitle.trim() !== "" ? raw.submitTitle.trim() : "G\u1EEDi th\xF4ng tin th\xE0nh c\xF4ng";
+  if (submitTitle.length > 90) {
+    errors.push(`Tr\u01B0\u1EDDng 'submitTitle' kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 90 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${submitTitle.length} k\xFD t\u1EF1).`);
+  }
+  const thanks = typeof raw.thanks === "string" && raw.thanks.trim() !== "" ? raw.thanks.trim() : "C\u1EA3m \u01A1n b\u1EA1n \u0111\xE3 g\u1EEDi th\xF4ng tin. Ch\xFAng t\xF4i s\u1EBD li\xEAn h\u1EC7 trong th\u1EDDi gian s\u1EDBm nh\u1EA5t.";
+  if (thanks.length > 255) {
+    errors.push(`Tr\u01B0\u1EDDng 'thanks' kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${thanks.length} k\xFD t\u1EF1).`);
+  }
+  const gotoActionType = raw.gotoActionType === 0 ? 0 : 1;
+  const gotoText = typeof raw.gotoText === "string" && raw.gotoText.trim() !== "" ? raw.gotoText.trim() : gotoActionType === 1 ? "Xem trang Web" : "\u0110\xF3ng l\u1EA1i";
+  let cleanWebsite = void 0;
+  if (gotoActionType === 1) {
+    if (!raw.website || !isValidUrl(raw.website)) {
+      errors.push("Khi 'gotoActionType' = 1 (m\u1EDF website), tr\u01B0\u1EDDng 'website' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 URL h\u1EE3p l\u1EC7.");
+    } else {
+      cleanWebsite = String(raw.website).trim();
+    }
+  }
+  const useCustomConsent = Boolean(raw.useCustomConsent);
+  let cleanConsentName = void 0;
+  let cleanConsentUrl = void 0;
+  if (useCustomConsent) {
+    const cName = typeof raw.consentName === "string" ? raw.consentName.trim() : "";
+    if (!cName) {
+      errors.push("Khi 'useCustomConsent' = true, tr\u01B0\u1EDDng 'consentName' (ti\xEAu \u0111\u1EC1 \u0111i\u1EC1u kho\u1EA3n) l\xE0 b\u1EAFt bu\u1ED9c.");
+    } else if (cName.length > 255) {
+      errors.push(`Tr\u01B0\u1EDDng 'consentName' kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1 (hi\u1EC7n t\u1EA1i: ${cName.length} k\xFD t\u1EF1).`);
+    } else {
+      cleanConsentName = cName;
+    }
+    if (!raw.consentUrl || !isValidUrl(raw.consentUrl)) {
+      errors.push("Khi 'useCustomConsent' = true, tr\u01B0\u1EDDng 'consentUrl' ph\u1EA3i l\xE0 URL h\u1EE3p l\u1EC7 ch\u1EE9a ch\xEDnh s\xE1ch b\u1EA3o m\u1EADt.");
+    } else {
+      cleanConsentUrl = String(raw.consentUrl).trim();
+    }
+  }
+  if (!Array.isArray(raw.questions) || raw.questions.length === 0) {
+    errors.push("Bi\u1EC3u m\u1EABu b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 \xEDt nh\u1EA5t 1 c\xE2u h\u1ECFi trong m\u1EA3ng 'questions'.");
+  }
+  const cleanQuestions = [];
+  let hasPhonePrimary = false;
+  let hasPhoneSecondary = false;
+  if (Array.isArray(raw.questions)) {
+    raw.questions.forEach((q, idx) => {
+      const qPrefix = `C\xE2u h\u1ECFi [${idx}]`;
+      if (!q || typeof q !== "object") {
+        errors.push(`${qPrefix} ph\u1EA3i l\xE0 m\u1ED9t object.`);
+        return;
+      }
+      const qTitle = typeof q.title === "string" ? q.title.trim() : "";
+      if (qTitle.length < 2 || qTitle.length > 180) {
+        errors.push(`${qPrefix}: Ti\xEAu \u0111\u1EC1 'title' ph\u1EA3i c\xF3 \u0111\u1ED9 d\xE0i t\u1EEB 2 \u0111\u1EBFn 180 k\xFD t\u1EF1.`);
+      }
+      if (!Array.isArray(q.answers) || q.answers.length === 0) {
+        errors.push(`${qPrefix}: Ph\u1EA3i c\xF3 \xEDt nh\u1EA5t 1 \u0111\xE1p \xE1n trong m\u1EA3ng 'answers'.`);
+        return;
+      }
+      const cleanAnswers = [];
+      q.answers.forEach((ans, aIdx) => {
+        const aType = Number(ans?.type);
+        if (![2, 7, 13].includes(aType)) {
+          errors.push(`${qPrefix} \u0111\xE1p \xE1n [${aIdx}]: 'type' ph\u1EA3i l\xE0 7 (H\u1ECD t\xEAn), 13 (S\u0110T chu\u1EA9n), ho\u1EB7c 2 (S\u0110T ph\u1EE5).`);
+        }
+        if (aType === 13) hasPhonePrimary = true;
+        if (aType === 2) hasPhoneSecondary = true;
+        cleanAnswers.push({
+          type: aType,
+          placeHolder: ans?.placeHolder ? String(ans.placeHolder).trim() : void 0,
+          value: ans?.value ? String(ans.value).trim() : null,
+          priority: typeof ans?.priority === "number" ? ans.priority : 500
+        });
+      });
+      cleanQuestions.push({
+        title: qTitle,
+        type: typeof q.type === "number" ? q.type : 1,
+        isRequired: q.isRequired !== void 0 ? Boolean(q.isRequired) : true,
+        editDisabled: Boolean(q.editDisabled),
+        priority: typeof q.priority === "number" ? q.priority : (idx + 1) * 100,
+        answers: cleanAnswers
+      });
+    });
+  }
+  if (hasPhoneSecondary) {
+    cleanQuestions.forEach((q) => {
+      if (q.answers.some((a) => a.type === 13)) {
+        q.editDisabled = true;
+      }
+    });
+  }
+  const cleanSections = [];
+  if (Array.isArray(raw.sections)) {
+    raw.sections.forEach((sec, sIdx) => {
+      const sPrefix = `Section [${sIdx}]`;
+      const sType = Number(sec?.type);
+      if (isNaN(sType) || sType < 0 || sType > 4) {
+        errors.push(`${sPrefix}: 'type' ph\u1EA3i l\xE0 s\u1ED1 t\u1EEB 0 \u0111\u1EBFn 4 (0=t\u1ED5ng quan, 1=chi ti\u1EBFt, 2=b\u1EA3ng gi\xE1, 3=\u01B0u \u0111i\u1EC3m, 4=\u01B0u \u0111\xE3i).`);
+      }
+      const sTitle = typeof sec?.title === "string" ? sec.title.trim() : "";
+      if (sTitle.length > 60) {
+        errors.push(`${sPrefix}: 'title' kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 60 k\xFD t\u1EF1.`);
+      }
+      cleanSections.push({
+        type: sType,
+        title: sTitle,
+        disable: Boolean(sec?.disable),
+        expand: Boolean(sec?.expand),
+        content: sec?.content ? sec.content : {}
+      });
+    });
+  }
+  const cleanData = {
+    oaId: cleanOaId,
+    title,
+    formName,
+    description: cleanDescription,
+    coverPhoto,
+    submitTitle,
+    thanks,
+    gotoActionType,
+    gotoText,
+    website: cleanWebsite,
+    reviewSubmit: raw.reviewSubmit !== void 0 ? Boolean(raw.reviewSubmit) : true,
+    questions: cleanQuestions,
+    sections: cleanSections.length > 0 ? cleanSections : void 0,
+    useCustomConsent,
+    consentName: cleanConsentName,
+    consentUrl: cleanConsentUrl
+  };
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? cleanData : void 0
+  };
+}
+function validateListFormsByOfficialAccountRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  let cleanOaId = "";
+  if (typeof raw.oaId === "string" && /^[0-9]+$/.test(raw.oaId.trim())) {
+    cleanOaId = raw.oaId.trim();
+  } else if (typeof raw.oaId === "number" && Number.isInteger(raw.oaId) && raw.oaId > 0) {
+    cleanOaId = String(raw.oaId);
+  } else {
+    errors.push("Tr\u01B0\u1EDDng 'oaId' b\u1EAFt bu\u1ED9c ph\u1EA3i l\xE0 chu\u1ED7i s\u1ED1 nguy\xEAn d\u01B0\u01A1ng \u0111\u1EA1i di\u1EC7n cho pageId c\u1EE7a OA.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? { oaId: cleanOaId, isAll: raw.isAll !== void 0 ? Boolean(raw.isAll) : true } : void 0
+  };
+}
+function validateListFormLeadsRequest(input) {
+  const errors = [];
+  if (!input || typeof input !== "object") {
+    return { isValid: false, errors: ["Input ph\u1EA3i l\xE0 m\u1ED9t object."], data: void 0 };
+  }
+  const raw = input;
+  const oaId = typeof raw.oaId === "string" ? raw.oaId.trim() : "";
+  if (!oaId) {
+    errors.push("Tr\u01B0\u1EDDng 'oaId' l\xE0 b\u1EAFt bu\u1ED9c (m\xE3 ch\u1EEF t\u1EEB getAuthSession, v\xED d\u1EE5 'J4UB9MRE497YDQKKK').");
+  } else if (/^[0-9]+$/.test(oaId)) {
+    errors.push("Tr\u01B0\u1EDDng 'oaId' tr\xEAn Lead Center ph\u1EA3i l\xE0 m\xE3 ch\u1EEF alphanumeric t\u1EEB getAuthSession, kh\xF4ng d\xF9ng chu\u1ED7i s\u1ED1 pageId (s\u1EBD b\u1ECB l\u1ED7i 403 Forbidden).");
+  }
+  const type = Number(raw.type);
+  if (![1, 5].includes(type)) {
+    errors.push("Tr\u01B0\u1EDDng 'type' ph\u1EA3i l\xE0 1 (ZALOFORM) ho\u1EB7c 5 (COMMERCE).");
+  }
+  const limit = typeof raw.limit === "number" && raw.limit > 0 ? Math.floor(raw.limit) : 20;
+  const offset = typeof raw.offset === "number" && raw.offset >= 0 ? Math.floor(raw.offset) : 0;
+  const status = typeof raw.status === "string" && raw.status.trim() !== "" ? raw.status.trim() : "2,6,1,0,7,4,5,3";
+  const now = Math.floor(Date.now() / 1e3);
+  const fromTime = typeof raw.fromTime === "number" && raw.fromTime >= 0 ? Math.floor(raw.fromTime) : now - 90 * 86400;
+  const toTime = typeof raw.toTime === "number" && raw.toTime >= 0 ? Math.floor(raw.toTime) : now;
+  if (toTime < fromTime) {
+    errors.push("M\u1ED1c th\u1EDDi gian k\u1EBFt th\xFAc 'toTime' ph\u1EA3i l\u1EDBn h\u01A1n ho\u1EB7c b\u1EB1ng 'fromTime'.");
+  }
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? {
+      oaId,
+      type,
+      limit,
+      offset,
+      status,
+      fromTime,
+      toTime,
+      formIds: raw.formIds ? String(raw.formIds).trim() : void 0,
+      keyword: raw.keyword ? String(raw.keyword).trim() : void 0,
+      reason: raw.reason ? String(raw.reason).trim() : void 0,
+      labelIds: raw.labelIds ? String(raw.labelIds).trim() : void 0,
+      isCommerce: raw.isCommerce !== void 0 ? Boolean(raw.isCommerce) : false
+    } : void 0
+  };
+}
+var ZaloFormsValidator = {
+  createForm: validateCreateFormRequest,
+  listFormsByOfficialAccount: validateListFormsByOfficialAccountRequest,
+  listFormLeads: validateListFormLeadsRequest
+};
+
 // src/services/forms.service.ts
+var OP_ZaloAdsCreateForm2 = {
+  operationId: "zalo_ads_create_form",
+  method: "POST",
+  endpoint: "/api/form/create",
+  baseUrl: "https://ads.zalo.me",
+  binaryFields: [],
+  pathFields: [],
+  queryFields: [],
+  headerFields: [],
+  cookieFields: [],
+  bodyFields: ["data"]
+};
+var OP_ZaloAdsListFormsByOfficialAccount2 = {
+  operationId: "zalo_ads_list_forms_by_official_account",
+  method: "GET",
+  endpoint: "/api/form/getByOaId",
+  baseUrl: "https://ads.zalo.me",
+  binaryFields: [],
+  pathFields: [],
+  queryFields: ["oaId", "isAll"],
+  headerFields: [],
+  cookieFields: [],
+  bodyFields: []
+};
 var OP_ZaloFormsDisableFormLeadNotification = {
   "operationId": "ZaloForms_disableFormLeadNotification",
   "method": "POST",
@@ -3663,7 +5219,8 @@ var OP_ZaloFormsListConversationLeads = {
     "keyword",
     "fromTime",
     "labelIds",
-    "sceneIds"
+    "sceneIds",
+    "reason"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -3687,7 +5244,8 @@ var OP_ZaloFormsListFormLeads = {
     "keyword",
     "fromTime",
     "labelIds",
-    "isCommerce"
+    "isCommerce",
+    "reason"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -3769,10 +5327,59 @@ var OP_ZaloFormsGetAuthSession = {
   "cookieFields": [],
   "bodyFields": []
 };
+var OP_ZaloFormsTrackManageFormEvent = {
+  operationId: "zalo_forms_track_manage_form_event",
+  method: "GET",
+  endpoint: "/client/manage/api/manageForm/tracking",
+  baseUrl: "https://form.ads.zalo.me",
+  binaryFields: [],
+  pathFields: [],
+  queryFields: ["eventId", "oaId", "formId"],
+  headerFields: [],
+  cookieFields: [],
+  bodyFields: []
+};
 var ZaloFormsService = class {
   constructor(client) {
     this.client = client;
   }
+  validator = ZaloFormsValidator;
+  static validator = ZaloFormsValidator;
+  /**
+   * Tạo biểu mẫu mới gắn với Official Account (POST https://ads.zalo.me/api/form/create).
+   * Hỗ trợ truyền thẳng Typed Payload (tự động validate qua ZaloFormsValidator và mã hóa urlencoded)
+   * hoặc object dạng `{ data: JSON.stringify(...) }`.
+   */
+  async createForm(request, options) {
+    let payloadStr;
+    if (typeof request.data === "string") {
+      payloadStr = request.data;
+    } else {
+      const val = ZaloFormsValidator.createForm(request);
+      if (!val.isValid || !val.data) {
+        throw new Error(`[ZaloFormsValidator] D\u1EEF li\u1EC7u t\u1EA1o form kh\xF4ng h\u1EE3p l\u1EC7:
+ - ${val.errors.join("\n - ")}`);
+      }
+      payloadStr = JSON.stringify(val.data);
+    }
+    return this.client.requestFormUrlEncoded(
+      OP_ZaloAdsCreateForm2,
+      this.client.toTransportInput(OP_ZaloAdsCreateForm2, { data: payloadStr }),
+      options
+    );
+  }
+  /**
+   * Lấy danh sách biểu mẫu Zalo Ads theo Official Account (GET https://ads.zalo.me/api/form/getByOaId).
+   */
+  listFormsByOfficialAccount(request, options) {
+    const val = ZaloFormsValidator.listFormsByOfficialAccount(request);
+    const cleanInput = val.isValid && val.data ? val.data : request;
+    return this.client.requestWithoutBody(
+      OP_ZaloAdsListFormsByOfficialAccount2,
+      this.client.toTransportInput(OP_ZaloAdsListFormsByOfficialAccount2, cleanInput),
+      options
+    );
+  }
   getAuthSession(options) {
     return this.client.requestWithoutBody(OP_ZaloFormsGetAuthSession, void 0, options);
   }
@@ -3806,10 +5413,20 @@ var ZaloFormsService = class {
   updateFormLeadNotificationInterval(request, options) {
     return this.client.requestJson(OP_ZaloFormsUpdateFormLeadNotificationInterval, this.client.toTransportInput(OP_ZaloFormsUpdateFormLeadNotificationInterval, request), options);
   }
+  /**
+   * Ghi nhận sự kiện tương tác trên Lead Center (GET /client/manage/api/manageForm/tracking).
+   */
+  trackManageFormEvent(request, options) {
+    return this.client.requestWithoutBody(
+      OP_ZaloFormsTrackManageFormEvent,
+      this.client.toTransportInput(OP_ZaloFormsTrackManageFormEvent, request),
+      options
+    );
+  }
 };
 
 // src/validators/instant-pages.validator.ts
-function isPositiveInteger(val) {
+function isPositiveInteger2(val) {
   if (typeof val === "number") return Number.isInteger(val) && val > 0;
   if (typeof val === "string" && val.trim() !== "") {
     const num = Number(val);
@@ -3817,7 +5434,7 @@ function isPositiveInteger(val) {
   }
   return false;
 }
-function toPositiveInteger(val) {
+function toPositiveInteger2(val) {
   return typeof val === "number" ? Math.floor(val) : parseInt(String(val), 10);
 }
 function validateCloneInstantPageRequest(input) {
@@ -3826,13 +5443,13 @@ function validateCloneInstantPageRequest(input) {
     return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u sao ch\xE9p Instant Page ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng (object)."] };
   }
   const obj = input;
-  if (!isPositiveInteger(obj.instantPageId)) {
+  if (!isPositiveInteger2(obj.instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
   return {
     isValid: errors.length === 0,
     errors,
-    data: errors.length === 0 ? { instantPageId: toPositiveInteger(obj.instantPageId) } : void 0
+    data: errors.length === 0 ? { instantPageId: toPositiveInteger2(obj.instantPageId) } : void 0
   };
 }
 function validateGetInstantPageDetailRequest(input) {
@@ -3841,13 +5458,13 @@ function validateGetInstantPageDetailRequest(input) {
     return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u l\u1EA5y chi ti\u1EBFt Instant Page ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng (object)."] };
   }
   const obj = input;
-  if (!isPositiveInteger(obj.instantPageId)) {
+  if (!isPositiveInteger2(obj.instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
   return {
     isValid: errors.length === 0,
     errors,
-    data: errors.length === 0 ? { instantPageId: toPositiveInteger(obj.instantPageId) } : void 0
+    data: errors.length === 0 ? { instantPageId: toPositiveInteger2(obj.instantPageId) } : void 0
   };
 }
 function validateGetInstantPageSharedUserRequest(input) {
@@ -3856,18 +5473,18 @@ function validateGetInstantPageSharedUserRequest(input) {
     return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u l\u1EA5y th\xF4ng tin ng\u01B0\u1EDDi d\xF9ng chia s\u1EBB ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng (object)."] };
   }
   const obj = input;
-  if (!isPositiveInteger(obj.instantPageId)) {
+  if (!isPositiveInteger2(obj.instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
-  if (!isPositiveInteger(obj.userId)) {
+  if (!isPositiveInteger2(obj.userId)) {
     errors.push("Tr\u01B0\u1EDDng 'userId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
   return {
     isValid: errors.length === 0,
     errors,
     data: errors.length === 0 ? {
-      instantPageId: toPositiveInteger(obj.instantPageId),
-      userId: toPositiveInteger(obj.userId)
+      instantPageId: toPositiveInteger2(obj.instantPageId),
+      userId: toPositiveInteger2(obj.userId)
     } : void 0
   };
 }
@@ -3877,15 +5494,15 @@ function validateListInstantPageEditHistoryRequest(input) {
     return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u l\u1EA5y l\u1ECBch s\u1EED ch\u1EC9nh s\u1EEDa ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng (object)."] };
   }
   const obj = input;
-  if (!isPositiveInteger(obj.instantPageId)) {
+  if (!isPositiveInteger2(obj.instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
   let limit = void 0;
   if (obj.limit !== void 0 && obj.limit !== null) {
-    if (!isPositiveInteger(obj.limit)) {
+    if (!isPositiveInteger2(obj.limit)) {
       errors.push("Tr\u01B0\u1EDDng 'limit' n\u1EBFu c\xF3 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn >= 1.");
     } else {
-      limit = toPositiveInteger(obj.limit);
+      limit = toPositiveInteger2(obj.limit);
     }
   }
   let offset = void 0;
@@ -3901,7 +5518,7 @@ function validateListInstantPageEditHistoryRequest(input) {
     isValid: errors.length === 0,
     errors,
     data: errors.length === 0 ? {
-      instantPageId: toPositiveInteger(obj.instantPageId),
+      instantPageId: toPositiveInteger2(obj.instantPageId),
       ...limit !== void 0 ? { limit } : {},
       ...offset !== void 0 ? { offset } : {}
     } : void 0
@@ -3913,13 +5530,13 @@ function validateListInstantPageFormRecordsRequest(input) {
     return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u t\u1EA3i b\u1EA3n ghi form ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng (object)."] };
   }
   const obj = input;
-  if (!isPositiveInteger(obj.instantPageId)) {
+  if (!isPositiveInteger2(obj.instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
   return {
     isValid: errors.length === 0,
     errors,
-    data: errors.length === 0 ? { instantPageId: toPositiveInteger(obj.instantPageId) } : void 0
+    data: errors.length === 0 ? { instantPageId: toPositiveInteger2(obj.instantPageId) } : void 0
   };
 }
 function validateListInstantPageSharesRequest(input) {
@@ -3928,13 +5545,13 @@ function validateListInstantPageSharesRequest(input) {
     return { isValid: false, errors: ["D\u1EEF li\u1EC7u y\xEAu c\u1EA7u l\u1EA5y danh s\xE1ch ng\u01B0\u1EDDi \u0111\u01B0\u1EE3c chia s\u1EBB ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng (object)."] };
   }
   const obj = input;
-  if (!isPositiveInteger(obj.instantPageId)) {
+  if (!isPositiveInteger2(obj.instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
   return {
     isValid: errors.length === 0,
     errors,
-    data: errors.length === 0 ? { instantPageId: toPositiveInteger(obj.instantPageId) } : void 0
+    data: errors.length === 0 ? { instantPageId: toPositiveInteger2(obj.instantPageId) } : void 0
   };
 }
 function validateListInstantPageUsersRequest(input) {
@@ -3960,10 +5577,10 @@ function validateSearchInstantPagesRequest(input) {
   const obj = input;
   const data = {};
   if (obj.id !== void 0 && obj.id !== null && obj.id !== "") {
-    if (!isPositiveInteger(obj.id)) {
+    if (!isPositiveInteger2(obj.id)) {
       errors.push("B\u1ED9 l\u1ECDc 'id' n\u1EBFu c\xF3 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
     } else {
-      data.id = toPositiveInteger(obj.id);
+      data.id = toPositiveInteger2(obj.id);
     }
   }
   if (obj.name !== void 0 && obj.name !== null) {
@@ -3994,10 +5611,10 @@ function validateUpdateInstantPageRequest(input) {
   }
   const obj = input;
   const instantPageId = obj.instantPageId ?? obj.id;
-  if (!isPositiveInteger(instantPageId)) {
+  if (!isPositiveInteger2(instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' (ho\u1EB7c 'id') l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
-  const numericId = toPositiveInteger(instantPageId);
+  const numericId = toPositiveInteger2(instantPageId);
   const data = {
     instantPageId: numericId,
     id: numericId
@@ -4028,7 +5645,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;
     }
@@ -4091,7 +5708,7 @@ function validateListInstantPageLeadsRequest(input) {
       errors.push("Tr\u01B0\u1EDDng 'ids' kh\xF4ng ch\u1EE9a b\u1EA5t k\u1EF3 ID h\u1EE3p l\u1EC7 n\xE0o.");
     } else {
       for (const id of idParts) {
-        if (!isPositiveInteger(id)) {
+        if (!isPositiveInteger2(id)) {
           errors.push(`M\xE3 trang '${id}' trong danh s\xE1ch 'ids' kh\xF4ng ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng h\u1EE3p l\u1EC7.`);
         }
       }
@@ -4115,7 +5732,7 @@ function validateUpsertInstantPageFormRequest(input) {
     return { isValid: false, errors: ["D\u1EEF li\u1EC7u c\u1EA5u h\xECnh bi\u1EC3u m\u1EABu Instant Page ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng."] };
   }
   const obj = input;
-  if (!isPositiveInteger(obj.instantPageId)) {
+  if (!isPositiveInteger2(obj.instantPageId)) {
     errors.push("Tr\u01B0\u1EDDng 'instantPageId' l\xE0 b\u1EAFt bu\u1ED9c v\xE0 ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn d\u01B0\u01A1ng (> 0).");
   }
   if (!obj.oaId || typeof obj.oaId !== "string" || !/^\d+$/.test(obj.oaId.trim())) {
@@ -4168,7 +5785,7 @@ function validateUpsertInstantPageFormRequest(input) {
     }
   }
   const data = {
-    instantPageId: toPositiveInteger(obj.instantPageId),
+    instantPageId: toPositiveInteger2(obj.instantPageId),
     oaId: String(obj.oaId).trim(),
     formName: String(obj.formName).trim(),
     questions: obj.questions ?? [],
@@ -4936,110 +6553,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. */
-  code;
-  /** 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";
@@ -5064,21 +6577,28 @@ var ZaloInstantPageBlockType = /* @__PURE__ */ ((ZaloInstantPageBlockType2) => {
 })(ZaloInstantPageBlockType || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ALLOWED_CTAS_PER_AD_TYPE,
   ALL_ZALO_ADS_DOMAINS,
   MemoryZaloSessionStore,
   RedisZaloSessionStore,
   TieredZaloSessionStore,
+  VALID_AD_TYPES,
+  VALID_CAMPAIGN_TYPES,
   ZaloAccountService,
   ZaloAdsAccountPool,
+  ZaloAdsActionType,
+  ZaloAdsAgeRangeId,
   ZaloAdsCreateFlowRequest,
   ZaloAdsCreateFlowResponse,
   ZaloAdsCreatePostCampaignRequest,
   ZaloAdsCreatePostCampaignResponse,
+  ZaloAdsDeliveryType,
   ZaloAdsFlowButtonDto,
   ZaloAdsFlowChildMessageDto,
   ZaloAdsFlowMessageDto,
   ZaloAdsIntegrationManager,
   ZaloAdsMessageAdUpdateDataDto,
+  ZaloAdsOsId,
   ZaloAdsSdk,
   ZaloAdsService,
   ZaloAdsUpdateMessageAdRequest,
@@ -5086,13 +6606,17 @@ var ZaloInstantPageBlockType = /* @__PURE__ */ ((ZaloInstantPageBlockType2) => {
   ZaloAdsUpdateVideoAdRequest,
   ZaloAdsUpdateVideoAdResponse,
   ZaloAudiencesService,
+  ZaloAudiencesValidator,
   ZaloAuthManager,
   ZaloAutomatedRulesService,
   ZaloCampaignsService,
+  ZaloCampaignsValidator,
   ZaloChatWidgetService,
   ZaloConversionsService,
   ZaloFlowsService,
+  ZaloFlowsValidator,
   ZaloFormsService,
+  ZaloFormsValidator,
   ZaloInstantPageBlockType,
   ZaloInstantPagesService,
   ZaloInstantPagesValidator,
@@ -5108,9 +6632,24 @@ var ZaloInstantPageBlockType = /* @__PURE__ */ ((ZaloInstantPageBlockType2) => {
   defaultSharedMemorySessionStore,
   deriveAccountKeyFromZpsid,
   parseZaloCookieInput,
+  validateChangeCampaignStatusParams,
   validateCloneInstantPageRequest,
+  validateCreateCampaignPayload,
+  validateCreateFlowRequest,
+  validateCreateFormEventAudienceRequest,
+  validateCreateFormRequest,
+  validateCreateLookalikeAudienceRequest,
+  validateCreateMessageOaEventAudienceRequest,
+  validateCreateMessagePersonalEventAudienceRequest,
+  validateCreatePhoneAudienceRequest,
+  validateCreateSavedAudienceRequest,
+  validateDuplicateAdParams,
+  validateEstimateAudienceRequest,
   validateGetInstantPageDetailRequest,
   validateGetInstantPageSharedUserRequest,
+  validateListFlowsByOfficialAccountRequest,
+  validateListFormLeadsRequest,
+  validateListFormsByOfficialAccountRequest,
   validateListInstantPageEditHistoryRequest,
   validateListInstantPageFormRecordsRequest,
   validateListInstantPageLeadsRequest,
@@ -5118,7 +6657,10 @@ var ZaloInstantPageBlockType = /* @__PURE__ */ ((ZaloInstantPageBlockType2) => {
   validateListInstantPageUsersRequest,
   validateListMiniPageTemplatesRequest,
   validateListOfficialAccountsRequest,
+  validateRenameCampaignParams,
   validateSearchInstantPagesRequest,
+  validateUpdateAdPayload,
+  validateUpdateFlowRequest,
   validateUpdateInstantPageRequest,
   validateUpsertInstantPageFormRequest
 });