@redonvn/zalo-ads-sdk 0.2.19 → 0.2.25

package/dist/index.mjs

@@ -2048,7 +2048,24 @@ var VALID_AD_TYPES = {
   COMMERCE: 28,
   // Server trả về 28 (không phải 23)
   ARTICLE: 3,
-  DISPLAY: 21
+  DISPLAY: 21,
+  // Masthead Mobile (Format 1) & Masthead Desktop (Format 2)
+  DISPLAY_HALFPAGE: 26,
+  // Halfpage Mobile (Format 13) & Halfpage PC (Format 14)
+  DISPLAY_MEDIUM_RECTANGLE: 23
+  // Medium Rectangle 300x250 (Format 6)
+};
+var ZALO_DISPLAY_AD_FORMAT = {
+  MASTHEAD_MOBILE: 1,
+  // Kích thước 640x360, Os: [0, 1]
+  MASTHEAD_DESKTOP: 2,
+  // Kích thước 970x250, Os: [3]
+  MEDIUM_RECTANGLE: 6,
+  // Kích thước 300x250, Os: [0, 1]
+  HALFPAGE_MOBILE: 13,
+  // Kích thước 300x600, Os: [0, 1]
+  HALFPAGE_PC: 14
+  // Kích thước 300x600, Os: [3]
 };
 var ALLOWED_CTAS_PER_AD_TYPE = {
   // Website (Type 5): 9 CTAs
@@ -2099,7 +2116,41 @@ var ALLOWED_CTAS_PER_AD_TYPE = {
     ZaloAdsActionType.XEM_THEM
   ],
   // OA (Type 2): Cố định Quan tâm OA (6)
-  [VALID_AD_TYPES.OA]: [ZaloAdsActionType.QUAN_TAM_OA]
+  [VALID_AD_TYPES.OA]: [ZaloAdsActionType.QUAN_TAM_OA],
+  // Display (Type 21) & Display Halfpage (Type 26): Hỗ trợ các hành động cơ bản
+  [VALID_AD_TYPES.DISPLAY]: [
+    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
+  ],
+  [VALID_AD_TYPES.DISPLAY_HALFPAGE]: [
+    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
+  ],
+  [VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE]: [
+    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
+  ]
 };
 function validateCreateCampaignPayload(payload, options = {}) {
   const errors = [];
@@ -2117,11 +2168,18 @@ function validateCreateCampaignPayload(payload, options = {}) {
       `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) {
+  const OA_REQUIRED_CAMPAIGN_TYPES = [
+    VALID_CAMPAIGN_TYPES.FORM,
+    VALID_CAMPAIGN_TYPES.MESSAGE,
+    VALID_CAMPAIGN_TYPES.OA,
+    VALID_CAMPAIGN_TYPES.COMMERCE,
+    VALID_CAMPAIGN_TYPES.ARTICLE
+  ];
+  if (payload.campaignType !== void 0 && OA_REQUIRED_CAMPAIGN_TYPES.includes(payload.campaignType)) {
     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).");
+      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, ch\u1ECDn t\u1EEB Danh s\xE1ch t\xE0i kho\u1EA3n OA).");
     }
-  } else {
+  } else if (payload.campaignType === VALID_CAMPAIGN_TYPES.DISPLAY) {
     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.");
     }
@@ -2188,11 +2246,15 @@ function validateUpdateAdPayload(payload, options = {}) {
   if (!adInfo) {
     errors.push("Settings.AdInfo l\xE0 b\u1EAFt bu\u1ED9c.");
   } else {
+    const rawTypeNum = Number(payload.Type);
+    const isDisplayAd = rawTypeNum === 21 || rawTypeNum === 23 || rawTypeNum === 26 || adInfo.AdFormat === 1 || adInfo.AdFormat === 2 || adInfo.AdFormat === 6 || adInfo.AdFormat === 13 || adInfo.AdFormat === 14;
     if (!adInfo.Caption || !adInfo.Caption.trim()) {
-      errors.push("Settings.AdInfo.Caption l\xE0 b\u1EAFt bu\u1ED9c.");
+      if (!isDisplayAd) {
+        errors.push("Settings.AdInfo.Caption l\xE0 b\u1EAFt bu\u1ED9c.");
+      }
     } else {
       const captionLen = adInfo.Caption.trim().length;
-      if (captionLen < 35) {
+      if (!isDisplayAd && 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).`);
@@ -2216,6 +2278,14 @@ function validateUpdateAdPayload(payload, options = {}) {
         );
       }
     }
