@warriorteam/redai-zalo-sdk 1.18.0 → 1.20.0

package/CHANGELOG.md

@@ -5,6 +5,162 @@ 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.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
+
+#### Group Message List APIs - Gửi Danh Sách Tin Nhắn Group
+- **ADDED**: `sendMessageListToGroup()` - Gửi danh sách tin nhắn tới 1 group với delay tùy chỉnh
+- **ADDED**: `sendMessageListToMultipleGroups()` - Gửi danh sách tin nhắn tới nhiều groups cùng lúc
+- **SUPPORT**: Hỗ trợ đầy đủ 5 loại tin nhắn group: text, image, file, sticker, mention
+- **FLEXIBLE**: Delay riêng cho từng tin nhắn + delay giữa groups để tránh rate limit
+- **SMART**: Tự động loại bỏ group IDs trùng lặp và validation đầy đủ
+
+#### Real-time Progress Tracking cho Groups
+- **CALLBACK**: `onProgress` callback để tracking real-time từng tin nhắn và group
+- **DETAILED**: Thống kê chi tiết thành công/thất bại cho từng tin nhắn và group
+- **ISOLATION**: Error của 1 tin nhắn/group không ảnh hưởng phần còn lại
+- **METRICS**: Tracking thời gian thực hiện, success rate, và message statistics
+
+#### Advanced Group Messaging Features
+- **MENTION**: Hỗ trợ mention members với offset và length chính xác
+- **CAPTION**: Image messages với caption tối đa 2000 ký tự
+- **FILE**: File attachments với token từ upload API
+- **SEQUENTIAL**: Gửi tuần tự để đảm bảo thứ tự và tránh rate limit
+
+### 📊 NEW INTERFACES
+
+#### Group Message List Types
+- **ADDED**: `GroupMessageItem` - Interface cho từng tin nhắn trong danh sách
+- **ADDED**: `SendMessageListToGroupRequest` - Request cho single group
+- **ADDED**: `SendMessageListToGroupResponse` - Response với detailed results
+- **ADDED**: `SendMessageListToMultipleGroupsRequest` - Request cho multiple groups
+- **ADDED**: `SendMessageListToMultipleGroupsResponse` - Response với group statistics
+- **ADDED**: `GroupMessageProgressInfo` - Interface cho message progress tracking
+- **ADDED**: `MultipleGroupsProgressInfo` - Interface cho multiple groups progress tracking
+
+### 📚 DOCUMENTATION & EXAMPLES
+
+#### New Documentation
+- **ADDED**: `docs/group-message-list-api.md` - Comprehensive guide cho Group Message List APIs
+- **UPDATED**: Hướng dẫn chi tiết từng loại tin nhắn group và use cases
+- **ADDED**: So sánh API cũ vs mới với feature comparison table
+
+#### New Examples
+- **ADDED**: `examples/group-message-list.ts` - Ví dụ gửi danh sách tin nhắn group
+- **INCLUDED**: System notifications, marketing campaigns, meeting notifications examples
+- **DEMO**: Mention messages, image captions, file attachments usage
+
+### 🎯 USE CASES
+
+#### System Administration
+- **MAINTENANCE**: Thông báo bảo trì hệ thống tới tất cả groups
+- **ALERTS**: Emergency alerts với hình ảnh và file đính kèm
+- **UPDATES**: System updates với mention admins
+
+#### Marketing & Business
+- **CAMPAIGNS**: Flash sales, khuyến mãi tới customer groups
+- **PROMOTIONS**: Product launches với hình ảnh và stickers
+- **ANNOUNCEMENTS**: Company announcements với professional formatting
+
+#### Team Communication
+- **MEETINGS**: Meeting notifications với mention participants
+- **PROJECTS**: Project updates tới multiple team groups
+- **REPORTS**: Regular reports với file attachments
+
+### 🔧 TECHNICAL IMPROVEMENTS
+
+#### Enhanced Error Handling
+- **ROBUST**: Comprehensive error handling cho từng tin nhắn và group
+- **CONTINUE**: Tiếp tục gửi khi gặp lỗi thay vì dừng toàn bộ process
+- **DETAILED**: Error messages chi tiết với context information
+- **ISOLATION**: Error isolation giữa tin nhắn và giữa groups
+
+#### Performance Optimizations
+- **SEQUENTIAL**: Sequential processing để tránh overwhelming Zalo servers
+- **MEMORY**: Optimized memory usage cho large group lists
+- **RATE-LIMIT**: Built-in rate limiting protection với configurable delays
+- **TIMEOUT**: Proper timeout handling và cleanup
+
+#### Type Safety & Validation
+- **TYPESCRIPT**: Full TypeScript support với strict typing
+- **VALIDATION**: Runtime validation cho tất cả input parameters
+- **INTELLISENSE**: Complete IDE support với detailed JSDoc comments
+- **CONSTRAINTS**: Proper validation cho message constraints (text length, etc.)
+
 ## [1.18.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,38 @@ 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"
