@warriorteam/redai-zalo-sdk 1.19.0 → 1.21.0

package/CHANGELOG.md

@@ -5,6 +5,135 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.21.0] - 2025-08-29
+
+### 🚀 NEW FEATURES
+
+#### Enhanced Broadcast Service - Multiple Messages Support
+- **ADDED**: `sendMultipleBroadcastMessages()` - Gửi nhiều broadcast messages với nhiều attachment IDs
+- **MODES**: Hỗ trợ 2 chế độ gửi: `sequential` (tuần tự) và `parallel` (song song)
+- **DELAY**: Tùy chỉnh delay giữa các tin nhắn cho sequential mode
+- **PROGRESS**: Real-time progress tracking với callback `onProgress`
+- **RESILIENT**: Error isolation - lỗi của 1 tin không ảnh hưởng các tin khác
+- **SMART**: Tự động loại bỏ attachment IDs trùng lặp
+
+#### Advanced Campaign Management
+- **SEQUENTIAL**: Gửi tuần tự với delay tùy chỉnh để tránh rate limit
+- **PARALLEL**: Gửi song song để tối ưu tốc độ
+- **MONITORING**: Theo dõi real-time số tin thành công/thất bại
+- **STATISTICS**: Thống kê chi tiết thời gian thực hiện và success rate
+
+### 📊 NEW INTERFACES
+
+#### Multiple Broadcast Types
+- **ADDED**: `BroadcastMessageResult` - Kết quả từng tin nhắn broadcast
+- **ADDED**: `MultipleBroadcastProgress` - Interface cho progress tracking
+- **ADDED**: `MultipleBroadcastResult` - Kết quả tổng thể campaign
+- **ENHANCED**: Progress callback với detailed metrics
+
+### 🛡️ ENHANCED ERROR HANDLING
+- **ISOLATION**: Lỗi của 1 attachment không làm dừng campaign
+- **DETAILED**: Chi tiết lỗi cho từng tin nhắn riêng biệt
+- **VALIDATION**: Kiểm tra attachment IDs array không rỗng
+- **DEDUPLICATION**: Tự động loại bỏ attachment IDs trùng lặp
+
+### 📚 UPDATED DOCUMENTATION & EXAMPLES
+
+#### Enhanced Documentation
+- **UPDATED**: `docs/BROADCAST_SERVICE.md` - Thêm multiple messages examples
+- **UPDATED**: `docs/API_REFERENCE.md` - Thêm sendMultipleBroadcastMessages method
+- **UPDATED**: `README.md` - Thêm ví dụ multiple broadcast
+
+#### Enhanced Examples
+- **UPDATED**: `examples/broadcast-example.ts` - Thêm sequential và parallel examples
+- **EXAMPLES**: Progress tracking và error handling
+- **EXAMPLES**: Campaign management với statistics
+
+#### Enhanced Tests
+- **UPDATED**: `tests/broadcast.test.ts` - Comprehensive tests cho multiple messages
+- **COVERAGE**: Test sequential và parallel modes
+- **COVERAGE**: Test progress callback và error handling
+- **COVERAGE**: Test duplicate removal và validation
+
+### 🔧 API ENHANCEMENTS
+- **FLEXIBLE**: Chọn mode phù hợp với use case (sequential vs parallel)
+- **CONFIGURABLE**: Delay tùy chỉnh cho rate limiting
+- **OBSERVABLE**: Progress tracking cho campaign monitoring
+- **ROBUST**: Comprehensive error handling và validation
+
+## [1.20.0] - 2025-08-29
+
+### 🚀 NEW FEATURES
+
+#### Broadcast Service - Gửi Tin Truyền Thông Broadcast
+- **ADDED**: `BroadcastService` - Service mới để gửi tin truyền thông broadcast đến nhiều người dùng
+- **ADDED**: `sendBroadcastMessage()` - API gửi broadcast với targeting criteria
+- **ADDED**: `createBroadcastTarget()` - Helper tạo targeting criteria dễ dàng
+- **SUPPORT**: Targeting theo tuổi, giới tính, tỉnh thành, miền, platform
+- **COMPLIANCE**: Tuân thủ 100% Zalo API specification
+
+#### Advanced Targeting System
+- **AGES**: 8 nhóm tuổi (0-12, 13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65+)
+- **GENDER**: 3 lựa chọn (All, Male, Female)
+- **CITIES**: 63 tỉnh thành Việt Nam với mapping chính xác
+- **LOCATIONS**: 3 miền (North, Central, South)
+- **PLATFORMS**: 3 hệ điều hành (iOS, Android, Windows Phone)
+
+#### Helper Methods & Constants
+- **ADDED**: `getCityCodes()` - Lấy mapping tỉnh thành
+- **ADDED**: `getAgeGroupCodes()` - Lấy mã nhóm tuổi
+- **ADDED**: `getGenderCodes()` - Lấy mã giới tính
+- **ADDED**: `getLocationCodes()` - Lấy mã miền
+- **ADDED**: `getPlatformCodes()` - Lấy mã platform
+- **CONSTANTS**: Đầy đủ constants cho tất cả targeting criteria
+
+### 📊 NEW INTERFACES
+
+#### Broadcast Types
+- **ADDED**: `BroadcastTarget` - Interface cho targeting criteria
+- **ADDED**: `BroadcastRecipient` - Interface cho thông tin người nhận
+- **ADDED**: `BroadcastMessage` - Interface cho tin nhắn broadcast
+- **ADDED**: `BroadcastRequest` - Request payload structure
+- **ADDED**: `BroadcastResponse` - Response structure với message_id
+- **ADDED**: `BroadcastMessageElement` - Element structure cho article attachment
+
+### 🛡️ VALIDATION & ERROR HANDLING
+- **VALIDATION**: Kiểm tra targeting criteria hợp lệ
+- **VALIDATION**: Kiểm tra attachment_id bắt buộc
+- **ERROR**: Comprehensive error messages cho từng trường hợp
+- **TYPE SAFETY**: Full TypeScript support với IntelliSense
+
+### 📚 DOCUMENTATION & EXAMPLES
+
+#### New Documentation
+- **ADDED**: `docs/BROADCAST_SERVICE.md` - Hướng dẫn chi tiết BroadcastService
+- **UPDATED**: `docs/API_REFERENCE.md` - Thêm BroadcastService methods
+- **UPDATED**: `README.md` - Thêm Broadcast Service examples
+
+#### New Examples
+- **ADDED**: `examples/broadcast-example.ts` - Ví dụ sử dụng BroadcastService
+- **EXAMPLES**: Targeting đơn giản và phức tạp
+- **EXAMPLES**: Error handling và best practices
+
+#### New Tests
+- **ADDED**: `tests/broadcast.test.ts` - Unit tests cho BroadcastService
+- **COVERAGE**: Test targeting criteria creation
+- **COVERAGE**: Test broadcast message sending
+- **COVERAGE**: Test validation logic
+
+### 🔧 SDK INTEGRATION
+- **INTEGRATION**: Tích hợp BroadcastService vào main ZaloSDK class
+- **ACCESS**: Sử dụng qua `zalo.broadcast`
+- **EXPORT**: Export tất cả types và service từ main index
+
+### 📋 API SPECIFICATION COMPLIANCE
+- **ENDPOINT**: `https://openapi.zalo.me/v2.0/oa/message` ✅
+- **METHOD**: POST với JSON payload ✅
+- **HEADERS**: access_token authentication ✅
+- **TARGETING**: recipient.target với đầy đủ criteria ✅
+- **MESSAGE**: Template type "media" với article attachment ✅
+- **RESPONSE**: message_id, error, message structure ✅
+
 ## [1.19.0] - 2025-08-29
 
 ### 🚀 NEW FEATURES

