@redonvn/zalo-ads-sdk 0.2.30 → 0.2.31

package/dist/index.mjs

@@ -2059,7 +2059,7 @@ var VALID_AD_TYPES = {
   OA: 2,
   VIDEO: 11,
   COMMERCE: 28,
-  // Server trả về 28 (không phải 23)
+  // Mã chuẩn cho Commerce Ad
   ARTICLE: 3,
   DISPLAY: 21,
   // Masthead Mobile (Format 1) & Masthead Desktop (Format 2)
@@ -2781,14 +2781,31 @@ function validateUpdateAdPayload(payload, options = {}) {
       );
     }
   }
-  if (payload.Type === VALID_AD_TYPES.FORM) {
+  const isNonEmptyStr = (val) => typeof val === "string" && val.trim().length > 0;
+  if (payload.Type === VALID_AD_TYPES.WEBSITE || Number(payload.Type) === 5) {
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Website (Ad Type 5). Vui l\xF2ng upload \u1EA3nh b\xECa t\u1EC9 l\u1EC7 16:9 (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+  } else if (payload.Type === VALID_AD_TYPES.FORM || Number(payload.Type) === 18) {
     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).");
     }
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Form (Ad Type 18). Vui l\xF2ng upload \u1EA3nh b\xECa t\u1EC9 l\u1EC7 16:9 (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
   } else if (payload.Type === VALID_AD_TYPES.MESSAGE || payload.Type === VALID_AD_TYPES.MESSAGE_LEGACY || Number(payload.Type) === 19 || Number(payload.Type) === 30) {
-    if (!payload.Settings?.Image?.LogoUrl) {
+    if (!isNonEmptyStr(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 19/30).");
     }
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Tin Nh\u1EAFn (Ad Type 19/30). Vui l\xF2ng upload \u1EA3nh b\xECa t\u1EC9 l\u1EC7 16:9 (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
     const hasFlow = payload.ZaloFlowId && Number(payload.ZaloFlowId) > 0;
     const hasMiniPage = payload.MiniPageId && Number(payload.MiniPageId) > 0;
     if (!hasFlow && !hasMiniPage) {
@@ -2796,30 +2813,58 @@ function validateUpdateAdPayload(payload, options = {}) {
         "Qu\u1EA3ng c\xE1o Tin Nh\u1EAFn y\xEAu c\u1EA7u ph\u1EA3i ch\u1ECDn K\u1ECBch b\u1EA3n tin nh\u1EAFn (ZaloFlowId > 0) ho\u1EB7c Trang gi\u1EDBi thi\u1EC7u th\u01B0\u01A1ng hi\u1EC7u (MiniPageId > 0)."
       );
     }
-  } else if (payload.Type === VALID_AD_TYPES.COMMERCE) {
+  } else if (payload.Type === VALID_AD_TYPES.COMMERCE || Number(payload.Type) === 28) {
     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) {
+    const hasSquare = isNonEmptyStr(payload.Settings?.Image?.SquareCoverUrl);
+    const hasLandscape = isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl);
+    if (!hasSquare && !hasLandscape) {
+      errors.push(
+        "Settings.Image.SquareCoverUrl (ho\u1EB7c LandscapeCoverUrl) l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Commerce (Ad Type 28). Vui l\xF2ng upload \u1EA3nh s\u1EA3n ph\u1EA9m (1024x1024 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+  } else if (payload.Type === VALID_AD_TYPES.OA || Number(payload.Type) === 2) {
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o OA (Ad Type 2). Vui l\xF2ng upload \u1EA3nh b\xECa (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+    if (payload.Settings?.AdInfo?.Action !== void 0 && Number(payload.Settings.AdInfo.Action) !== 6) {
+      warnings.push("Qu\u1EA3ng c\xE1o OA ch\u1EC9 ch\u1EA5p nh\u1EADn Action = 6 (Quan t\xE2m OA).");
+    }
+  } else if (payload.Type === VALID_AD_TYPES.ARTICLE || Number(payload.Type) === 3) {
+    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).");
+    }
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o B\xE0i Vi\u1EBFt (Ad Type 3). Vui l\xF2ng upload \u1EA3nh \u0111\u1EA1i di\u1EC7n b\xE0i vi\u1EBFt (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+  } else if (payload.Type === VALID_AD_TYPES.VIDEO || Number(payload.Type) === 11) {
     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).");
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      warnings.push("N\xEAn b\u1ED5 sung Settings.Image.LandscapeCoverUrl l\xE0m \u1EA3nh poster \u0111\u1EA1i di\u1EC7n khi video ch\u01B0a t\u1EF1 \u0111\u1ED9ng ph\xE1t.");
     }
   } 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;
+    const hasImage = isNonEmptyStr(img?.LandscapeCoverUrl) || isNonEmptyStr(img?.BaseLandscapeCoverUrl) || isNonEmptyStr(img?.PortraitCoverUrl) || isNonEmptyStr(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)."
       );
     }
   }
+  const coverUrl = payload.Settings?.Image?.LandscapeCoverUrl;
+  if (coverUrl && typeof coverUrl === "string" && !coverUrl.includes("zascdn.me") && !coverUrl.includes("zadn.vn") && !coverUrl.includes("zdn.vn") && !coverUrl.includes("zalo.me")) {
+    warnings.push("\u1EA2nh b\xECa (LandscapeCoverUrl) n\xEAn \u0111\u01B0\u1EE3c t\u1EA3i l\xEAn CDN Zalo Ads (*.zascdn.me) \u0111\u1EC3 \u0111\u1EA3m b\u1EA3o duy\u1EC7t.");
+  }
   return {
     isValid: errors.length === 0,
     errors,