+    if (isDisplayAd) {
+      const targetUrl = typeof adInfo.TargetUrl === "object" ? adInfo.TargetUrl?.Url : adInfo.TargetUrl;
+      if (!targetUrl || typeof targetUrl !== "string" || !targetUrl.trim()) {
+        errors.push("Settings.AdInfo.TargetUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Display.");
+      } else if (!/^https?:\/\//i.test(targetUrl.trim())) {
+        errors.push("Settings.AdInfo.TargetUrl ph\u1EA3i l\xE0 m\u1ED9t \u0111\u01B0\u1EDDng d\u1EABn h\u1EE3p l\u1EC7 (b\u1EAFt \u0111\u1EA7u b\u1EB1ng http:// ho\u1EB7c https://).");
+      }
+    }
     if (adInfo.Action !== void 0 && payload.Type) {
       const allowedCtas = ALLOWED_CTAS_PER_AD_TYPE[payload.Type];
       if (allowedCtas && !allowedCtas.includes(adInfo.Action)) {
@@ -2339,6 +2409,65 @@ function validateUpdateAdPayload(payload, options = {}) {
           "Ng\xE2n s\xE1ch t\u1ED1i thi\u1EC3u cho Qu\u1EA3ng c\xE1o Tin nh\u1EAFn l\xE0 600,000 VN\u0110 (Price.Limit >= 600000). N\u1EBFu \u0111\u1EB7t d\u01B0\u1EDBi 600k m\xE1y ch\u1EE7 s\u1EBD t\u1EEB ch\u1ED1i."
         );
       }
+    } else if (Number(payload.Type) === 21 || Number(payload.Type) === 23 || Number(payload.Type) === 26 || payload.Type === VALID_AD_TYPES.DISPLAY || payload.Type === VALID_AD_TYPES.DISPLAY_HALFPAGE || payload.Type === VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE) {
+      const adFormat = payload.Settings?.AdInfo?.AdFormat;
+      const typeNum = Number(payload.Type);
+      const isHalfpage = typeNum === 26 || adFormat === 13 || adFormat === 14 || (payload.AdName || "").toLowerCase().includes("halfpage");
+      const isMediumRectangle = typeNum === 23 || adFormat === 6 || (payload.AdName || "").toLowerCase().includes("medium rectangle") || (payload.AdName || "").toLowerCase().includes("300x250");
+      const adNameLower = (payload.AdName || "").toLowerCase();
+      const isWelcome = adNameLower.includes("welcome");
+      const isMasthead = (adNameLower.includes("masthead") || typeNum === 21 || adFormat === 1 || adFormat === 2) && !isWelcome && !isMediumRectangle;
+      if (price.Type !== 1 && price.Type !== 2) {
+        errors.push(
+          "\u0110\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Display, Price.Type ch\u1EC9 ch\u1EA5p nh\u1EADn 1 (CPM - L\u01B0\u1EE3t hi\u1EC3n th\u1ECB) ho\u1EB7c 2 (CPC - L\u01B0\u1EE3t nh\u1EA5n)."
+        );
+      }
+      if ((isHalfpage || isMasthead) && price.Type === 2) {
+        errors.push(
+          `Qu\u1EA3ng c\xE1o ${isHalfpage ? "Halfpage (Type 26 / AdFormat 13, 14)" : "Masthead (Type 21)"} ch\u1EC9 h\u1ED7 tr\u1EE3 t\xEDnh ti\u1EC1n theo l\u01B0\u1EE3t hi\u1EC3n th\u1ECB CPM (Price.Type = 1), kh\xF4ng h\u1ED7 tr\u1EE3 CPC.`
+        );
+      }
+      if (price.Type === 1) {
+        if (price.Bid !== void 0) {
+          if (isWelcome && price.Bid < 3e4) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Welcome Mobile t\u1ED1i thi\u1EC3u l\xE0 30,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (isHalfpage && price.Bid < 16e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Halfpage t\u1ED1i thi\u1EC3u l\xE0 16,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (isMasthead && price.Bid < 13e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Masthead t\u1ED1i thi\u1EC3u l\xE0 13,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (isMediumRectangle && price.Bid < 8e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Medium Rectangle CPM t\u1ED1i thi\u1EC3u l\xE0 8,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (price.Bid < 8e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Display CPM t\u1ED1i thi\u1EC3u l\xE0 8,000 VN\u0110 (s\xE0n h\u1EC7 th\u1ED1ng). Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          }
+        }
+        if (price.Limit !== void 0 && price.Limit > 0 && price.Limit < 50) {
+          errors.push(
+            "S\u1ED1 l\u01B0\u1EE3ng l\u01B0\u1EE3t hi\u1EC3n th\u1ECB t\u1ED1i thi\u1EC3u (Price.Limit) cho Qu\u1EA3ng c\xE1o Display CPM l\xE0 50 (t\u01B0\u01A1ng \u1EE9ng 50,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB)."
+          );
+        }
+      } else if (price.Type === 2) {
+        if (price.Bid !== void 0 && price.Bid < 1800) {
+          errors.push(
+            `Gi\xE1 \u0111\u1EB7t m\u1ED7i l\u01B0\u1EE3t nh\u1EA5n (Price.Bid) cho Qu\u1EA3ng c\xE1o Display CPC t\u1ED1i thi\u1EC3u l\xE0 1,800 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+          );
+        }
+        if (price.Limit !== void 0 && price.Limit > 0 && price.Limit < 50) {
+          errors.push(
+            "S\u1ED1 l\u01B0\u1EE3ng l\u01B0\u1EE3t nh\u1EA5n t\u1ED1i thi\u1EC3u (Price.Limit) cho Qu\u1EA3ng c\xE1o Display CPC l\xE0 50 l\u01B0\u1EE3t nh\u1EA5n."
+          );
+        }
+      }
     }
     if (payload.Settings && payload.Settings.DeliveryType !== void 0) {
       const deliveryType = payload.Settings.DeliveryType;
@@ -2355,6 +2484,21 @@ function validateUpdateAdPayload(payload, options = {}) {
   }
   const targeting = payload.Settings?.Targeting;
   if (targeting) {
+    if (targeting.Gender !== void 0 && targeting.Gender !== null) {
+      if (![0, 1, 2].includes(Number(targeting.Gender))) {
+        errors.push(`M\xE3 gi\u1EDBi t\xEDnh 'Gender' (${targeting.Gender}) kh\xF4ng h\u1EE3p l\u1EC7. H\u1EE3p l\u1EC7: 0 (T\u1EA5t c\u1EA3), 1 (Nam), 2 (N\u1EEF).`);
+      }
+    }
+    if (targeting.CustomAudienceId !== void 0 && targeting.CustomAudienceId !== null) {
+      if (typeof targeting.CustomAudienceId !== "number" || targeting.CustomAudienceId < 0) {
+        errors.push("CustomAudienceId ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn kh\xF4ng \xE2m (>= 0).");
+      }
+    }
+    if (targeting.ExcludedAudienceId !== void 0 && targeting.ExcludedAudienceId !== null) {
+      if (typeof targeting.ExcludedAudienceId !== "number" || targeting.ExcludedAudienceId < 0) {
+        errors.push("ExcludedAudienceId ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn kh\xF4ng \xE2m (>= 0).");
+      }
+    }
     const newAges = targeting.NewAgeRanges;
     const oldAges = targeting.AgeRanges;
     if (newAges && newAges.length > 0) {
@@ -2477,6 +2621,14 @@ function validateUpdateAdPayload(payload, options = {}) {
     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).");
     }
+  } else if (Number(payload.Type) === 21 || Number(payload.Type) === 23 || Number(payload.Type) === 26 || payload.Type === VALID_AD_TYPES.DISPLAY || payload.Type === VALID_AD_TYPES.DISPLAY_HALFPAGE || payload.Type === VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE) {
+    const img = payload.Settings?.Image;
+    const hasImage = img?.LandscapeCoverUrl || img?.BaseLandscapeCoverUrl || img?.PortraitCoverUrl || img?.SquareCoverUrl;
+    if (!hasImage) {
+      errors.push(
+        "Qu\u1EA3ng c\xE1o Display b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 \xEDt nh\u1EA5t m\u1ED9t banner h\xECnh \u1EA3nh (Settings.Image.LandscapeCoverUrl ho\u1EB7c BaseLandscapeCoverUrl)."
+      );
+    }
   }
   return {
     isValid: errors.length === 0,
@@ -2600,14 +2752,183 @@ function validateCropCoordinates(input) {
     data: errors.length === 0 ? cleanData : void 0
   };
 }
+function validateCreateCommerceCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (!payload.pageId || payload.pageId <= 0) {
+    errors.push("T\xE0i kho\u1EA3n OA ('pageId') l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Commerce (ch\u1ECDn t\u1EEB Danh s\xE1ch t\xE0i kho\u1EA3n OA, ph\u1EA3i > 0).");
+  }
+  if (payload.productId === void 0 || payload.productId === null || payload.productId <= 0) {
+    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).");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateCreateDisplayCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (payload.targetUrl && !/^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://.");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateCreateWebsiteCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (!payload.targetUrl || typeof payload.targetUrl !== "string" || !payload.targetUrl.trim()) {
+    errors.push("Li\xEAn k\u1EBFt website ('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("Li\xEAn k\u1EBFt website ('targetUrl') ph\u1EA3i l\xE0 \u0111\u01B0\u1EDDng link h\u1EE3p l\u1EC7 b\u1EAFt \u0111\u1EA7u b\u1EB1ng http:// ho\u1EB7c https://.");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateCreateFormCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (!payload.pageId || payload.pageId <= 0) {
+    errors.push("T\xE0i kho\u1EA3n OA ('pageId') l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Form (ch\u1ECDn t\u1EEB Danh s\xE1ch t\xE0i kho\u1EA3n OA, ph\u1EA3i > 0).");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateCreateMessageCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (!payload.pageId || payload.pageId <= 0) {
+    errors.push("T\xE0i kho\u1EA3n OA ('pageId') l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Tin nh\u1EAFn (ch\u1ECDn t\u1EEB Danh s\xE1ch t\xE0i kho\u1EA3n OA, ph\u1EA3i > 0).");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateCreateOfficialAccountCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (!payload.pageId || payload.pageId <= 0) {
+    errors.push("T\xE0i kho\u1EA3n OA ('pageId') l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Zalo Official Account (ch\u1ECDn t\u1EEB Danh s\xE1ch t\xE0i kho\u1EA3n OA, ph\u1EA3i > 0).");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateCreateArticleCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (!payload.pageId || payload.pageId <= 0) {
+    errors.push("T\xE0i kho\u1EA3n OA ('pageId') l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o B\xE0i vi\u1EBFt (ch\u1ECDn t\u1EEB Danh s\xE1ch t\xE0i kho\u1EA3n OA, ph\u1EA3i > 0).");
+  }
+  if (!payload.articleId || payload.articleId <= 0) {
+    errors.push("B\xE0i vi\u1EBFt ('articleId') l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o B\xE0i vi\u1EBFt (ch\u1ECDn t\u1EEB Danh s\xE1ch b\xE0i vi\u1EBFt c\u1EE7a OA \u0111\xF3, l\u1EA5y qua getOwnedArticles).");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateCreateVideoCampaign(payload, options = {}) {
+  const errors = [];
+  const warnings = [];
+  if (!payload.name || typeof payload.name !== "string" || !payload.name.trim()) {
+    errors.push("T\xEAn chi\u1EBFn d\u1ECBch ('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("T\xEAn chi\u1EBFn d\u1ECBch ('name') kh\xF4ng \u0111\u01B0\u1EE3c v\u01B0\u1EE3t qu\xE1 255 k\xFD t\u1EF1.");
+  }
+  if (!payload.targetUrl || typeof payload.targetUrl !== "string" || !payload.targetUrl.trim()) {
+    errors.push("Li\xEAn k\u1EBFt Website ('targetUrl') l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Video.");
+  } else if (!/^https?:\/\/.+/i.test(payload.targetUrl)) {
+    errors.push("Li\xEAn k\u1EBFt Website ('targetUrl') ph\u1EA3i l\xE0 \u0111\u01B0\u1EDDng link h\u1EE3p l\u1EC7 b\u1EAFt \u0111\u1EA7u b\u1EB1ng http:// ho\u1EB7c https://.");
+  }
+  return { isValid: errors.length === 0, errors, warnings };
+}
+function validateUpdateWebsiteAd(payload, options = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.WEBSITE }, options);
+}
+function validateUpdateDisplayAd(payload, options = {}) {
+  const adFormat = payload.Settings?.AdInfo?.AdFormat;
+  const rawType = Number(payload.Type);
+  const isHalfpage = rawType === 26 || adFormat === 13 || adFormat === 14;
+  const isMediumRectangle = rawType === 23 || adFormat === 6;
+  let effectiveType;
+  if (isHalfpage) {
+    effectiveType = VALID_AD_TYPES.DISPLAY_HALFPAGE;
+  } else if (isMediumRectangle) {
+    effectiveType = VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE;
+  } else {
+    effectiveType = payload.Type ?? VALID_AD_TYPES.DISPLAY;
+  }
+  return validateUpdateAdPayload({ ...payload, Type: effectiveType }, options);
+}
+function validateUpdateVideoAd(payload, options = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.VIDEO }, options);
+}
+function validateUpdateCommerceAd(payload, options = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.COMMERCE }, options);
+}
+function validateUpdateFormAd(payload, options = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.FORM }, options);
+}
+function validateUpdateMessageAd(payload, options = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.MESSAGE }, options);
+}
+function validateUpdateOfficialAccountAd(payload, options = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.OA }, options);
+}
+function validateUpdateArticleAd(payload, options = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.ARTICLE }, options);
+}
 var ZaloCampaignsValidator = {
+  // Generic
   createCampaign: validateCreateCampaignPayload,
   updateAd: validateUpdateAdPayload,
   renameCampaign: validateRenameCampaignParams,
   changeStatus: validateChangeCampaignStatusParams,
   duplicateAd: validateDuplicateAdParams,
   validateCropCoordinates,
-  validateUploadCropAdImage: validateCropCoordinates
+  validateUploadCropAdImage: validateCropCoordinates,
+  // Specific Create Campaign
+  createCommerceCampaign: validateCreateCommerceCampaign,
+  createDisplayCampaign: validateCreateDisplayCampaign,
+  createWebsiteCampaign: validateCreateWebsiteCampaign,
+  createFormCampaign: validateCreateFormCampaign,
+  createMessageCampaign: validateCreateMessageCampaign,
+  createOfficialAccountCampaign: validateCreateOfficialAccountCampaign,
+  createArticleCampaign: validateCreateArticleCampaign,
+  createVideoCampaign: validateCreateVideoCampaign,
+  // Specific Update Ad
+  updateWebsiteAd: validateUpdateWebsiteAd,
+  updateDisplayAd: validateUpdateDisplayAd,
+  updateVideoAd: validateUpdateVideoAd,
+  updateCommerceAd: validateUpdateCommerceAd,
+  updateFormAd: validateUpdateFormAd,
+  updateMessageAd: validateUpdateMessageAd,
+  updateOfficialAccountAd: validateUpdateOfficialAccountAd,
+  updateArticleAd: validateUpdateArticleAd
 };
 
 // src/services/campaigns.service.ts
@@ -5759,8 +6080,8 @@ function validateListFormLeadsRequest(input) {
   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;
+  const fromTime = typeof raw.fromTime === "number" && raw.fromTime >= 0 ? raw.fromTime >= 1e10 ? Math.floor(raw.fromTime / 1e3) : Math.floor(raw.fromTime) : now - 90 * 86400;
+  const toTime = typeof raw.toTime === "number" && raw.toTime >= 0 ? raw.toTime >= 1e10 ? Math.floor(raw.toTime / 1e3) : 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'.");
   }
@@ -8707,6 +9028,7 @@ export {
   VALID_AD_TYPES,
   VALID_CAMPAIGN_TYPES,
   VIETNAM_PHONE_REGEX,
+  ZALO_DISPLAY_AD_FORMAT,
   ZALO_NEW_REGION_PROVINCE_CODES,
   ZALO_PROFILE_ADS_PROVINCES,
   ZALO_PROFILE_ADS_SUB_CATEGORIES,
@@ -8781,18 +9103,26 @@ export {
   sanitizeCanvasKeys,
   validateChangeCampaignStatusParams,
   validateCloneInstantPageRequest,
+  validateCreateArticleCampaign,
   validateCreateCampaignPayload,
+  validateCreateCommerceCampaign,
   validateCreateCustomAudienceRequest,
+  validateCreateDisplayCampaign,
   validateCreateFlowRequest,
+  validateCreateFormCampaign,
   validateCreateFormEventAudienceRequest,
   validateCreateFormRequest,
   validateCreateInstantPageRequest,
   validateCreateLookalikeAudienceRequest,
+  validateCreateMessageCampaign,
   validateCreateMessageOaEventAudienceRequest,
   validateCreateMessagePersonalEventAudienceRequest,
   validateCreateOaPageRequest,
+  validateCreateOfficialAccountCampaign,
   validateCreatePhoneAudienceRequest,
   validateCreateSavedAudienceRequest,
+  validateCreateVideoCampaign,
+  validateCreateWebsiteCampaign,
   validateCropCoordinates,
   validateDateRangeReportRequest,
   validateDuplicateAdParams,
@@ -8815,10 +9145,18 @@ export {
   validateSearchInstantPagesRequest,
   validateToggleLeadNotificationRequest,
   validateUpdateAdPayload,
+  validateUpdateArticleAd,
+  validateUpdateCommerceAd,
+  validateUpdateDisplayAd,
   validateUpdateFlowRequest,
+  validateUpdateFormAd,
   validateUpdateInstantPageRequest,
   validateUpdateInstantPageSharesRequest,
   validateUpdateLeadNotificationIntervalRequest,
+  validateUpdateMessageAd,
+  validateUpdateOfficialAccountAd,
+  validateUpdateVideoAd,
+  validateUpdateWebsiteAd,
   validateUploadCustomAudiencePhoneListRequest,
   validateUploadMediaRequest,
   validateUpsertCustomReportRequest,