package/README.md

@@ -4,6 +4,7 @@ A comprehensive TypeScript/JavaScript SDK for Zalo APIs, providing easy-to-use i
 
 - **Official Account (OA) API** - Manage your Zalo Official Account
 - **Consultation Service** - Send customer support messages within 48-hour window
+- **Broadcast Service** - Send mass communication messages with targeting criteria
 - **Zalo Notification Service (ZNS)** - Send template-based notification messages
 - **Social API** - Access user social information and authentication
 - **Group Message Framework (GMF)** - Send messages to Zalo groups
@@ -377,6 +378,56 @@ For support and questions:
 - Create an issue on GitHub
 - Contact RedAI team
 
+### Broadcast Service (Mass Communication)
+
+```typescript
+// Create targeting criteria
+const target = zalo.broadcast.createBroadcastTarget({
+  gender: "FEMALE",           // Target female users
+  ages: ["18-24", "25-34"],   // Age 18-34
+  cities: ["Hồ Chí Minh", "Hà Nội"], // Ho Chi Minh City and Hanoi
+  platforms: ["ANDROID", "IOS"]      // Android and iOS users
+});
+
+// Send broadcast message
+const result = await zalo.broadcast.sendBroadcastMessage(
+  accessToken,
+  { target },
+  "article-attachment-id"
+);
+
+console.log("Broadcast sent:", result.data.message_id);
+
+// Simple city targeting
+const hcmTarget = zalo.broadcast.createBroadcastTarget({
+  cities: ["Hồ Chí Minh"]
+});
+
+await zalo.broadcast.sendBroadcastMessage(
+  accessToken,
+  { target: hcmTarget },
+  "article-id"
+);
+
+// Send multiple broadcast messages
+const attachmentIds = ["article-1", "article-2", "article-3"];
+
+const multipleResult = await zalo.broadcast.sendMultipleBroadcastMessages(
+  accessToken,
+  { target: hcmTarget },
+  attachmentIds,
+  {
+    mode: 'sequential',
+    delay: 2000, // 2 seconds between messages
+    onProgress: (progress) => {
+      console.log(`Progress: ${progress.completed}/${progress.total}`);
+    }
+  }
+);
+
+console.log(`Sent ${multipleResult.successfulMessages}/${multipleResult.totalMessages} messages`);
+```
+
 ### Consultation Service (Customer Support)
 
 ```typescript

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from "./types/oa";
 export * from "./types/user";
 export * from "./types/zns";
 export * from "./types/article";
+export * from "./types/broadcast";
 export * from "./constants/zns.constants";
 export type { BaseMessage, TextMessage, ImageMessage, FileMessage, StickerMessage, TemplateMessage as MessageTemplateMessage, ReactionMessage as MessageReactionMessage, Message, MessageRecipient, SendMessageRequest, SendMessageResponse, UploadFileResponse, MessageStatus, MessageEvent, ConsultationTextMessage, ConsultationImageMessage, ConsultationFileMessage, ConsultationStickerMessage, ConsultationQuoteMessage, ConsultationRequestInfoMessage, TransactionMessage, PromotionMessage, AnonymousTextMessage, AnonymousImageMessage, AnonymousFileMessage, AnonymousStickerMessage, MiniAppMessage, ExtendedMessage, } from "./types/message";
 export * from "./types/webhook";
@@ -36,6 +37,7 @@ export { TransactionService } from "./services/transaction.service";
 export { PromotionService } from "./services/promotion.service";
 export { GeneralMessageService } from "./services/general-message.service";
 export { MessageManagementService, UploadFileResult, UploadImageResult, MessageQuotaInfo, ConversationMessage, Conversation, MessagePagination } from "./services/message-management.service";
+export { BroadcastService } from "./services/broadcast.service";
 export { ZaloSDK } from "./zalo-sdk";
 export { ZaloSDK as default } from "./zalo-sdk";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -24,7 +24,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = exports.ZaloSDK = exports.MessageManagementService = exports.GeneralMessageService = exports.PromotionService = exports.TransactionService = exports.ConsultationService = exports.VideoUploadService = exports.ArticleService = exports.GroupManagementService = exports.GroupMessageService = exports.ZNSService = exports.UserService = exports.OAService = exports.AuthService = exports.ZaloClient = exports.BaseClient = exports.getMessageDirection = exports.isOAToGroupMessageEvent = exports.isOAToUserMessageEvent = exports.isGroupMessageEvent = exports.isUserMessageEvent = exports.isFromPersonal = exports.isFromGroup = exports.isOASendGroupGifEvent = exports.isOASendGroupStickerEvent = exports.isOASendGroupFileEvent = exports.isOASendGroupImageEvent = exports.isOASendGroupTextEvent = exports.isOASendGifEvent = exports.isOASendStickerEvent = exports.isOASendFileEvent = exports.isOASendImageEvent = exports.isOASendTextEvent = exports.isUserGroupMessageEvent = exports.isUserSendGroupFileEvent = exports.isUserSendGroupAudioEvent = exports.isUserSendGroupVideoEvent = exports.isUserSendGroupImageEvent = exports.isUserSendGroupTextEvent = void 0;
+exports.default = exports.ZaloSDK = exports.BroadcastService = exports.MessageManagementService = exports.GeneralMessageService = exports.PromotionService = exports.TransactionService = exports.ConsultationService = exports.VideoUploadService = exports.ArticleService = exports.GroupManagementService = exports.GroupMessageService = exports.ZNSService = exports.UserService = exports.OAService = exports.AuthService = exports.ZaloClient = exports.BaseClient = exports.getMessageDirection = exports.isOAToGroupMessageEvent = exports.isOAToUserMessageEvent = exports.isGroupMessageEvent = exports.isUserMessageEvent = exports.isFromPersonal = exports.isFromGroup = exports.isOASendGroupGifEvent = exports.isOASendGroupStickerEvent = exports.isOASendGroupFileEvent = exports.isOASendGroupImageEvent = exports.isOASendGroupTextEvent = exports.isOASendGifEvent = exports.isOASendStickerEvent = exports.isOASendFileEvent = exports.isOASendImageEvent = exports.isOASendTextEvent = exports.isUserGroupMessageEvent = exports.isUserSendGroupFileEvent = exports.isUserSendGroupAudioEvent = exports.isUserSendGroupVideoEvent = exports.isUserSendGroupImageEvent = exports.isUserSendGroupTextEvent = void 0;
 // Export types
 __exportStar(require("./types/common"), exports);
 __exportStar(require("./types/auth"), exports);
@@ -32,6 +32,7 @@ __exportStar(require("./types/oa"), exports);
 __exportStar(require("./types/user"), exports);
 __exportStar(require("./types/zns"), exports);
 __exportStar(require("./types/article"), exports);
+__exportStar(require("./types/broadcast"), exports);
 // Export ZNS constants and helpers
 __exportStar(require("./constants/zns.constants"), exports);
 // Export webhook types (avoiding conflicts with message and group types)
@@ -98,6 +99,8 @@ var general_message_service_1 = require("./services/general-message.service");
 Object.defineProperty(exports, "GeneralMessageService", { enumerable: true, get: function () { return general_message_service_1.GeneralMessageService; } });
 var message_management_service_1 = require("./services/message-management.service");
 Object.defineProperty(exports, "MessageManagementService", { enumerable: true, get: function () { return message_management_service_1.MessageManagementService; } });
+var broadcast_service_1 = require("./services/broadcast.service");
+Object.defineProperty(exports, "BroadcastService", { enumerable: true, get: function () { return broadcast_service_1.BroadcastService; } });
 // Export main SDK class
 var zalo_sdk_1 = require("./zalo-sdk");
 Object.defineProperty(exports, "ZaloSDK", { enumerable: true, get: function () { return zalo_sdk_1.ZaloSDK; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,iDAA+B;AAC/B,+CAA6B;AAC7B,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,kDAAgC;AAEhC,mCAAmC;AACnC,4DAA0C;AAkC1C,yEAAyE;AACzE,kDAAgC;AAEhC,yEAAyE;AACzE,mDAoB6B;AAlB3B,uHAAA,wBAAwB,OAAA;AACxB,wHAAA,yBAAyB,OAAA;AACzB,wHAAA,yBAAyB,OAAA;AACzB,wHAAA,yBAAyB,OAAA;AACzB,uHAAA,wBAAwB,OAAA;AACxB,sHAAA,uBAAuB,OAAA;AACvB,gHAAA,iBAAiB,OAAA;AACjB,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AACjB,mHAAA,oBAAoB,OAAA;AACpB,+GAAA,gBAAgB,OAAA;AAChB,qHAAA,sBAAsB,OAAA;AACtB,sHAAA,uBAAuB,OAAA;AACvB,qHAAA,sBAAsB,OAAA;AACtB,wHAAA,yBAAyB,OAAA;AACzB,oHAAA,qBAAqB,OAAA;AACrB,0GAAA,WAAW,OAAA;AACX,6GAAA,cAAc,OAAA;AAEhB,kCAAkC;AAClC,2CAMyB;AALvB,6GAAA,kBAAkB,OAAA;AAClB,8GAAA,mBAAmB,OAAA;AACnB,iHAAA,sBAAsB,OAAA;AACtB,kHAAA,uBAAuB,OAAA;AACvB,8GAAA,mBAAmB,OAAA;AAoFrB,iBAAiB;AACjB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AAEnB,kBAAkB;AAClB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,oDAAkD;AAAzC,uGAAA,SAAS,OAAA;AAClB,2GAA2G;AAC3G,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,+DAA+D;AAC/D,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AACnB,0EAAuE;AAA9D,4HAAA,mBAAmB,OAAA;AAC5B,gFAA6E;AAApE,kIAAA,sBAAsB,OAAA;AAC/B,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAE3B,iDAAiD;AACjD,wEAAsE;AAA7D,2HAAA,mBAAmB,OAAA;AAC5B,sEAAoE;AAA3D,yHAAA,kBAAkB,OAAA;AAC3B,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,8EAA2E;AAAlE,gIAAA,qBAAqB,OAAA;AAC9B,oFAQ+C;AAP7C,sIAAA,wBAAwB,OAAA;AAS1B,wBAAwB;AACxB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAEhB,iBAAiB;AACjB,uCAAgD;AAAvC,mGAAA,OAAO,OAAW"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,iDAA+B;AAC/B,+CAA6B;AAC7B,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,kDAAgC;AAChC,oDAAkC;AAElC,mCAAmC;AACnC,4DAA0C;AAkC1C,yEAAyE;AACzE,kDAAgC;AAEhC,yEAAyE;AACzE,mDAoB6B;AAlB3B,uHAAA,wBAAwB,OAAA;AACxB,wHAAA,yBAAyB,OAAA;AACzB,wHAAA,yBAAyB,OAAA;AACzB,wHAAA,yBAAyB,OAAA;AACzB,uHAAA,wBAAwB,OAAA;AACxB,sHAAA,uBAAuB,OAAA;AACvB,gHAAA,iBAAiB,OAAA;AACjB,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AACjB,mHAAA,oBAAoB,OAAA;AACpB,+GAAA,gBAAgB,OAAA;AAChB,qHAAA,sBAAsB,OAAA;AACtB,sHAAA,uBAAuB,OAAA;AACvB,qHAAA,sBAAsB,OAAA;AACtB,wHAAA,yBAAyB,OAAA;AACzB,oHAAA,qBAAqB,OAAA;AACrB,0GAAA,WAAW,OAAA;AACX,6GAAA,cAAc,OAAA;AAEhB,kCAAkC;AAClC,2CAMyB;AALvB,6GAAA,kBAAkB,OAAA;AAClB,8GAAA,mBAAmB,OAAA;AACnB,iHAAA,sBAAsB,OAAA;AACtB,kHAAA,uBAAuB,OAAA;AACvB,8GAAA,mBAAmB,OAAA;AAoFrB,iBAAiB;AACjB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,qDAAmD;AAA1C,yGAAA,UAAU,OAAA;AAEnB,kBAAkB;AAClB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,oDAAkD;AAAzC,uGAAA,SAAS,OAAA;AAClB,2GAA2G;AAC3G,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,+DAA+D;AAC/D,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AACnB,0EAAuE;AAA9D,4HAAA,mBAAmB,OAAA;AAC5B,gFAA6E;AAApE,kIAAA,sBAAsB,OAAA;AAC/B,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAE3B,iDAAiD;AACjD,wEAAsE;AAA7D,2HAAA,mBAAmB,OAAA;AAC5B,sEAAoE;AAA3D,yHAAA,kBAAkB,OAAA;AAC3B,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,8EAA2E;AAAlE,gIAAA,qBAAqB,OAAA;AAC9B,oFAQ+C;AAP7C,sIAAA,wBAAwB,OAAA;AAQ1B,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AAEzB,wBAAwB;AACxB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAEhB,iBAAiB;AACjB,uCAAgD;AAAvC,mGAAA,OAAO,OAAW"}

package/dist/services/broadcast.service.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Broadcast Service for Zalo Official Account
+ *
+ * Gửi tin Truyền thông Broadcast đến nhiều người dùng dựa trên tiêu chí targeting
+ * API: https://openapi.zalo.me/v2.0/oa/message
+ *
+ * TÍNH NĂNG:
+ * 1. GỬI TIN BROADCAST:
+ *    - Gửi tin nhắn đến nhiều người dùng cùng lúc
+ *    - Targeting theo tuổi, giới tính, địa điểm, platform
+ *    - Chỉ hỗ trợ template type "media" với article attachment
+ *
+ * 2. TARGETING CRITERIA:
+ *    - Ages: Nhóm tuổi (0-12, 13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65+)
+ *    - Gender: Giới tính (All, Male, Female)
+ *    - Cities: Tỉnh thành cụ thể (63 tỉnh thành Việt Nam)
+ *    - Locations: Miền (Bắc, Trung, Nam)
+ *    - Platform: Hệ điều hành (iOS, Android, Windows Phone)
+ *
+ * 3. GIỚI HẠN:
+ *    - Chỉ gửi được article attachment
+ *    - Cần có quyền broadcast từ Zalo
+ *    - Tuân thủ chính sách spam và nội dung
+ *
+ * LỖI THƯỜNG GẶP:
+ * - 3001: Không có quyền gửi broadcast
+ * - 3002: Article attachment không tồn tại
+ * - 3003: Targeting criteria không hợp lệ
+ * - 3004: Vượt quá giới hạn broadcast
+ * - 3005: Nội dung vi phạm chính sách
+ */
+import { ZaloClient } from '../clients/zalo-client';
+import { BroadcastResponse, BroadcastTarget, BroadcastRecipient, BROADCAST_CITY_CODES, BROADCAST_AGE_CODES, BROADCAST_GENDER_CODES, BROADCAST_LOCATION_CODES, BROADCAST_PLATFORM_CODES, MultipleBroadcastResult, MultipleBroadcastProgress } from '../types/broadcast';
+export declare class BroadcastService {
+    private readonly client;
+    private readonly broadcastApiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Gửi tin nhắn broadcast đến nhiều người dùng
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin targeting người nhận
+     * @param attachmentId ID của article attachment
+     * @returns Thông tin tin nhắn broadcast đã gửi
+     */
+    sendBroadcastMessage(accessToken: string, recipient: BroadcastRecipient, attachmentId: string): Promise<BroadcastResponse>;
+    /**
+     * Tạo broadcast target với các tiêu chí targeting
+     * @param criteria Các tiêu chí targeting
+     * @returns BroadcastTarget object
+     */
+    createBroadcastTarget(criteria: {
+        ages?: string[];
+        gender?: "ALL" | "MALE" | "FEMALE";
+        cities?: string[];
+        locations?: ("NORTH" | "CENTRAL" | "SOUTH")[];
+        platforms?: ("IOS" | "ANDROID" | "WINDOWS_PHONE")[];
+    }): BroadcastTarget;
+    /**
+     * Validate broadcast request parameters
+     * @param recipient Broadcast recipient
+     * @param attachmentId Article attachment ID
+     */
+    private validateBroadcastRequest;
+    /**
+     * Get available city codes for targeting
+     * @returns Object mapping city names to codes
+     */
+    getCityCodes(): typeof BROADCAST_CITY_CODES;
+    /**
+     * Get available age group codes for targeting
+     * @returns Object mapping age groups to codes
+     */
+    getAgeGroupCodes(): typeof BROADCAST_AGE_CODES;
+    /**
+     * Get available gender codes for targeting
+     * @returns Object mapping genders to codes
+     */
+    getGenderCodes(): typeof BROADCAST_GENDER_CODES;
+    /**
+     * Get available location codes for targeting
+     * @returns Object mapping locations to codes
+     */
+    getLocationCodes(): typeof BROADCAST_LOCATION_CODES;
+    /**
+     * Get available platform codes for targeting
+     * @returns Object mapping platforms to codes
+     */
+    getPlatformCodes(): typeof BROADCAST_PLATFORM_CODES;
+    /**
+     * Gửi nhiều tin nhắn broadcast với nhiều attachment IDs
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin targeting người nhận
+     * @param attachmentIds Danh sách các article attachment IDs
+     * @param options Tùy chọn gửi (delay giữa các tin, parallel/sequential)
+     * @returns Danh sách kết quả gửi broadcast
+     */
+    sendMultipleBroadcastMessages(accessToken: string, recipient: BroadcastRecipient, attachmentIds: string[], options?: {
+        delay?: number;
+        mode?: 'parallel' | 'sequential';
+        onProgress?: (progress: MultipleBroadcastProgress) => void;
+    }): Promise<MultipleBroadcastResult>;
+    /**
+     * Sleep utility for delays
+     * @param ms Milliseconds to sleep
+     */
+    private sleep;
+}
+//# sourceMappingURL=broadcast.service.d.ts.map

package/dist/services/broadcast.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.service.d.ts","sourceRoot":"","sources":["../../src/services/broadcast.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAEL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAGlB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EAE1B,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6C;gBAEhD,MAAM,EAAE,UAAU;IAE/C;;;;;;OAMG;IACU,oBAAoB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,kBAAkB,EAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC;IA2D7B;;;;OAIG;IACI,qBAAqB,CAAC,QAAQ,EAAE;QACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,EAAE,CAAC,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;QAC9C,SAAS,CAAC,EAAE,CAAC,KAAK,GAAG,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC;KACrD,GAAG,eAAe;IA+DnB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA2BhC;;;OAGG;IACI,YAAY,IAAI,OAAO,oBAAoB;IAIlD;;;OAGG;IACI,gBAAgB,IAAI,OAAO,mBAAmB;IAIrD;;;OAGG;IACI,cAAc,IAAI,OAAO,sBAAsB;IAItD;;;OAGG;IACI,gBAAgB,IAAI,OAAO,wBAAwB;IAI1D;;;OAGG;IACI,gBAAgB,IAAI,OAAO,wBAAwB;IAI1D;;;;;;;OAOG;IACU,6BAA6B,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,kBAAkB,EAC7B,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;QACjC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,yBAAyB,KAAK,IAAI,CAAC;KAC5D,GACA,OAAO,CAAC,uBAAuB,CAAC;IAqKnC;;;OAGG;IACH,OAAO,CAAC,KAAK;CAGd"}