@warriorteam/redai-zalo-sdk 1.12.3 → 1.12.5

package/CHANGELOG.md

@@ -5,6 +5,71 @@ 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.12.1] - 2025-01-17
+
+### 🔧 MAINTENANCE
+
+- **Cập nhật**: Tối ưu tài liệu, ví dụ và xuất bản bản vá nhỏ.
+- **Cải thiện**: Đồng bộ hoá typings và mô tả package để phát hành ổn định.
+- **Build**: Đảm bảo `prepublishOnly` chạy `clean` + `build` trước khi publish.
+
+## [1.12.0] - 2025-01-17
+
+### 🎯 NEW FEATURES
+
+#### Webhook Message Classification Helpers
+- **ADDED**: `isUserMessageEvent()` - Phân biệt tin nhắn từ người dùng cá nhân gửi tới OA
+- **ADDED**: `isGroupMessageEvent()` - Phân biệt tin nhắn từ người dùng trong group
+- **ADDED**: `isOAToUserMessageEvent()` - Phân biệt tin nhắn OA gửi cho người dùng cá nhân
+- **ADDED**: `isOAToGroupMessageEvent()` - Phân biệt tin nhắn OA gửi tới group
+- **ADDED**: `getMessageDirection()` - Xác định hướng và đích của tin nhắn với mô tả chi tiết
+
+#### Enhanced Type Safety
+- **IMPROVED**: Better type guards cho webhook message classification
+- **ENHANCED**: Comprehensive support cho 38+ message event types
+- **ADDED**: Direction và target classification với Vietnamese descriptions
+
+### 📚 DOCUMENTATION
+
+#### New Documentation Files
+- **ADDED**: `docs/WEBHOOK_MESSAGE_HELPERS.md` - Comprehensive guide cho message classification
+- **ADDED**: `examples/webhook-message-classification.ts` - Practical usage examples
+- **UPDATED**: README.md với message classification helpers section
+
+#### Developer Experience
+- **ENHANCED**: IntelliSense support với detailed JSDoc comments
+- **ADDED**: 13 comprehensive test cases cho message classification helpers
+- **IMPROVED**: Better error handling và unknown event detection
+
+### 🔧 TECHNICAL IMPROVEMENTS
+
+#### Code Organization
+- **ENHANCED**: Exported helper functions từ main index.ts
+- **IMPROVED**: Type safety với proper TypeScript interfaces
+- **ADDED**: Comprehensive test coverage cho all helper functions
+
+#### Supported Event Types
+- **User Message Events** (12 types): `user_send_text`, `user_send_image`, etc.
+- **Group Message Events** (9 types): `user_send_group_text`, `user_send_group_image`, etc.
+- **OA to User Events** (7 types): `oa_send_text`, `oa_send_image`, etc.
+- **OA to Group Events** (10 types): `oa_send_group_text`, `oa_send_group_image`, etc.
+
+## [1.11.1] - 2025-01-11
+
+### 🔧 API IMPROVEMENTS
+
+#### Method Signature Enhancement
+- **IMPROVED**: `createOAAuthUrl()` method signature với better parameter order
+  - Changed from: `(redirectUri, state?, usePkce?, pkce?)`
+  - Changed to: `(redirectUri, state?, pkce?, usePkce?)`
+- **ENHANCED**: More intuitive API design với PKCE config trước usePkce flag
+- **UPDATED**: All examples và documentation để phù hợp với signature mới
+- **ADDED**: Comprehensive test coverage cho new signature
+
+#### Developer Experience
+- **IMPROVED**: Better IntelliSense support với clearer parameter ordering
+- **ENHANCED**: More logical API flow cho PKCE implementation
+
 ## [1.11.0] - 2025-01-11
 
 ### 🔐 SECURITY ENHANCEMENTS

package/README.md

