@redonvn/zalo-ads-sdk 0.2.18 → 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'.");
   }
@@ -6350,6 +6514,127 @@ function validateSearchInstantPagesRequest(input) {
     data: errors.length === 0 ? data : void 0
   };
 }
+function sanitizeCanvasKeys(data) {
+  const cleanData = {};
+  for (const [key, value] of Object.entries(data)) {
+    const cleanKey = key.replace(/^["']+|["']+$/g, "").trim();
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      const valObj = value;
+      const sanitizedSub = { ...valObj };
+      if (sanitizedSub.images && typeof sanitizedSub.images === "object" && !Array.isArray(sanitizedSub.images)) {
+        sanitizedSub.images = sanitizeCanvasKeys(sanitizedSub.images);
+      }
+      if (sanitizedSub.videos && typeof sanitizedSub.videos === "object" && !Array.isArray(sanitizedSub.videos)) {
+        sanitizedSub.videos = sanitizeCanvasKeys(sanitizedSub.videos);
+      }
+      cleanData[cleanKey] = sanitizedSub;
+    } else {
+      cleanData[cleanKey] = value;
+    }
+  }
+  return cleanData;
+}
+function validateInstantPageCanvas(input, isPublishing = false) {
+  const errors = [];
+  if (!input) {
+    return { isValid: false, errors: ["Canvas Instant Page kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng."] };
+  }
+  let canvasObj;
+  if (typeof input === "string") {
+    if (input.trim() === "") {
+      return { isValid: false, errors: ["Chu\u1ED7i Canvas JSON kh\xF4ng \u0111\u01B0\u1EE3c r\u1ED7ng."] };
+    }
+    try {
+      canvasObj = JSON.parse(input);
+    } catch (e) {
+      return { isValid: false, errors: [`Canvas JSON kh\xF4ng h\u1EE3p l\u1EC7: ${e.message}`] };
+    }
+  } else if (typeof input === "object" && input !== null) {
+    canvasObj = input;
+  } else {
+    return { isValid: false, errors: ["Canvas ph\u1EA3i l\xE0 \u0111\u1ED1i t\u01B0\u1EE3ng (Object) ho\u1EB7c chu\u1ED7i JSON h\u1EE3p l\u1EC7."] };
+  }
+  if (!canvasObj.renderList || !Array.isArray(canvasObj.renderList)) {
+    errors.push("Canvas b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 m\u1EA3ng 'renderList' \u0111\u1ECBnh ngh\u0129a th\u1EE9 t\u1EF1 hi\u1EC3n th\u1ECB c\xE1c kh\u1ED1i giao di\u1EC7n (v\xED d\u1EE5: ['0', '1', '2']). Kh\xF4ng \u0111\u01B0\u1EE3c d\xF9ng { blocks: [] }.");
+  } else if (canvasObj.renderList.length === 0) {
+    errors.push("M\u1EA3ng 'renderList' kh\xF4ng \u0111\u01B0\u1EE3c r\u1ED7ng, ph\u1EA3i ch\u1EE9a \xEDt nh\u1EA5t 1 ID kh\u1ED1i giao di\u1EC7n.");
+  }
+  if (!canvasObj.data || typeof canvasObj.data !== "object" || Array.isArray(canvasObj.data)) {
+    errors.push("Canvas b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 \u0111\u1ED1i t\u01B0\u1EE3ng 'data' ch\u1EE9a c\u1EA5u h\xECnh chi ti\u1EBFt c\u1EE7a t\u1EEBng kh\u1ED1i giao di\u1EC7n.");
+  }
+  if (errors.length > 0) {
+    return { isValid: false, errors };
+  }
+  const renderList = canvasObj.renderList.map(
+    (id) => String(id).replace(/^["']+|["']+$/g, "").trim()
+  );
+  const rawData = canvasObj.data;
+  const cleanData = sanitizeCanvasKeys(rawData);
+  for (const blockId of renderList) {
+    if (!(blockId in cleanData)) {
+      errors.push(`Kh\u1ED1i ID '${blockId}' c\xF3 trong 'renderList' nh\u01B0ng kh\xF4ng t\u1ED3n t\u1EA1i trong t\u1EEB \u0111i\u1EC3n 'data'.`);
+    } else {
+      const block = cleanData[blockId];
+      if (!block || typeof block !== "object") {
+        errors.push(`Kh\u1ED1i d\u1EEF li\u1EC7u data['${blockId}'] ph\u1EA3i l\xE0 m\u1ED9t \u0111\u1ED1i t\u01B0\u1EE3ng.`);
+      } else if (block.type === void 0 || typeof block.type !== "number") {
+        errors.push(`Kh\u1ED1i data['${blockId}'] b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 tr\u01B0\u1EDDng 'type' l\xE0 m\xE3 s\u1ED1 nguy\xEAn (Block Type).`);
+      }
+    }
+  }
+  if (isPublishing) {
+    for (const blockId of renderList) {
+      const block = cleanData[blockId];
+      if (!block) continue;
+      if (block.type === 28) {
+        const name = typeof block.name === "string" ? block.name.trim() : "";
+        if (name.length < 2 || name.length > 30) {
+          errors.push(`Kh\u1ED1i Th\xF4ng tin Mini Shop (ID: '${blockId}'): T\xEAn Mini Shop ('name') ph\u1EA3i t\u1EEB 2 \u0111\u1EBFn 30 k\xFD t\u1EF1.`);
+        }
+        const img = block.image;
+        if (!img || typeof img.url !== "string" || !img.url.startsWith("http")) {
+          errors.push(`Kh\u1ED1i Th\xF4ng tin Mini Shop (ID: '${blockId}'): B\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 \u1EA3nh logo v\u1EDBi URL h\u1EE3p l\u1EC7 ('image.url').`);
+        }
+      }
+      if (block.type === 29) {
+        const len = typeof block.length === "number" ? block.length : 0;
+        const html = typeof block.outputHtml === "string" ? block.outputHtml.trim() : "";
+        if (len === 0 && html === "") {
+          errors.push(`Kh\u1ED1i M\xF4 t\u1EA3 (ID: '${blockId}'): Kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 tr\u1ED1ng n\u1ED9i dung m\xF4 t\u1EA3.`);
+        }
+      }
+      if (block.type === 1) {
+        const indexes = Array.isArray(block.indexes) ? block.indexes : [];
+        const images = block.images && typeof block.images === "object" ? block.images : {};
+        for (const idx of indexes) {
+          const img = images[String(idx)];
+          if (img && typeof img.url === "string" && img.url.trim() === "") {
+            errors.push(`Kh\u1ED1i Carousel (ID: '${blockId}'): \u1EA2nh t\u1EA1i ch\u1EC9 m\u1EE5c '${idx}' kh\xF4ng \u0111\u01B0\u1EE3c \u0111\u1EC3 URL r\u1ED7ng.`);
+          }
+        }
+      }
+      if (block.type === 21) {
+        const msg = typeof block.content === "string" ? block.content.trim() : "";
+        if (msg.length === 0 || msg.length > 40) {
+          errors.push(`Kh\u1ED1i Tin nh\u1EAFn m\u1EB7c \u0111\u1ECBnh (ID: '${blockId}'): N\u1ED9i dung tin nh\u1EAFn ph\u1EA3i t\u1EEB 1 \u0111\u1EBFn 40 k\xFD t\u1EF1.`);
+        }
+      }
+    }
+  }
+  const resultCanvas = {
+    version: typeof canvasObj.version === "number" || typeof canvasObj.version === "string" ? canvasObj.version : "1",
+    renderList,
+    data: cleanData,
+    ...canvasObj.freezedTop !== void 0 ? { freezedTop: Number(canvasObj.freezedTop) } : {},
+    ...canvasObj.freezedBottom !== void 0 ? { freezedBottom: Number(canvasObj.freezedBottom) } : {},
+    ...canvasObj.pageTitle !== void 0 ? { pageTitle: String(canvasObj.pageTitle) } : {}
+  };
+  return {
+    isValid: errors.length === 0,
+    errors,
+    data: errors.length === 0 ? resultCanvas : void 0
+  };
+}
 function validateUpdateInstantPageRequest(input) {
   const errors = [];
   if (!input || typeof input !== "object") {
@@ -6388,40 +6673,42 @@ function validateUpdateInstantPageRequest(input) {
       data.active = obj.active;
     }
   }
+  let isPublishing = false;
   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 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;
+      if (st === 1) isPublishing = true;
     }
   }
+  let validatedDraftCanvas;
   if (obj.draft !== void 0 && obj.draft !== null) {
-    if (typeof obj.draft !== "string") {
-      errors.push("Tr\u01B0\u1EDDng 'draft' ph\u1EA3i l\xE0 chu\u1ED7i JSON (JSON-encoded string).");
-    } else if (obj.draft.trim() !== "") {
-      try {
-        JSON.parse(obj.draft);
-        data.draft = obj.draft;
-      } catch (err) {
-        errors.push(`Tr\u01B0\u1EDDng 'draft' kh\xF4ng ph\u1EA3i l\xE0 chu\u1ED7i JSON h\u1EE3p l\u1EC7: ${err.message}`);
-      }
+    const canvasRes = validateInstantPageCanvas(obj.draft, isPublishing);
+    if (!canvasRes.isValid) {
+      errors.push(...canvasRes.errors.map((err) => `[draft] ${err}`));
     } else {
-      data.draft = "";
+      validatedDraftCanvas = canvasRes.data;
+      data.draft = JSON.stringify(canvasRes.data);
     }
   }
+  let validatedContentCanvas;
   if (obj.content !== void 0 && obj.content !== null) {
-    if (typeof obj.content !== "string") {
-      errors.push("Tr\u01B0\u1EDDng 'content' ph\u1EA3i l\xE0 chu\u1ED7i JSON (JSON-encoded string).");
-    } else if (obj.content.trim() !== "") {
-      try {
-        JSON.parse(obj.content);
-        data.content = obj.content;
-      } catch (err) {
-        errors.push(`Tr\u01B0\u1EDDng 'content' kh\xF4ng ph\u1EA3i l\xE0 chu\u1ED7i JSON h\u1EE3p l\u1EC7: ${err.message}`);
-      }
+    const canvasRes = validateInstantPageCanvas(obj.content, isPublishing);
+    if (!canvasRes.isValid) {
+      errors.push(...canvasRes.errors.map((err) => `[content] ${err}`));
     } else {
-      data.content = "";
+      validatedContentCanvas = canvasRes.data;
+      data.content = JSON.stringify(canvasRes.data);
+    }
+  }
+  if (isPublishing) {
+    if (data.draft && !data.content) {
+      data.content = data.draft;
+    } else if (data.content && !data.draft) {
+      data.draft = data.content;
+    } else if (!data.draft && !data.content) {
     }
   }
   const hasUpdateField = data.name !== void 0 || data.oaId !== void 0 || data.active !== void 0 || data.status !== void 0 || data.draft !== void 0 || data.content !== void 0;
@@ -7432,6 +7719,8 @@ var ZaloInstantPageBlockType = /* @__PURE__ */ ((ZaloInstantPageBlockType2) => {
   ZaloInstantPageBlockType2[ZaloInstantPageBlockType2["CALL_HOTLINE_BUTTON"] = 23] = "CALL_HOTLINE_BUTTON";
   ZaloInstantPageBlockType2[ZaloInstantPageBlockType2["KEY_VALUE_TABLE"] = 25] = "KEY_VALUE_TABLE";
   ZaloInstantPageBlockType2[ZaloInstantPageBlockType2["CONSENT_NOTICE"] = 27] = "CONSENT_NOTICE";
+  ZaloInstantPageBlockType2[ZaloInstantPageBlockType2["SHOP_INFO"] = 28] = "SHOP_INFO";
+  ZaloInstantPageBlockType2[ZaloInstantPageBlockType2["SHOP_DESCRIPTION"] = 29] = "SHOP_DESCRIPTION";
   return ZaloInstantPageBlockType2;
 })(ZaloInstantPageBlockType || {});
 var ZaloInstantPageSharePermission = {
@@ -7445,6 +7734,399 @@ var ZaloInstantPageSharePermission = {
   READ_ONLY: 4
 };
 
+// src/helpers/instant-page-factory.ts
+var InstantPageFactory = class {
+  /**
+   * Khởi tạo Canvas hoàn chỉnh từ Template ID (1, 3, 4, 5) được điền sẵn dữ liệu hợp lệ.
+   */
+  static createFromTemplate(templateId, options = {}) {
+    const brandName = options.brandName || "RedAI Official Store";
+    const brandLogoUrl = options.brandLogoUrl || "https://adtima-media.zascdn.me/2023/10/58117541-e206-4f9d-b4cf-69e50f963288.svg";
+    const productName = options.productName || "S\u1EA3n ph\u1EA9m / D\u1ECBch v\u1EE5 \u0110\u1ED9t ph\xE1 2026";
+    const price = options.price ?? 299e3;
+    const rawPrice = options.rawPrice ?? 499e3;
+    const defaultMsg = options.defaultMessage || "T\xF4i mu\u1ED1n t\xECm hi\u1EC3u th\xEAm v\u1EC1 s\u1EA3n ph\u1EA9m n\xE0y";
+    const defaultImages = [
+      "https://adtima-media.zascdn.me/2023/06/84cba4c9-be13-425a-8daa-40e695ca9805.jpg",
+      "https://adtima-media.zascdn.me/2023/06/805587cd-4699-47e6-a9bb-3cbbb4039b40.jpg",
+      "https://adtima-media.zascdn.me/2023/06/aca98d2c-1739-4f03-a366-43a6d6c4ef53.jpg",
+      "https://adtima-media.zascdn.me/2023/06/8cc5692b-2899-4862-9957-d3f66e8778cd.jpg"
+    ];
+    switch (templateId) {
+      case 5: {
+        const carouselImgs = options.carouselImages && options.carouselImages.length > 0 ? options.carouselImages : defaultImages.map((url, i) => ({ url, name: `image-${i + 1}.jpg` }));
+        const indexes = carouselImgs.map((_, i) => String(i));
+        const imagesMap = {};
+        carouselImgs.forEach((img, i) => {
+          imagesMap[String(i)] = {
+            name: img.name || `image-${i + 1}.jpg`,
+            url: img.url
+          };
+        });
+        const descText = options.description || "H\u1EC7 sinh th\xE1i c\xF4ng ngh\u1EC7 t\u1EF1 \u0111\u1ED9ng h\xF3a RedAI. T\xEDch h\u1EE3p \u0111a k\xEAnh Zalo OA, Website & CRM; h\u1ED7 tr\u1EE3 t\u1EF1 \u0111\u1ED9ng ph\u1EA3n h\u1ED3i v\xE0 ch\u1ED1t \u0111\u01A1n 24/7.";
+        return {
+          version: 1,
+          renderList: ["1", "2", "3", "4"],
+          freezedBottom: 4,
+          pageTitle: "Chi ti\u1EBFt",
+          data: {
+            "1": {
+              id: "-1",
+              type: 28,
+              name: brandName,
+              image: {
+                name: "logo.png",
+                url: brandLogoUrl
+              }
+            },
+            "2": {
+              id: "-1",
+              type: 29,
+              delta: {
+                ops: [
+                  { attributes: { bold: true, size: "18px" }, insert: `${brandName}
+` },
+                  { insert: `
+${descText}
+` }
+                ]
+              },
+              outputHtml: `<p><strong style="font-size: 18px;">${brandName}</strong></p><p><br>${descText}</p>`,
+              length: brandName.length + descText.length + 10
+            },
+            "3": {
+              id: "-1",
+              type: 1,
+              indexes,
+              images: imagesMap,
+              videos: {
+                "0": { name: "", thumbnail: "", url: "" }
+              }
+            },
+            "4": {
+              id: "-1",
+              type: 21,
+              content: defaultMsg,
+              marginTop: 0,
+              marginBottom: 0
+            }
+          }
+        };
+      }
+      case 4: {
+        return {
+          version: 4,
+          renderList: ["1", "2", "3"],
+          freezedBottom: 3,
+          data: {
+            "1": {
+              id: "-1",
+              indexes: ["0", "1", "2"],
+              images: {
+                "1": { name: "banner-1.jpg", url: defaultImages[0] },
+                "2": { name: "banner-2.jpg", url: defaultImages[1] }
+              },
+              textEditor: {
+                delta: {
+                  ops: [
+                    { attributes: { bold: true }, insert: `Ch\xE0o m\u1EEBng b\u1EA1n \u0111\u1EBFn v\u1EDBi ${brandName}` },
+                    { insert: "\n\nB\u1EA1n \u0111ang quan t\xE2m gi\u1EA3i ph\xE1p n\xE0o \u0111\u1EC3 chuy\xEAn vi\xEAn h\u1ED7 tr\u1EE3 ngay?\n\n" }
+                  ]
+                },
+                outputHtml: `<p><strong>Ch\xE0o m\u1EEBng b\u1EA1n \u0111\u1EBFn v\u1EDBi ${brandName}</strong></p><p><br></p><p>B\u1EA1n \u0111ang quan t\xE2m gi\u1EA3i ph\xE1p n\xE0o \u0111\u1EC3 chuy\xEAn vi\xEAn h\u1ED7 tr\u1EE3 ngay?</p>`
+              },
+              type: 1,
+              videos: {
+                "0": { name: "", thumbnail: "", url: "" }
+              }
+            },
+            "2": {
+              rows: [{ id: 0, left: "\u01AFu \u0111\xE3i tr\u1EA3i nghi\u1EC7m", right: "D\xF9ng th\u1EED mi\u1EC5n ph\xED" }],
+              type: 25
+            },
+            "3": {
+              list: [
+                "T\u01B0 v\u1EA5n gi\u1EA3i ph\xE1p t\u1EF1 \u0111\u1ED9ng h\xF3a",
+                "B\xE1o gi\xE1 chi ti\u1EBFt g\xF3i doanh nghi\u1EC7p",
+                "H\u1ED7 tr\u1EE3 k\u1EF9 thu\u1EADt 24/7"
+              ],
+              marginBottom: 16,
+              marginTop: 0,
+              type: 20
+            }
+          }
+        };
+      }
+      case 3:
+      case 1:
+      default: {
+        return {
+          version: "1",
+          renderList: [
+            "0",
+            "1",
+            "2",
+            "11",
+            "16",
+            "17",
+            "18",
+            "26",
+            "3",
+            "4",
+            "5",
+            "7",
+            "8",
+            "9",
+            "12",
+            "10",
+            "27"
+          ],
+          freezedTop: 3,
+          freezedBottom: 10,
+          data: {
+            "0": {
+              id: "-1",
+              type: 1,
+              indexes: ["0", "1", "2"],
+              images: {
+                "0": { name: "prod-1.jpg", url: defaultImages[0] },
+                "1": { name: "prod-2.jpg", url: defaultImages[1] },
+                "2": { name: "prod-3.jpg", url: defaultImages[2] }
+              },
+              videos: { "5": { name: "", thumbnail: "", url: "" } }
+            },
+            "1": {
+              id: "-1",
+              discountValue: 35,
+              visible: true,
+              countdownType: 4,
+              type: 2,
+              startDate: Date.now(),
+              loopDays: 1,
+              label: "<p>Th\u1EDDi gian \u01B0u \u0111\xE3i c\xF2n l\u1EA1i:</p>",
+              labelDelta: { ops: [{ insert: "Th\u1EDDi gian \u01B0u \u0111\xE3i c\xF2n l\u1EA1i:\n" }] },
+              marginTop: 8,
+              marginBottom: 0,
+              visibility: { days: true, hours: true, minutes: true, seconds: true }
+            },
+            "2": {
+              type: 19,
+              name: productName,
+              price,
+              rawPrice,
+              marginTop: 8,
+              marginBottom: 8
+            },
+            "3": {
+              id: "-1",
+              type: 18,
+              visible: true,
+              formQuestion: {
+                type: 2,
+                title: "Phi\xEAn b\u1EA3n",
+                isRequired: true,
+                disable: false,
+                answers: [
+                  { type: 1, value: "B\u1EA3n Ti\xEAu Chu\u1EA9n", priority: 0 },
+                  { type: 1, value: "B\u1EA3n Cao C\u1EA5p", priority: 1 }
+                ],
+                description: "",
+                priority: 0
+              },
+              marginTop: 8,
+              marginBottom: 8
+            },
+            "4": {
+              id: "-1",
+              type: 18,
+              visible: true,
+              formQuestion: {
+                type: 2,
+                title: "G\xF3i dung l\u01B0\u1EE3ng",
+                isRequired: true,
+                disable: false,
+                answers: [
+                  { type: 1, value: "G\xF3i 1 Th\xE1ng", priority: 0 },
+                  { type: 1, value: "G\xF3i 1 N\u0103m", priority: 1 }
+                ],
+                description: "",
+                priority: 0
+              },
+              marginTop: 8,
+              marginBottom: 8
+            },
+            "5": {
+              id: "-1",
+              type: 16,
+              formQuestion: {
+                type: 1,
+                title: "S\u1ED1 l\u01B0\u1EE3ng",
+                isRequired: true,
+                disable: false,
+                answers: [{ type: 5, value: "", priority: 0 }],
+                description: "",
+                priority: 0
+              },
+              marginTop: 8,
+              marginBottom: 8
+            },
+            "7": {
+              id: "-1",
+              type: 7,
+              formQuestion: {
+                type: 1,
+                title: "H\u1ECD v\xE0 t\xEAn",
+                isRequired: true,
+                disable: false,
+                answers: [{ type: 7, value: "", placeHolder: "Nh\u1EADp h\u1ECD v\xE0 t\xEAn c\u1EE7a b\u1EA1n", priority: 0 }],
+                description: "",
+                priority: 0
+              },
+              marginTop: 8,
+              marginBottom: 8
+            },
+            "8": {
+              id: "-1",
+              type: 9,
+              formQuestion: {
+                type: 1,
+                title: "S\u1ED1 \u0111i\u1EC7n tho\u1EA1i",
+                isRequired: true,
+                disable: false,
+                answers: [{ type: 13, value: "", placeHolder: "Nh\u1EADp s\u1ED1 \u0111i\u1EC7n tho\u1EA1i li\xEAn h\u1EC7", priority: 0 }],
+                description: "",
+                priority: 0
+              },
+              marginTop: 8,
+              marginBottom: 8
+            },
+            "9": {
+              id: "-1",
+              type: 10,
+              formQuestion: {
+                type: 1,
+                title: "\u0110\u1ECBa ch\u1EC9",
+                isRequired: true,
+                disable: false,
+                answers: [{ type: 15, value: "", placeHolder: "Nh\u1EADp \u0111\u1ECBa ch\u1EC9 giao h\xE0ng ho\u1EB7c nh\u1EADn t\u01B0 v\u1EA5n", priority: 0 }],
+                description: "",
+                priority: 0
+              },
+              marginTop: 8,
+              marginBottom: 8
+            },
+            "10": {
+              id: "-1",
+              type: 8,
+              background: "#008FE5",
+              borderColor: "#000000",
+              borderRadius: 4,
+              borderSize: 1,
+              showBorder: false,
+              formPopup: templateId === 3,
+              fixedPosition: true,
+              image: {
+                name: "cart.svg",
+                url: "https://adtima-media.zascdn.me/2023/10/58117541-e206-4f9d-b4cf-69e50f963288.svg"
+              },
+              content2: "\u0110\u1EB7t h\xE0ng ngay"
+            },
+            "11": {
+              id: "-1",
+              type: 4,
+              delta: {
+                ops: [
+                  { attributes: { color: "#bf2600", bold: true }, insert: "\u01AFU \u0110\xC3I \u0110\u1EB6C BI\u1EC6T H\xD4M NAY\n" },
+                  { insert: `Tr\u1EA3i nghi\u1EC7m tr\u1ECDn b\u1ED9 t\xEDnh n\u0103ng v\u01B0\u1EE3t tr\u1ED9i c\u1EE7a ${productName}.
+` }
+                ]
+              },
+              marginTop: 16,
+              marginBottom: 16,
+              outputHtml: `<p><strong style="color: rgb(191, 38, 0);">\u01AFU \u0110\xC3I \u0110\u1EB6C BI\u1EC6T H\xD4M NAY</strong></p><p>Tr\u1EA3i nghi\u1EC7m tr\u1ECDn b\u1ED9 t\xEDnh n\u0103ng v\u01B0\u1EE3t tr\u1ED9i c\u1EE7a ${productName}.</p>`
+            },
+            "12": {
+              id: "-1",
+              type: 23,
+              actionType: "1",
+              content: "Li\xEAn h\u1EC7 Hotline",
+              borderColor: "#008fe5",
+              borderRadius: 4,
+              borderSize: 2,
+              showBorder: true,
+              fixedPosition: true,
+              visible: true,
+              phone: options.hotline || "",
+              image: {
+                name: "phone.svg",
+                url: "https://adtima-media.zascdn.me/2023/10/03d065a4-90b2-4deb-b684-5ff61407a47d.svg"
+              },
+              color: "#008fe5",
+              background: "#ffffff",
+              marginTop: 16,
+              marginBottom: 16
+            },
+            "16": {
+              id: "-1",
+              type: 6,
+              mediaType: "image",
+              image: { url: defaultImages[0], name: "hero-1.png" },
+              videoSetting: { autoPlay: true, loop: true }
+            },
+            "17": {
+              id: "-1",
+              type: 6,
+              mediaType: "image",
+              image: { url: defaultImages[1], name: "hero-2.png" },
+              videoSetting: { autoPlay: true, loop: true }
+            },
+            "18": {
+              id: "-1",
+              type: 6,
+              mediaType: "image",
+              image: { url: defaultImages[2], name: "hero-3.png" },
+              videoSetting: { autoPlay: true, loop: true }
+            },
+            "26": {
+              id: "-1",
+              type: 14,
+              backgroundColor: "#f2f3f3",
+              textDelta: { ops: [{ attributes: { size: "18px", bold: true }, insert: `${brandName}
+` }] },
+              textHtml: `<p><strong style="font-size: 18px;">${brandName}</strong></p>`,
+              detailings: [
+                {
+                  image: {
+                    url: "https://adtima-media.zascdn.me/2023/10/cba64b4d-0bd5-4504-8b6d-5f2d2562854a.png",
+                    name: "home.png"
+                  },
+                  textDelta: { ops: [{ insert: `\u0110\u1ECBa ch\u1EC9: ${options.address || "H\xE0 N\u1ED9i / TP.HCM"}
+` }] },
+                  textHtml: `<p>\u0110\u1ECBa ch\u1EC9: ${options.address || "H\xE0 N\u1ED9i / TP.HCM"}</p>`
+                },
+                {
+                  image: {
+                    url: "https://adtima-media.zascdn.me/2023/10/d538811f-9232-4ef0-a130-ea2b1dda05d2.png",
+                    name: "phone.png"
+                  },
+                  textDelta: { ops: [{ insert: `Hotline: ${options.hotline || "1900 xxxx"}
+` }] },
+                  textHtml: `<p>Hotline: ${options.hotline || "1900 xxxx"}</p>`
+                }
+              ]
+            },
+            "27": {
+              id: "-1",
+              type: 27,
+              useCustomConsent: false
+            }
+          }
+        };
+      }
+    }
+  }
+};
+
 // src/validators/automated-rules.validator.ts
 var AutomatedRuleScopeEnum = /* @__PURE__ */ ((AutomatedRuleScopeEnum2) => {
   AutomatedRuleScopeEnum2[AutomatedRuleScopeEnum2["Ads"] = 1] = "Ads";
@@ -8180,6 +8862,7 @@ export {
   AutomatedRuleTimeRangeEnum,
   ConversionLabelEnum,
   ConversionUrlTypeEnum,
+  InstantPageFactory,
   MAX_REPORT_RANGE_MS,
   MAX_REPORT_RANGE_SECONDS,
   MemoryZaloSessionStore,
@@ -8259,26 +8942,36 @@ export {
   defaultSharedMemorySessionStore,
   deriveAccountKeyFromZpsid,
   parseZaloCookieInput,
+  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,
   validateEstimateAudienceRequest,
   validateGetInstantPageDetailRequest,
   validateGetInstantPageSharedUserRequest,
+  validateInstantPageCanvas,
   validateListFlowsByOfficialAccountRequest,
   validateListFormLeadsRequest,
   validateListFormsByOfficialAccountRequest,
@@ -8294,10 +8987,18 @@ export {
   validateSearchInstantPagesRequest,
   validateToggleLeadNotificationRequest,
   validateUpdateAdPayload,
+  validateUpdateArticleAd,
+  validateUpdateCommerceAd,
+  validateUpdateDisplayAd,
   validateUpdateFlowRequest,
+  validateUpdateFormAd,
   validateUpdateInstantPageRequest,
   validateUpdateInstantPageSharesRequest,
   validateUpdateLeadNotificationIntervalRequest,
+  validateUpdateMessageAd,
+  validateUpdateOfficialAccountAd,
+  validateUpdateVideoAd,
+  validateUpdateWebsiteAd,
   validateUploadCustomAudiencePhoneListRequest,
   validateUploadMediaRequest,
   validateUpsertCustomReportRequest,