@redonvn/zalo-ads-sdk 0.2.4 → 0.2.7

package/dist/index.mjs

@@ -1531,6 +1531,30 @@ var OP_ZaloAdsDeleteCampaign = {
     "status"
   ]
 };
+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;
@@ -1680,6 +1704,48 @@ 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}`);
+  }
 };
 
 // src/services/account.service.ts
@@ -1834,6 +1900,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",
@@ -1934,6 +2359,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);
   }
@@ -1986,7 +2412,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`). */
@@ -2542,6 +2983,236 @@ var ZaloAutomatedRulesService = class {
   }
 };
 
+// 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."] };
+  }
+  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
 var OP_ZaloAdsListFlowsByOfficialAccount = {
   operationId: "ZaloAds_listFlowsByOfficialAccount",
@@ -2583,6 +3254,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);
   }
@@ -3496,7 +4173,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",
@@ -3570,7 +4541,8 @@ var OP_ZaloFormsListConversationLeads = {
     "keyword",
     "fromTime",
     "labelIds",
-    "sceneIds"
+    "sceneIds",
+    "reason"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -3594,7 +4566,8 @@ var OP_ZaloFormsListFormLeads = {
     "keyword",
     "fromTime",
     "labelIds",
-    "isCommerce"
+    "isCommerce",
+    "reason"
   ],
   "headerFields": [],
   "cookieFields": [],
@@ -3676,10 +4649,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);
   }
@@ -3713,10 +4735,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);
@@ -3724,7 +4756,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) {
@@ -3733,13 +4765,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) {
@@ -3748,13 +4780,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) {
@@ -3763,18 +4795,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
   };
 }
@@ -3784,15 +4816,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;
@@ -3808,7 +4840,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
@@ -3820,13 +4852,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) {
@@ -3835,13 +4867,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) {
@@ -3867,10 +4899,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) {
@@ -3901,10 +4933,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
@@ -3998,7 +5030,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.`);
         }
       }
@@ -4022,7 +5054,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())) {
@@ -4075,7 +5107,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 ?? [],
@@ -4885,8 +5917,10 @@ var ZaloAdsCreateFlowRequest = class {
   messages;
 };
 var ZaloAdsCreateFlowResponse = class {
-  /** 0 khi tạo thành công. */
+  /** 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;
 };
@@ -4992,13 +6026,16 @@ export {
   ZaloAdsUpdateVideoAdRequest,
   ZaloAdsUpdateVideoAdResponse,
   ZaloAudiencesService,
+  ZaloAudiencesValidator,
   ZaloAuthManager,
   ZaloAutomatedRulesService,
   ZaloCampaignsService,
   ZaloChatWidgetService,
   ZaloConversionsService,
   ZaloFlowsService,
+  ZaloFlowsValidator,
   ZaloFormsService,
+  ZaloFormsValidator,
   ZaloInstantPageBlockType,
   ZaloInstantPagesService,
   ZaloInstantPagesValidator,
@@ -5016,8 +6053,20 @@ export {
   deriveAccountKeyFromZpsid,
   parseZaloCookieInput,
   validateCloneInstantPageRequest,
+  validateCreateFlowRequest,
+  validateCreateFormEventAudienceRequest,
+  validateCreateFormRequest,
+  validateCreateLookalikeAudienceRequest,
+  validateCreateMessageOaEventAudienceRequest,
+  validateCreateMessagePersonalEventAudienceRequest,
+  validateCreatePhoneAudienceRequest,
+  validateCreateSavedAudienceRequest,
+  validateEstimateAudienceRequest,
   validateGetInstantPageDetailRequest,
   validateGetInstantPageSharedUserRequest,
+  validateListFlowsByOfficialAccountRequest,
+  validateListFormLeadsRequest,
+  validateListFormsByOfficialAccountRequest,
   validateListInstantPageEditHistoryRequest,
   validateListInstantPageFormRecordsRequest,
   validateListInstantPageLeadsRequest,
@@ -5026,6 +6075,7 @@ export {
   validateListMiniPageTemplatesRequest,
   validateListOfficialAccountsRequest,
   validateSearchInstantPagesRequest,
+  validateUpdateFlowRequest,
   validateUpdateInstantPageRequest,
   validateUpsertInstantPageFormRequest
 };