@@ -584,7 +584,39 @@ const handlers: WebhookHandlers = {
 - **Anonymous Events** (4 types): Anonymous chat support
 - **Shop Events** (1 type): Order management
 
-For complete webhook documentation, see [Webhook Events Guide](./docs/WEBHOOK_EVENTS.md).
+### 🎯 Message Classification Helpers
+
+The SDK provides helper functions to easily classify webhook message events:
+
+```typescript
+import {
+  isUserMessageEvent,
+  isGroupMessageEvent,
+  isOAToUserMessageEvent,
+  isOAToGroupMessageEvent,
+  getMessageDirection,
+} from "@warriorteam/redai-zalo-sdk";
+
+function handleWebhook(event: WebhookEvent) {
+  if (isUserMessageEvent(event)) {
+    console.log("Message from individual user");
+  } else if (isGroupMessageEvent(event)) {
+    console.log("Message from group");
+  } else if (isOAToUserMessageEvent(event)) {
+    console.log("OA sent message to user");
+  } else if (isOAToGroupMessageEvent(event)) {
+    console.log("OA sent message to group");
+  }
+
+  // Or use the unified helper
+  const { direction, target, description } = getMessageDirection(event);
+  console.log(`${direction} message to ${target}: ${description}`);
+}
+```
+
+For complete webhook documentation, see:
+- **[Webhook Events Guide](./docs/WEBHOOK_EVENTS.md)** - Complete guide for all 70+ webhook event types
+- **[Message Classification Helpers](./docs/WEBHOOK_MESSAGE_HELPERS.md)** - Helper functions for message classification
 
 ## Changelog
 

package/dist/index.d.ts

@@ -17,8 +17,9 @@ export * from "./types/article";
 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";
-export { UserGroupMessageEvent, isUserSendGroupTextEvent, isUserSendGroupImageEvent, isUserSendGroupVideoEvent, isUserSendGroupAudioEvent, isUserSendGroupFileEvent, isUserGroupMessageEvent, isOASendTextEvent, isOASendImageEvent, isOASendFileEvent, isOASendStickerEvent, isOASendGifEvent, isOASendGroupTextEvent, isOASendGroupImageEvent, isOASendGroupFileEvent, isOASendGroupStickerEvent, isOASendGroupGifEvent, isUserMessageEvent, isFromGroup, isFromPersonal, } from "./utils/type-guards";
-export type { GroupMessage, GroupTextMessage, GroupImageMessage, GroupFileMessage, GroupStickerMessage, GroupMentionMessage, GroupMessageResult, GroupInfo as GroupManagementInfo, GroupMember, GroupMemberList, GroupSettings, GroupJoinRequest, GroupJoinRequestList, GroupInvitation, GroupActivity, GroupActivityList, GroupStatistics, GroupMessageTemplate, GroupMessageSchedule, GroupBroadcast, GroupPermission, GroupWebhookEvent as GroupManagementWebhookEvent, GroupApiResponse, GroupCreateResponse, GroupUpdateResponse, GroupDeleteResponse, GroupMemberActionResponse, GroupCreateRequest, GroupCreateResult, GroupUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupMemberActionRequest, GroupAdminActionRequest, GroupDeleteRequest, GroupPendingMember, GroupQuota, GroupQuotaAsset, GroupRecentChat, GroupConversationMessage, GroupsOfOAResponse, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersRequest, GroupAcceptPendingMembersResponse, GroupRemoveMembersRequest, GroupRemoveMembersResponse, GroupMembersResponse, GroupQuotaMessageRequest, GroupQuotaMessageResponse, } from "./types/group";
+export { UserGroupMessageEvent, isUserSendGroupTextEvent, isUserSendGroupImageEvent, isUserSendGroupVideoEvent, isUserSendGroupAudioEvent, isUserSendGroupFileEvent, isUserGroupMessageEvent, isOASendTextEvent, isOASendImageEvent, isOASendFileEvent, isOASendStickerEvent, isOASendGifEvent, isOASendGroupTextEvent, isOASendGroupImageEvent, isOASendGroupFileEvent, isOASendGroupStickerEvent, isOASendGroupGifEvent, isFromGroup, isFromPersonal, } from "./utils/type-guards";
+export { isUserMessageEvent, isGroupMessageEvent, isOAToUserMessageEvent, isOAToGroupMessageEvent, getMessageDirection, } from "./types/webhook";
+export type { GroupMessage, GroupTextMessage, GroupImageMessage, GroupFileMessage, GroupStickerMessage, GroupMentionMessage, GroupMessageResult, GroupInfo as GroupManagementInfo, GroupMember, GroupMemberList, GroupSettings, GroupJoinRequest, GroupJoinRequestList, GroupInvitation, GroupActivity, GroupActivityList, GroupStatistics, GroupMessageTemplate, GroupMessageSchedule, GroupBroadcast, GroupPermission, GroupWebhookEvent as GroupManagementWebhookEvent, GroupApiResponse, GroupCreateResponse, GroupUpdateResponse, GroupDeleteResponse, GroupMemberActionResponse, GroupCreateRequest, GroupCreateResult, GroupUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupMemberActionRequest, GroupAdminActionRequest, GroupDeleteRequest, GroupPendingMember, GroupQuota, GroupQuotaAsset, GroupRecentChat, GroupConversationMessage, GroupsOfOAResponse, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersRequest, GroupAcceptPendingMembersResponse, GroupRemoveMembersRequest, GroupRemoveMembersResponse, GroupMembersResponse, GroupQuotaMessageRequest, GroupQuotaMessageResponse, AllGroupMembersResponse, GetAllMembersProgress, EnhancedGroupMember, AllGroupMembersWithDetailsResponse, GetAllMembersWithDetailsProgress, } from "./types/group";
 export type { UserProfile as UserManagementProfile, UserList as UserManagementList, UserTag, UserTagList, UserNote, UserInteraction, UserAnalytics, UserSegment, UserCustomField, UserCustomFieldValue, UserBehavior, UserJourney, UserPreference, UserActivity, UserExport, UserImport, UserSearch, UserSearchResult, BulkUserOperation, } from "./types/user-management";
 export { BaseClient } from "./clients/base-client";
 export { ZaloClient } from "./clients/zalo-client";

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;AAGhC,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;AAG/C,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.isFromPersonal = exports.isFromGroup = exports.isUserMessageEvent = 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.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);
@@ -54,9 +54,15 @@ Object.defineProperty(exports, "isOASendGroupImageEvent", { enumerable: true, ge
 Object.defineProperty(exports, "isOASendGroupFileEvent", { enumerable: true, get: function () { return type_guards_1.isOASendGroupFileEvent; } });
 Object.defineProperty(exports, "isOASendGroupStickerEvent", { enumerable: true, get: function () { return type_guards_1.isOASendGroupStickerEvent; } });
 Object.defineProperty(exports, "isOASendGroupGifEvent", { enumerable: true, get: function () { return type_guards_1.isOASendGroupGifEvent; } });
-Object.defineProperty(exports, "isUserMessageEvent", { enumerable: true, get: function () { return type_guards_1.isUserMessageEvent; } });
 Object.defineProperty(exports, "isFromGroup", { enumerable: true, get: function () { return type_guards_1.isFromGroup; } });
 Object.defineProperty(exports, "isFromPersonal", { enumerable: true, get: function () { return type_guards_1.isFromPersonal; } });
+// Export webhook helper functions
+var webhook_1 = require("./types/webhook");
+Object.defineProperty(exports, "isUserMessageEvent", { enumerable: true, get: function () { return webhook_1.isUserMessageEvent; } });
+Object.defineProperty(exports, "isGroupMessageEvent", { enumerable: true, get: function () { return webhook_1.isGroupMessageEvent; } });
+Object.defineProperty(exports, "isOAToUserMessageEvent", { enumerable: true, get: function () { return webhook_1.isOAToUserMessageEvent; } });
+Object.defineProperty(exports, "isOAToGroupMessageEvent", { enumerable: true, get: function () { return webhook_1.isOAToGroupMessageEvent; } });
+Object.defineProperty(exports, "getMessageDirection", { enumerable: true, get: function () { return webhook_1.getMessageDirection; } });
 // Export clients
 var base_client_1 = require("./clients/base-client");
 Object.defineProperty(exports, "BaseClient", { enumerable: true, get: function () { return base_client_1.BaseClient; } });

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,mDAqB6B;AAnB3B,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,iHAAA,kBAAkB,OAAA;AAClB,0GAAA,WAAW,OAAA;AACX,6GAAA,cAAc,OAAA;AA+EhB,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;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"}

package/dist/services/group-management.service.d.ts

@@ -1,6 +1,7 @@
 import { ZaloClient } from "../clients/zalo-client";
-import { GroupCreateRequest, GroupCreateResult, GroupCreateData, GroupUpdateRequest, GroupUpdateResult, GroupAssetUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupInviteResult, RecentChatsResponse, GroupConversationResponse, GroupsOfOAResponse, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersResponse, GroupRemoveMembersResponse, GroupMembersResponse, GroupQuotaMessageResponse } from "../types/group";
+import { GroupCreateRequest, GroupCreateResult, GroupCreateData, GroupUpdateRequest, GroupUpdateResult, GroupAssetUpdateRequest, GroupAvatarUpdateRequest, GroupMemberInviteRequest, GroupInviteResult, RecentChatsResponse, GroupConversationResponse, GroupsOfOAResponse, GroupDetailResponse, GroupPendingMembersResponse, GroupAcceptPendingMembersResponse, GroupRemoveMembersResponse, GroupMembersResponse, GroupMemberInfo, GroupQuotaMessageResponse, AllGroupMembersResponse, GetAllMembersProgress, EnhancedGroupMember, AllGroupMembersWithDetailsResponse, GetAllMembersWithDetailsProgress } from "../types/group";
 import { GMFProductType, QuotaType } from "../types/oa";
+import { UserService } from "./user.service";
 /**
  * Service for handling Zalo Official Account Group Management Framework (GMF) APIs
  *
@@ -38,8 +39,22 @@ import { GMFProductType, QuotaType } from "../types/oa";
  */
 export declare class GroupManagementService {
     private readonly client;
+    private readonly userService?;
     private readonly endpoints;
-    constructor(client: ZaloClient);
+    constructor(client: ZaloClient, userService?: UserService);
+    /**
+     * Create GroupManagementService with UserService for enhanced member details
+     * @param client ZaloClient instance
+     * @param userService UserService instance for fetching detailed user info
+     * @returns GroupManagementService with enhanced capabilities
+     */
+    static withUserService(client: ZaloClient, userService: UserService): GroupManagementService;
+    /**
+     * Create basic GroupManagementService without UserService
+     * @param client ZaloClient instance
+     * @returns GroupManagementService with basic capabilities only
+     */
+    static basic(client: ZaloClient): GroupManagementService;
     /**
      * Create new group chat with asset_id
      * @param accessToken OA access token
@@ -297,6 +312,64 @@ export declare class GroupManagementService {
      * @returns Group members list
      */
     getGroupMembers(accessToken: string, groupId: string, offset?: number, count?: number): Promise<GroupMembersResponse>;
+    /**
+     * Get ALL members of a group (custom function with automatic pagination)
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (default: unlimited)
+     * @param progressCallback Optional callback to track progress
+     * @returns All group members with pagination info
+     *
+     * This function automatically handles pagination to retrieve all members,
+     * not limited by the 50-member API limit per request.
+     */
+    getAllGroupMembers(accessToken: string, groupId: string, maxMembers?: number, progressCallback?: (progress: GetAllMembersProgress) => void): Promise<AllGroupMembersResponse>;
+    /**
+     * Get ALL members of a group with simple interface (no progress tracking)
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (optional)
+     * @returns Array of all group members
+     *
+     * Simplified version of getAllGroupMembers that returns just the members array
+     */
+    getAllGroupMembersSimple(accessToken: string, groupId: string, maxMembers?: number): Promise<GroupMemberInfo[]>;
+    /**
+     * Get ALL members of a group with DETAILED user information (advanced API)
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (default: unlimited)
+     * @param progressCallback Optional callback to track progress
+     * @param options Advanced options for fetching details
+     * @returns All group members with detailed user information
+     *
+     * This function:
+     * 1. First gets all basic member info using getAllGroupMembers()
+     * 2. Then fetches detailed user info for each member using UserService.getUserInfo()
+     * 3. Combines both basic and detailed info into EnhancedGroupMember objects
+     * 4. If detailed info fails to fetch, falls back to basic info only
+     * 5. Provides detailed progress tracking and statistics
+     */
+    getAllGroupMembersWithDetails(accessToken: string, groupId: string, maxMembers?: number, progressCallback?: (progress: GetAllMembersWithDetailsProgress) => void, options?: {
+        /** Batch size for fetching user details (default: 10) */
+        detailBatchSize?: number;
+        /** Timeout for each user detail request in ms (default: 5000) */
+        detailTimeout?: number;
+        /** Whether to continue if UserService is not available (default: true) */
+        continueWithoutUserService?: boolean;
+        /** Maximum concurrent detail requests (default: 5) */
+        maxConcurrentRequests?: number;
+    }): Promise<AllGroupMembersWithDetailsResponse>;
+    /**
+     * Get ALL members of a group with detailed info - Simple interface
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (optional)
+     * @returns Array of enhanced group members with detailed info
+     *
+     * Simplified version that returns just the enhanced members array
+     */
+    getAllGroupMembersWithDetailsSimple(accessToken: string, groupId: string, maxMembers?: number): Promise<EnhancedGroupMember[]>;
     private handleGroupManagementError;
 }
 //# sourceMappingURL=group-management.service.d.ts.map

package/dist/services/group-management.service.d.ts.map

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

package/dist/services/group-management.service.js

@@ -38,8 +38,9 @@ const common_1 = require("../types/common");
  *    - Member invitation frequency: max 500 invitations/day
  */
 class GroupManagementService {
-    constructor(client) {
+    constructor(client, userService) {
         this.client = client;
+        this.userService = userService;
         // Zalo API endpoints - organized by functionality
         this.endpoints = {
             group: {
@@ -64,6 +65,23 @@ class GroupManagementService {
             },
         };
     }
+    /**
+     * Create GroupManagementService with UserService for enhanced member details
+     * @param client ZaloClient instance
+     * @param userService UserService instance for fetching detailed user info
+     * @returns GroupManagementService with enhanced capabilities
+     */
+    static withUserService(client, userService) {
+        return new GroupManagementService(client, userService);
+    }
+    /**
+     * Create basic GroupManagementService without UserService
+     * @param client ZaloClient instance
+     * @returns GroupManagementService with basic capabilities only
+     */
+    static basic(client) {
+        return new GroupManagementService(client);
+    }
     /**
      * Create new group chat with asset_id
      * @param accessToken OA access token
@@ -707,6 +725,302 @@ class GroupManagementService {
             throw this.handleGroupManagementError(error, "Failed to get group members");
         }
     }
+    /**
+     * Get ALL members of a group (custom function with automatic pagination)
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (default: unlimited)
+     * @param progressCallback Optional callback to track progress
+     * @returns All group members with pagination info
+     *
+     * This function automatically handles pagination to retrieve all members,
+     * not limited by the 50-member API limit per request.
+     */
+    async getAllGroupMembers(accessToken, groupId, maxMembers, progressCallback) {
+        try {
+            // Validate input
+            if (!accessToken || accessToken.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Access token cannot be empty", -1);
+            }
+            if (!groupId || groupId.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Group ID cannot be empty", -1);
+            }
+            if (maxMembers !== undefined && maxMembers <= 0) {
+                throw new common_1.ZaloSDKError("Max members must be greater than 0", -1);
+            }
+            const allMembers = [];
+            let offset = 0;
+            const pageSize = 50; // Maximum allowed by Zalo API
+            let totalCount;
+            let pagesFetched = 0;
+            let hasMore = true;
+            // Progress tracking
+            const updateProgress = (currentCount, isComplete = false) => {
+                if (progressCallback) {
+                    const percentage = totalCount ? Math.round((currentCount / totalCount) * 100) : undefined;
+                    progressCallback({
+                        currentCount,
+                        totalCount,
+                        percentage,
+                        isComplete
+                    });
+                }
+            };
+            // Initial progress
+            updateProgress(0);
+            while (hasMore) {
+                // Check if we've reached the maximum limit
+                if (maxMembers && allMembers.length >= maxMembers) {
+                    break;
+                }
+                // Calculate how many members to request in this batch
+                const remainingLimit = maxMembers ? maxMembers - allMembers.length : pageSize;
+                const currentPageSize = Math.min(pageSize, remainingLimit);
+                // Fetch current page
+                const response = await this.getGroupMembers(accessToken, groupId, offset, currentPageSize);
+                // Handle API errors
+                if (response.error !== 0) {
+                    throw new common_1.ZaloSDKError(`Failed to fetch members at offset ${offset}: ${response.message}`, response.error);
+                }
+                // Check if we have data
+                if (!response.data || !response.data.members) {
+                    break;
+                }
+                // Update total count from first response
+                if (totalCount === undefined && response.data.total !== undefined) {
+                    totalCount = response.data.total;
+                    // If maxMembers is set and less than total, use maxMembers as effective total
+                    if (maxMembers && maxMembers < totalCount) {
+                        totalCount = maxMembers;
+                    }
+                }
+                // Add members to our collection
+                allMembers.push(...response.data.members);
+                pagesFetched++;
+                // Update progress
+                updateProgress(allMembers.length);
+                // Check if we should continue
+                const receivedCount = response.data.members.length;
+                hasMore = receivedCount === currentPageSize &&
+                    (!maxMembers || allMembers.length < maxMembers) &&
+                    (response.data.total === undefined || allMembers.length < response.data.total);
+                // Move to next page
+                offset += receivedCount;
+                // Safety check to prevent infinite loops
+                if (pagesFetched > 1000) { // Max 50,000 members (50 * 1000)
+                    console.warn(`getAllGroupMembers: Reached maximum page limit (${pagesFetched}) for group ${groupId}`);
+                    break;
+                }
+            }
+            // Final progress update
+            updateProgress(allMembers.length, true);
+            // Apply maxMembers limit if specified
+            const finalMembers = maxMembers ? allMembers.slice(0, maxMembers) : allMembers;
+            // Return enhanced response
+            return {
+                error: 0,
+                message: "Success",
+                data: {
+                    total_members: totalCount || allMembers.length,
+                    members: finalMembers,
+                    pages_fetched: pagesFetched,
+                    is_complete: !maxMembers || allMembers.length <= maxMembers
+                }
+            };
+        }
+        catch (error) {
+            throw this.handleGroupManagementError(error, "Failed to get all group members");
+        }
+    }
+    /**
+     * Get ALL members of a group with simple interface (no progress tracking)
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (optional)
+     * @returns Array of all group members
+     *
+     * Simplified version of getAllGroupMembers that returns just the members array
+     */
+    async getAllGroupMembersSimple(accessToken, groupId, maxMembers) {
+        const response = await this.getAllGroupMembers(accessToken, groupId, maxMembers);
+        return response.data.members;
+    }
+    /**
+     * Get ALL members of a group with DETAILED user information (advanced API)
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (default: unlimited)
+     * @param progressCallback Optional callback to track progress
+     * @param options Advanced options for fetching details
+     * @returns All group members with detailed user information
+     *
+     * This function:
+     * 1. First gets all basic member info using getAllGroupMembers()
+     * 2. Then fetches detailed user info for each member using UserService.getUserInfo()
+     * 3. Combines both basic and detailed info into EnhancedGroupMember objects
+     * 4. If detailed info fails to fetch, falls back to basic info only
+     * 5. Provides detailed progress tracking and statistics
+     */
+    async getAllGroupMembersWithDetails(accessToken, groupId, maxMembers, progressCallback, options) {
+        try {
+            // Validate input
+            if (!accessToken || accessToken.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Access token cannot be empty", -1);
+            }
+            if (!groupId || groupId.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Group ID cannot be empty", -1);
+            }
+            // Set default options
+            const opts = {
+                detailBatchSize: 10,
+                detailTimeout: 5000,
+                continueWithoutUserService: true,
+                maxConcurrentRequests: 5,
+                ...options
+            };
+            // Check if UserService is available
+            if (!this.userService && !opts.continueWithoutUserService) {
+                throw new common_1.ZaloSDKError("UserService is required for fetching detailed member information. " +
+                    "Please provide UserService in constructor or set continueWithoutUserService to true.", -1);
+            }
+            // Progress tracking helper
+            const updateProgress = (currentCount, totalCount, phase, phaseDetails, isComplete = false) => {
+                if (progressCallback) {
+                    const percentage = totalCount ? Math.round((currentCount / totalCount) * 100) : undefined;
+                    progressCallback({
+                        currentCount,
+                        totalCount,
+                        percentage,
+                        isComplete,
+                        phase,
+                        phase_details: phaseDetails
+                    });
+                }
+            };
+            // Phase 1: Get all basic member information
+            updateProgress(0, undefined, 'fetching_members');
+            const basicMembersResponse = await this.getAllGroupMembers(accessToken, groupId, maxMembers, (basicProgress) => {
+                updateProgress(basicProgress.currentCount, basicProgress.totalCount, 'fetching_members');
+            });
+            const basicMembers = basicMembersResponse.data.members;
+            const totalMembers = basicMembers.length;
+            // Initialize enhanced members with basic info
+            const enhancedMembers = basicMembers.map((member) => ({
+                basic_info: member,
+                detailed_info: null,
+                has_detailed_info: false
+            }));
+            // Statistics tracking
+            let successfulDetails = 0;
+            let failedDetails = 0;
+            // Phase 2: Fetch detailed user information (if UserService is available)
+            if (this.userService && totalMembers > 0) {
+                updateProgress(0, totalMembers, 'fetching_details', {
+                    details_fetched: 0,
+                    details_failed: 0,
+                    current_batch: 0,
+                    total_batches: Math.ceil(totalMembers / opts.detailBatchSize)
+                });
+                // Process members in batches to avoid overwhelming the API
+                for (let i = 0; i < totalMembers; i += opts.detailBatchSize) {
+                    const batch = enhancedMembers.slice(i, i + opts.detailBatchSize);
+                    const currentBatch = Math.floor(i / opts.detailBatchSize) + 1;
+                    const totalBatches = Math.ceil(totalMembers / opts.detailBatchSize);
+                    // Create promises for current batch with concurrency limit
+                    const batchPromises = batch.map(async (enhancedMember) => {
+                        const userId = enhancedMember.basic_info.user_id || enhancedMember.basic_info.oa_id;
+                        if (!userId) {
+                            enhancedMember.detail_fetch_error = "No user_id or oa_id available";
+                            failedDetails++;
+                            return;
+                        }
+                        try {
+                            // Create timeout promise
+                            const timeoutPromise = new Promise((_, reject) => {
+                                setTimeout(() => reject(new Error('Timeout')), opts.detailTimeout);
+                            });
+                            // Fetch user details with timeout
+                            const userDetailPromise = this.userService.getUserInfo(accessToken, userId);
+                            const userDetail = await Promise.race([userDetailPromise, timeoutPromise]);
+                            enhancedMember.detailed_info = userDetail;
+                            enhancedMember.has_detailed_info = true;
+                            successfulDetails++;
+                        }
+                        catch (error) {
+                            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                            enhancedMember.detail_fetch_error = `Failed to fetch user details: ${errorMessage}`;
+                            failedDetails++;
+                        }
+                        // Update progress for each member processed
+                        const processedCount = successfulDetails + failedDetails;
+                        updateProgress(processedCount, totalMembers, 'fetching_details', {
+                            details_fetched: successfulDetails,
+                            details_failed: failedDetails,
+                            current_batch: currentBatch,
+                            total_batches: totalBatches
+                        });
+                    });
+                    // Process batch with concurrency limit
+                    const chunks = [];
+                    for (let j = 0; j < batchPromises.length; j += opts.maxConcurrentRequests) {
+                        chunks.push(batchPromises.slice(j, j + opts.maxConcurrentRequests));
+                    }
+                    for (const chunk of chunks) {
+                        await Promise.all(chunk);
+                    }
+                }
+            }
+            else if (!this.userService) {
+                // UserService not available, mark all as failed but continue
+                failedDetails = totalMembers;
+                enhancedMembers.forEach(member => {
+                    member.detail_fetch_error = "UserService not available";
+                });
+            }
+            // Final progress update
+            updateProgress(totalMembers, totalMembers, 'complete', {
+                details_fetched: successfulDetails,
+                details_failed: failedDetails
+            }, true);
+            // Calculate success rate
+            const successRate = totalMembers > 0 ? Math.round((successfulDetails / totalMembers) * 100) : 0;
+            // Apply maxMembers limit if specified
+            const finalMembers = maxMembers ? enhancedMembers.slice(0, maxMembers) : enhancedMembers;
+            // Return enhanced response
+            return {
+                error: 0,
+                message: "Success",
+                data: {
+                    total_members: basicMembersResponse.data.total_members,
+                    members: finalMembers,
+                    pages_fetched: basicMembersResponse.data.pages_fetched,
+                    is_complete: basicMembersResponse.data.is_complete,
+                    detail_fetch_stats: {
+                        total_processed: totalMembers,
+                        successful_details: successfulDetails,
+                        failed_details: failedDetails,
+                        success_rate: successRate
+                    }
+                }
+            };
+        }
+        catch (error) {
+            throw this.handleGroupManagementError(error, "Failed to get all group members with details");
+        }
+    }
+    /**
+     * Get ALL members of a group with detailed info - Simple interface
+     * @param accessToken OA access token
+     * @param groupId Group ID
+     * @param maxMembers Maximum number of members to retrieve (optional)
+     * @returns Array of enhanced group members with detailed info
+     *
+     * Simplified version that returns just the enhanced members array
+     */
+    async getAllGroupMembersWithDetailsSimple(accessToken, groupId, maxMembers) {
+        const response = await this.getAllGroupMembersWithDetails(accessToken, groupId, maxMembers);
+        return response.data.members;
+    }
     handleGroupManagementError(error, defaultMessage) {
         if (error instanceof common_1.ZaloSDKError) {
             return error;