+);
+```
+
 ### 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":"AAAA;;;;;;;;;GASG;AAGH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,IAAI,sBAAsB,EACzC,eAAe,IAAI,sBAAsB,EACzC,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,8BAA8B,EAC9B,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,WAAW,EACX,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,IAAI,mBAAmB,EAChC,WAAW,EACX,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,iBAAiB,IAAI,2BAA2B,EAChD,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,gCAAgC,EAChC,iCAAiC,EACjC,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,kCAAkC,EAClC,gCAAgC,GACjC,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,WAAW,IAAI,qBAAqB,EACpC,QAAQ,IAAI,kBAAkB,EAC9B,OAAO,EACP,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EAClB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC"}

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,90 @@
+/**
+ * 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 } 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;
+}
+//# 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,EACzB,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;CAG3D"}

package/dist/services/broadcast.service.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BroadcastService = void 0;
+const common_1 = require("../types/common");
+const broadcast_1 = require("../types/broadcast");
+class BroadcastService {
+    constructor(client) {
+        this.client = client;
+        // Zalo API endpoint for broadcast messages
+        this.broadcastApiUrl = "https://openapi.zalo.me/v2.0/oa/message";
+    }
+    /**
+     * 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
+     */
+    async sendBroadcastMessage(accessToken, recipient, attachmentId) {
+        try {
+            // Validate input parameters
+            this.validateBroadcastRequest(recipient, attachmentId);
+            // Build broadcast message
+            const message = {
+                attachment: {
+                    type: "template",
+                    payload: {
+                        template_type: "media",
+                        elements: [
+                            {
+                                media_type: "article",
+                                attachment_id: attachmentId
+                            }
+                        ]
+                    }
+                }
+            };
+            // Build request
+            const request = {
+                recipient,
+                message
+            };
+            // Send broadcast request
+            const result = await this.client.apiPost(this.broadcastApiUrl, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send broadcast message", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No broadcast response data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send broadcast message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * 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) {
+        const target = {};
+        // Convert ages to comma-separated string
+        if (criteria.ages && criteria.ages.length > 0) {
+            const ageCodes = criteria.ages.map(age => {
+                const code = broadcast_1.BROADCAST_AGE_CODES[age];
+                if (!code) {
+                    throw new common_1.ZaloSDKError(`Invalid age group: ${age}`, -1);
+                }
+                return code;
+            });
+            target.ages = ageCodes.join(",");
+        }
+        // Convert gender
+        if (criteria.gender) {
+            const genderCode = broadcast_1.BROADCAST_GENDER_CODES[criteria.gender];
+            if (!genderCode) {
+                throw new common_1.ZaloSDKError(`Invalid gender: ${criteria.gender}`, -1);
+            }
+            target.gender = genderCode;
+        }
+        // Convert cities to comma-separated string
+        if (criteria.cities && criteria.cities.length > 0) {
+            const cityCodes = criteria.cities.map(city => {
+                const code = broadcast_1.BROADCAST_CITY_CODES[city];
+                if (!code) {
+                    throw new common_1.ZaloSDKError(`Invalid city: ${city}`, -1);
+                }
+                return code;
+            });
+            target.cities = cityCodes.join(",");
+        }
+        // Convert locations to comma-separated string
+        if (criteria.locations && criteria.locations.length > 0) {
+            const locationCodes = criteria.locations.map(location => {
+                const code = broadcast_1.BROADCAST_LOCATION_CODES[location];
+                if (!code) {
+                    throw new common_1.ZaloSDKError(`Invalid location: ${location}`, -1);
+                }
+                return code;
+            });
+            target.locations = locationCodes.join(",");
+        }
+        // Convert platforms to comma-separated string
+        if (criteria.platforms && criteria.platforms.length > 0) {
+            const platformCodes = criteria.platforms.map(platform => {
+                const code = broadcast_1.BROADCAST_PLATFORM_CODES[platform];
+                if (!code) {
+                    throw new common_1.ZaloSDKError(`Invalid platform: ${platform}`, -1);
+                }
+                return code;
+            });
+            target.platform = platformCodes.join(",");
+        }
+        return target;
+    }
+    /**
+     * Validate broadcast request parameters
+     * @param recipient Broadcast recipient
+     * @param attachmentId Article attachment ID
+     */
+    validateBroadcastRequest(recipient, attachmentId) {
+        // Validate recipient
+        if (!recipient || !recipient.target) {
+            throw new common_1.ZaloSDKError("Recipient target is required for broadcast", -1);
+        }
+        // Validate attachment ID
+        if (!attachmentId || attachmentId.trim().length === 0) {
+            throw new common_1.ZaloSDKError("Article attachment ID is required", -1);
+        }
+        // Validate target has at least one criteria
+        const target = recipient.target;
+        const hasTargeting = target.ages || target.gender || target.cities ||
+            target.locations || target.platform;
+        if (!hasTargeting) {
+            throw new common_1.ZaloSDKError("At least one targeting criteria is required (ages, gender, cities, locations, or platform)", -1);
+        }
+    }
+    /**
+     * Get available city codes for targeting
+     * @returns Object mapping city names to codes
+     */
+    getCityCodes() {
+        return broadcast_1.BROADCAST_CITY_CODES;
+    }
+    /**
+     * Get available age group codes for targeting
+     * @returns Object mapping age groups to codes
+     */
+    getAgeGroupCodes() {
+        return broadcast_1.BROADCAST_AGE_CODES;
+    }
+    /**
+     * Get available gender codes for targeting
+     * @returns Object mapping genders to codes
+     */
+    getGenderCodes() {
+        return broadcast_1.BROADCAST_GENDER_CODES;
+    }
+    /**
+     * Get available location codes for targeting
+     * @returns Object mapping locations to codes
+     */
+    getLocationCodes() {
+        return broadcast_1.BROADCAST_LOCATION_CODES;
+    }
+    /**
+     * Get available platform codes for targeting
+     * @returns Object mapping platforms to codes
+     */
+    getPlatformCodes() {
+        return broadcast_1.BROADCAST_PLATFORM_CODES;
+    }
+}
+exports.BroadcastService = BroadcastService;
+//# sourceMappingURL=broadcast.service.js.map

package/dist/services/broadcast.service.js.map

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