@redonvn/zalo-ads-sdk 0.2.19 → 0.2.20

package/dist/index.mjs

@@ -2117,11 +2117,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.");
     }
@@ -2600,14 +2607,171 @@ 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 = {}) {
+  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.DISPLAY }, 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 +5923,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'.");
   }
@@ -8781,18 +8945,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 +8987,18 @@ export {
   validateSearchInstantPagesRequest,
   validateToggleLeadNotificationRequest,
   validateUpdateAdPayload,
+  validateUpdateArticleAd,
+  validateUpdateCommerceAd,
+  validateUpdateDisplayAd,
   validateUpdateFlowRequest,
+  validateUpdateFormAd,
   validateUpdateInstantPageRequest,
   validateUpdateInstantPageSharesRequest,
   validateUpdateLeadNotificationIntervalRequest,
+  validateUpdateMessageAd,
+  validateUpdateOfficialAccountAd,
+  validateUpdateVideoAd,
+  validateUpdateWebsiteAd,
   validateUploadCustomAudiencePhoneListRequest,
   validateUploadMediaRequest,
   validateUpsertCustomReportRequest,