@redonvn/zalo-ads-sdk 0.2.15 → 0.2.17

package/dist/index.mjs

@@ -284,6 +284,7 @@ function parseZaloCookieInput(rawInput) {
 }
 var ZaloAuthManager = class {
   explicitAccountKey;
+  accountScope;
   zpsid;
   getZpsidFn;
   extraCookies;
@@ -301,6 +302,7 @@ var ZaloAuthManager = class {
       throw new Error("A Fetch implementation is required (Node.js 18+ provides global fetch).");
     }
     this.explicitAccountKey = normalizedOptions.integrationId ?? normalizedOptions.accountKey;
+    this.accountScope = normalizedOptions.accountScope;
     this.extraCookies = { ...normalizedOptions.extraCookies ?? {} };
     if (normalizedOptions.zpsid) {
       const parsed = parseZaloCookieInput(normalizedOptions.zpsid);
@@ -348,6 +350,12 @@ var ZaloAuthManager = class {
   getSessionStore() {
     return this.sessionStore;
   }
+  getAccountScope() {
+    return this.accountScope;
+  }
+  setAccountScope(scope) {
+    this.accountScope = scope;
+  }
   /**
    * Cập nhật `zpsid` mới và xóa toàn bộ cache phiên cũ trên cả RAM lẫn Redis.
    */
@@ -637,11 +645,58 @@ var ZaloAuthManager = class {
       const whoamiJson = await whoamiRes.json().catch(() => null);
       if (whoamiJson?.data) {
         adsProfile = whoamiJson.data;
-        if (adsProfile.id) {
-          cookies["ads_user_id"] = String(adsProfile.id);
+      }
+      if (this.accountScope?.memberId && String(this.accountScope.memberId) !== "0" && !this.accountScope.isRoot && !explicitPlaySession) {
+        const memberIdStr = String(this.accountScope.memberId);
+        const switchUrls = [];
+        if (this.accountScope.accountType === "ACCESSOR") {
+          switchUrls.push(`https://ads.zalo.me/api/ba/personal/login?memberId=${memberIdStr}`);
+        } else if (this.accountScope.accountType === "AGENCY_MASTER" || this.accountScope.accountType === "AGENCY" || this.accountScope.accountType === "AGENCY_SUB_ACCOUNT") {
+          switchUrls.push(`https://ads.zalo.me/api/ba/agency/login?memberId=${memberIdStr}`);
+          switchUrls.push(`https://ads.zalo.me/api/ba/personal/login?memberId=${memberIdStr}`);
+        } else {
+          switchUrls.push(`https://ads.zalo.me/api/ba/agency/login?memberId=${memberIdStr}`);
+          switchUrls.push(`https://ads.zalo.me/api/ba/personal/login?memberId=${memberIdStr}`);
+        }
+        for (const switchUrl of switchUrls) {
+          try {
+            const switchRes = await this.fetchImpl(switchUrl, {
+              method: "GET",
+              headers: {
+                Cookie: this.formatCookieHeader(cookies),
+                "User-Agent": this.userAgent,
+                Accept: "application/json, text/plain, */*"
+              },
+              redirect: "manual"
+            });
+            this.mergeSetCookies(switchRes, cookies);
+            const location = switchRes.headers.get("location") || "";
+            if (location && !location.includes("/client/denied")) {
+              const switchedWhoamiRes = await this.fetchImpl("https://ads.zalo.me/api/whoami", {
+                method: "GET",
+                headers: {
+                  Cookie: this.formatCookieHeader(cookies),
+                  "User-Agent": this.userAgent,
+                  Accept: "application/json"
+                }
+              });
+              this.mergeSetCookies(switchedWhoamiRes, cookies);
+              const switchedJson = await switchedWhoamiRes.json().catch(() => null);
+              if (switchedJson?.data) {
+                adsProfile = switchedJson.data;
+              }
+              break;
+            }
+          } catch {
+          }
         }
+      }
+      if (this.accountScope?.memberId && String(this.accountScope.memberId) !== "0") {
+        cookies["ads_user_id"] = String(this.accountScope.memberId);
       } else if (this.extraCookies?.ads_user_id) {
-        cookies["ads_user_id"] = this.extraCookies.ads_user_id;
+        cookies["ads_user_id"] = String(this.extraCookies.ads_user_id);
+      } else if (adsProfile?.id) {
+        cookies["ads_user_id"] = String(adsProfile.id);
       }
     } else if (domain === "page.ads.zalo.me") {
       await this.followOAuthRedirects("https://page.ads.zalo.me/api/login", cookies, false);
@@ -843,22 +898,31 @@ var ZaloSdkHttpClient = class {
   authByHost = /* @__PURE__ */ new Map();
   authManagerInstance;
   autoRetryOn401;
+  accountScope;
   constructor(options = {}) {
     this.fetchImpl = options.fetch ?? globalThis.fetch;
     if (!this.fetchImpl) throw new Error("A Fetch implementation is required (Node.js 18+ provides global fetch).");
     this.baseUrls = { ...DEFAULT_BASE_URLS, ...options.baseUrls ?? {} };
     this.autoRetryOn401 = options.autoRetryOn401 ?? true;
+    this.accountScope = options.accountScope;
     if (options.authManager) {
       this.authManagerInstance = options.authManager;
+      if (options.accountScope && !this.authManagerInstance.getAccountScope()) {
+        this.authManagerInstance.setAccountScope(options.accountScope);
+      }
     } else if (options.zpsid || options.ssoAuth) {
       const extraCookies = {
         ...options.ssoAuth?.extraCookies ?? {},
         ...options.zoawSek ? { zoaw_sek: options.zoawSek } : {}
       };
+      if (options.accountScope?.memberId && String(options.accountScope.memberId) !== "0") {
+        extraCookies["ads_user_id"] = String(options.accountScope.memberId);
+      }
       this.authManagerInstance = new ZaloAuthManager({
         fetch: this.fetchImpl,
         integrationId: options.integrationId,
         accountKey: options.accountKey,
+        accountScope: options.accountScope ?? options.ssoAuth?.accountScope,
         sessionStore: options.sessionStore,
         redis: options.redis,
         redisKeyPrefix: options.redisKeyPrefix,
@@ -975,6 +1039,16 @@ var ZaloSdkHttpClient = class {
     add("header_param", operation.headerFields);
     add("cookie_param", operation.cookieFields);
     add("body", operation.bodyFields);
+    if (this.accountScope && output.query_param) {
+      const query = output.query_param;
+      const isAgencyContext = this.accountScope.accountType === "AGENCY_SUB_ACCOUNT" || this.accountScope.accountType === "AGENCY_MASTER" || this.accountScope.accountType === "AGENCY" || Boolean(this.accountScope.agencyId);
+      if (operation.queryFields.includes("agencyId") && query.agencyId === void 0 && isAgencyContext && this.accountScope.agencyId) {
+        query.agencyId = Number(this.accountScope.agencyId);
+      }
+      if (operation.queryFields.includes("createdBy") && query.createdBy === void 0 && this.accountScope.accountType === "AGENCY_SUB_ACCOUNT" && this.accountScope.memberId && String(this.accountScope.memberId) !== "0") {
+        query.createdBy = Number(this.accountScope.memberId);
+      }
+    }
     return output;
   }
   async resolveFile(input) {
@@ -3358,6 +3432,18 @@ var OP_ZaloAdsListAgencyCustomersWithBudget = {
   "cookieFields": [],
   "bodyFields": []
 };
+var OP_ZaloAdsGetApiBaAgencyEmployees = {
+  "operationId": "ZaloAds_getApiBaAgencyEmployees",
+  "method": "GET",
+  "endpoint": "/api/ba/agency/employees",
+  "baseUrl": "https://ads.zalo.me",
+  "binaryFields": [],
+  "pathFields": [],
+  "queryFields": [],
+  "headerFields": [],
+  "cookieFields": [],
+  "bodyFields": []
+};
 var OP_ZaloAdsGetApiNotifiesHeader = {
   "operationId": "ZaloAds_getApiNotifiesHeader",
   "method": "GET",
@@ -3407,6 +3493,9 @@ var ZaloAccountService = class {
     };
     return this.client.requestWithoutBody(OP_ZaloAdsListAgencyCustomersWithBudget, this.client.toTransportInput(OP_ZaloAdsListAgencyCustomersWithBudget, normalized), options);
   }
+  getApiBaAgencyEmployees(request = {}, options) {
+    return this.client.requestWithoutBody(OP_ZaloAdsGetApiBaAgencyEmployees, this.client.toTransportInput(OP_ZaloAdsGetApiBaAgencyEmployees, request), options);
+  }
   getApiNotifiesHeader(request = {}, options) {
     return this.client.requestWithoutBody(OP_ZaloAdsGetApiNotifiesHeader, this.client.toTransportInput(OP_ZaloAdsGetApiNotifiesHeader, request), options);
   }
@@ -3429,6 +3518,10 @@ var ZaloAccountService = class {
   getBaAccountAllGrantedMembers(...args) {
     return this.getApiBaAccountAllgrantedmembers(...args);
   }
+  /** Danh sách nhân viên trực thuộc Agency */
+  getBaAgencyEmployees(...args) {
+    return this.getApiBaAgencyEmployees(...args);
+  }
   /** Thông báo trên thanh tiêu đề */
   getNotifiesHeader(...args) {
     return this.getApiNotifiesHeader(...args);
@@ -3862,7 +3955,6 @@ var ZaloReportsService = class {
   getReportapiV3Campaigns(request, options) {
     const normalized = {
       filter: "[]",
-      agencyId: 0,
       ...request
     };
     return this.client.requestWithoutBody(OP_ZaloAdsGetReportapiV3Campaigns, this.client.toTransportInput(OP_ZaloAdsGetReportapiV3Campaigns, normalized), options);
@@ -5170,6 +5262,12 @@ var ZaloAdsService = class extends ZaloCampaignsService {
   listAgencyCustomersWithBudget(request = { limit: 15, offset: 0, joinDateAsc: true }, options) {
     return this.account.listAgencyCustomersWithBudget(request, options);
   }
+  getApiBaAgencyEmployees(request = {}, options) {
+    return this.account.getApiBaAgencyEmployees(request, options);
+  }
+  getBaAgencyEmployees(...args) {
+    return this.account.getBaAgencyEmployees(...args);
+  }
   getApiNotifiesHeader(request = {}, options) {
     return this.account.getApiNotifiesHeader(request, options);
   }
@@ -7068,6 +7166,21 @@ var ZaloAdsSdk = class {
   get authManager() {
     return this.client.authManager;
   }
+  /**
+   * Phạm vi tài khoản quảng cáo cô lập (Isolated Workspace) đang gắn với instance SDK.
+   */
+  get accountScope() {
+    return this.client.accountScope;
+  }
+  /**
+   * Cập nhật phạm vi tài khoản quảng cáo cô lập.
+   */
+  setAccountScope(scope) {
+    this.client.accountScope = scope;
+    if (this.client.authManager) {
+      this.client.authManager.setAccountScope(scope);
+    }
+  }
   /**
    * Cập nhật cookie `zpsid` gốc (hoặc chuỗi Cookie trình duyệt) để tự động xác thực cho toàn bộ các domain Zalo Ads.
    */
@@ -7147,6 +7260,9 @@ var ZaloAdsIntegrationManager = class {
         existing.sdk.setZpsid(request.zpsid);
         existing.zpsid = cleanZpsid;
       }
+      if (request.accountScope) {
+        existing.sdk.setAccountScope(request.accountScope);
+      }
       this.sdkPool.set(integrationId, existing);
       return existing.sdk;
     }
@@ -7161,15 +7277,20 @@ var ZaloAdsIntegrationManager = class {
       ...request.extraCookies ?? {},
       ...request.zoawSek ? { zoaw_sek: request.zoawSek } : {}
     };
+    if (request.accountScope?.memberId && String(request.accountScope.memberId) !== "0") {
+      extraCookies.ads_user_id = String(request.accountScope.memberId);
+    }
     const sdk = new ZaloAdsSdk({
       integrationId,
       zpsid: cleanZpsid,
+      accountScope: request.accountScope,
       sessionStore: this.sessionStore,
       fetch: this.fetchImpl,
       baseUrls: this.baseUrls,
       ssoAuth: {
         integrationId,
         zpsid: cleanZpsid,
+        accountScope: request.accountScope,
         extraCookies,
         sessionStore: this.sessionStore,
         sessionTtlMs: this.sessionTtlMs,
@@ -7253,7 +7374,8 @@ var ZaloAdsIntegrationManager = class {
       integrationId: accountKey,
       zpsid: params.zpsid,
       zoawSek: params.zoawSek,
-      extraCookies: params.extraCookies
+      extraCookies: params.extraCookies,
+      accountScope: params.accountScope
     });
     const sessions = await sdk.authenticateAll([
       "ads.zalo.me",