@warriorteam/redai-zalo-sdk 1.12.3 → 1.13.0

package/CHANGELOG.md

@@ -5,6 +5,141 @@ 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.13.0] - 2025-01-17
+
+### 🚀 NEW FEATURES
+
+#### Enhanced Article API - Get All Articles
+- **ADDED**: `getAllArticles()` - Lấy tất cả bài viết theo loại với tự động pagination
+- **ADDED**: `getAllArticlesCombined()` - Lấy tất cả bài viết cả 2 loại (normal + video) kết hợp
+- **ENHANCED**: Automatic pagination handling - không cần xử lý offset/limit thủ công
+- **ADDED**: Progress tracking với callback `onProgress` để theo dõi tiến trình real-time
+- **ADDED**: Flexible configuration với `batchSize`, `maxArticles`, và safety limits
+
+#### Advanced Features
+- **SAFETY**: Built-in safety checks để tránh infinite loops (max 100 batches)
+- **PERFORMANCE**: Configurable batch sizes (1-100 articles per request)
+- **CONTROL**: Giới hạn tổng số articles (`maxArticles`, 0 = unlimited)
+- **MONITORING**: Real-time progress callbacks với detailed metrics
+- **TYPE-SAFE**: Full TypeScript support với `ArticleListItem[]` return types
+
+#### Smart Response Handling
+- **ROBUST**: Handles both `ZaloResponse<T>` và direct response formats
+- **FLEXIBLE**: Supports cả `response.data.medias` và `response.medias` structures
+- **ERROR-SAFE**: Comprehensive error handling với `ZaloSDKError` integration
+
+### 📚 DOCUMENTATION
+
+#### New Documentation Files
+- **ADDED**: `docs/enhanced-article-api.md` - Comprehensive guide cho enhanced article APIs
+- **ADDED**: `examples/get-all-articles-example.ts` - Practical usage examples với 4 scenarios
+- **DETAILED**: API reference với parameters, return types, và best practices
+- **EXAMPLES**: Real-world usage patterns và performance recommendations
+
+#### Developer Experience
+- **ENHANCED**: Detailed JSDoc comments với @example blocks
+- **IMPROVED**: IntelliSense support với comprehensive type definitions
+- **ADDED**: Progress tracking examples và error handling patterns
+- **GUIDES**: Performance tuning và rate limiting recommendations
+
+### 🔧 TECHNICAL IMPROVEMENTS
+
+#### Code Quality
+- **TYPE-SAFE**: Full TypeScript compliance với proper interface definitions
+- **VALIDATED**: Input validation với `ARTICLE_CONSTRAINTS` integration
+- **OPTIMIZED**: Efficient pagination logic với smart batch management
+- **TESTED**: Comprehensive error scenarios và edge case handling
+
+#### API Design
+- **CONSISTENT**: Follows existing SDK patterns và naming conventions
+- **EXTENSIBLE**: Modular design cho future enhancements
+- **BACKWARD-COMPATIBLE**: Không breaking changes cho existing `getArticleList()`
+- **PERFORMANCE**: Optimized cho large datasets với configurable limits
+
+### 💡 USAGE EXAMPLES
+
+```typescript
+// Simple: Get all normal articles
+const result = await articleService.getAllArticles(accessToken, "normal");
+
+// Advanced: With progress tracking và limits
+const result = await articleService.getAllArticles(accessToken, "normal", {
+  batchSize: 50,
+  maxArticles: 1000,
+  onProgress: (progress) => console.log(`${progress.totalFetched} articles`)
+});
+
+// Combined: Get both normal và video articles
+const combined = await articleService.getAllArticlesCombined(accessToken, {
+  maxArticlesPerType: 500
+});
+```
+
+## [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

@@ -9,6 +9,7 @@ A comprehensive TypeScript/JavaScript SDK for Zalo APIs, providing easy-to-use i
 - **Group Message Framework (GMF)** - Send messages to Zalo groups
 - **User Management** - Comprehensive user profile and tag management
 - **Content Management** - Upload and manage media content (images, files, articles)
+- **Enhanced Article Management** - Get all articles with auto-pagination and progress tracking
 - **Video Upload** - Upload and manage video content with processing
 - **Tag Management** - User tagging and segmentation
 - **Webhook handling** - Process Zalo webhook events
@@ -22,6 +23,7 @@ A comprehensive TypeScript/JavaScript SDK for Zalo APIs, providing easy-to-use i
 - 🛡️ **Error Handling** - Detailed error information and handling
 - 📦 **Zero Dependencies** - Only requires axios and form-data
 - 🎯 **Promise-based** - Modern async/await support
+- 🔄 **Auto-Pagination** - Automatically fetch all articles with progress tracking
 
 ## Installation
 
@@ -584,7 +586,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/article.service.d.ts

@@ -1,5 +1,5 @@
 import { ZaloClient } from "../clients/zalo-client";
-import { ArticleRequest, ArticleNormalRequest, ArticleVideoRequest, ArticleResponse, ArticleProcessResponse, ArticleVerifyResponse, ArticleDetail, ArticleListRequest, ArticleListResponse, ArticleRemoveResponse, ArticleUpdateRequest, ArticleUpdateNormalRequest, ArticleUpdateVideoRequest, ArticleUpdateResponse, ArticleStatus, CommentStatus } from "../types/article";
+import { ArticleRequest, ArticleNormalRequest, ArticleVideoRequest, ArticleResponse, ArticleProcessResponse, ArticleVerifyResponse, ArticleDetail, ArticleListRequest, ArticleListResponse, ArticleListItem, ArticleRemoveResponse, ArticleUpdateRequest, ArticleUpdateNormalRequest, ArticleUpdateVideoRequest, ArticleUpdateResponse, ArticleStatus, CommentStatus } from "../types/article";
 /**
  * Service for handling Zalo Official Account Article Management APIs
  *
@@ -82,6 +82,108 @@ export declare class ArticleService {
      * @returns Article list
      */
     getArticleList(accessToken: string, request: ArticleListRequest): Promise<ArticleListResponse>;
+    /**
+     * Get all articles by automatically fetching all pages
+     *
+     * @example
+     * ```typescript
+     * // Get all normal articles with progress tracking
+     * const result = await articleService.getAllArticles(accessToken, "normal", {
+     *   batchSize: 50,
+     *   maxArticles: 1000,
+     *   onProgress: (progress) => {
+     *     console.log(`Batch ${progress.currentBatch}: ${progress.totalFetched} articles fetched`);
+     *   }
+     * });
+     *
+     * console.log(`Total: ${result.totalFetched} articles in ${result.totalBatches} batches`);
+     * console.log(`Has more: ${result.hasMore}`);
+     * ```
+     *
+     * @param accessToken OA access token
+     * @param type Article type ("normal" or "video")
+     * @param options Configuration options for fetching
+     * @returns All articles with pagination info
+     */
+    getAllArticles(accessToken: string, type?: "normal" | "video", options?: {
+        /** Number of articles to fetch per request (default: 50, max: 100) */
+        batchSize?: number;
+        /** Maximum number of articles to fetch (default: 1000, 0 = no limit) */
+        maxArticles?: number;
+        /** Optional callback to track progress */
+        onProgress?: (progress: {
+            currentBatch: number;
+            totalFetched: number;
+            hasMore: boolean;
+        }) => void;
+    }): Promise<{
+        /** Array of all fetched articles */
+        articles: ArticleListItem[];
+        /** Total number of articles fetched */
+        totalFetched: number;
+        /** Number of API calls made */
+        totalBatches: number;
+        /** Whether there are more articles available */
+        hasMore: boolean;
+    }>;
+    /**
+     * Get all articles of both types (normal and video) combined
+     *
+     * @example
+     * ```typescript
+     * // Get all articles (both normal and video)
+     * const result = await articleService.getAllArticlesCombined(accessToken, {
+     *   batchSize: 50,
+     *   maxArticlesPerType: 500,
+     *   onProgress: (progress) => {
+     *     console.log(`${progress.type}: Batch ${progress.currentBatch}, Total: ${progress.totalFetched}`);
+     *   }
+     * });
+     *
+     * console.log(`Total articles: ${result.totalFetched}`);
+     * console.log(`Normal articles: ${result.breakdown.normal.totalFetched}`);
+     * console.log(`Video articles: ${result.breakdown.video.totalFetched}`);
+     * ```
+     *
+     * @param accessToken OA access token
+     * @param options Configuration options for fetching
+     * @returns All articles (normal + video) with combined pagination info
+     */
+    getAllArticlesCombined(accessToken: string, options?: {
+        /** Number of articles to fetch per request for each type (default: 50, max: 100) */
+        batchSize?: number;
+        /** Maximum number of articles to fetch per type (default: 500, 0 = no limit) */
+        maxArticlesPerType?: number;
+        /** Optional callback to track progress */
+        onProgress?: (progress: {
+            type: "normal" | "video";
+            currentBatch: number;
+            totalFetched: number;
+            hasMore: boolean;
+        }) => void;
+    }): Promise<{
+        /** Array of all fetched articles (normal + video) */
+        articles: ArticleListItem[];
+        /** Breakdown by type */
+        breakdown: {
+            normal: {
+                articles: ArticleListItem[];
+                totalFetched: number;
+                totalBatches: number;
+                hasMore: boolean;
+            };
+            video: {
+                articles: ArticleListItem[];
+                totalFetched: number;
+                totalBatches: number;
+                hasMore: boolean;
+            };
+        };
+        /** Total number of articles fetched */
+        totalFetched: number;
+        /** Total number of API calls made */
+        totalBatches: number;
+    }>;
     /**
      * Remove article
      * @param accessToken OA access token

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

@@ -1 +1 @@
-{"version":3,"file":"article.service.d.ts","sourceRoot":"","sources":["../../src/services/article.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EAGb,kBAAkB,EAClB,mBAAmB,EAEnB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EAIrB,aAAa,EACb,aAAa,EAId,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,cAAc;IAab,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CASf;gBAEkB,MAAM,EAAE,UAAU;IAE/C;;;;;OAKG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC;IAuC3B;;;;;OAKG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC;IA2B3B;;;;;OAKG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IAa3B;;;;;OAKG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC;IAuDlC;;;;;OAKG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC;IAsBjC;;;;;OAKG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IAkBzB;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IAqB/B;;;;;OAKG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC;IAgCjC,OAAO,CAAC,kBAAkB;IAqB1B;;;;;OAKG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,qBAAqB,CAAC;IAwCjC;;;;;OAKG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,qBAAqB,CAAC;IA4BjC;;;;;OAKG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAajC;;;;;;;OAOG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,qBAAqB,CAAC;IAwEjC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAqDpC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAkCnC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAqBlC;;OAEG;IACH,OAAO,CAAC,kCAAkC;IAW1C;;OAEG;IACH,OAAO,CAAC,iCAAiC;IAWzC;;OAEG;IACH,OAAO,CAAC,aAAa;IA2CrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwDxB,OAAO,CAAC,mBAAmB;CAQ5B"}
+{"version":3,"file":"article.service.d.ts","sourceRoot":"","sources":["../../src/services/article.service.ts"],"names":[],"mappings":"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"}

package/dist/services/article.service.js

@@ -238,6 +238,173 @@ class ArticleService {
             throw this.handleArticleError(error, "Failed to get article list");
         }
     }
+    /**
+     * Get all articles by automatically fetching all pages
+     *
+     * @example
+     * ```typescript
+     * // Get all normal articles with progress tracking
+     * const result = await articleService.getAllArticles(accessToken, "normal", {
+     *   batchSize: 50,
+     *   maxArticles: 1000,
+     *   onProgress: (progress) => {
+     *     console.log(`Batch ${progress.currentBatch}: ${progress.totalFetched} articles fetched`);
+     *   }
+     * });
+     *
+     * console.log(`Total: ${result.totalFetched} articles in ${result.totalBatches} batches`);
+     * console.log(`Has more: ${result.hasMore}`);
+     * ```
+     *
+     * @param accessToken OA access token
+     * @param type Article type ("normal" or "video")
+     * @param options Configuration options for fetching
+     * @returns All articles with pagination info
+     */
+    async getAllArticles(accessToken, type = "normal", options = {}) {
+        try {
+            const { batchSize = 50, maxArticles = 1000, onProgress } = options;
+            // Validate parameters
+            if (batchSize <= 0 || batchSize > article_1.ARTICLE_CONSTRAINTS.LIST_MAX_LIMIT) {
+                throw new common_1.ZaloSDKError(`Batch size must be between 1 and ${article_1.ARTICLE_CONSTRAINTS.LIST_MAX_LIMIT}`, -1);
+            }
+            if (maxArticles < 0) {
+                throw new common_1.ZaloSDKError("Max articles must be >= 0 (0 = no limit)", -1);
+            }
+            if (!["normal", "video"].includes(type)) {
+                throw new common_1.ZaloSDKError('Type must be "normal" or "video"', -1);
+            }
+            const allArticles = [];
+            let offset = 0;
+            let currentBatch = 0;
+            let hasMore = true;
+            while (hasMore) {
+                currentBatch++;
+                // Calculate limit for this batch
+                let currentLimit = batchSize;
+                if (maxArticles > 0) {
+                    const remaining = maxArticles - allArticles.length;
+                    if (remaining <= 0)
+                        break;
+                    currentLimit = Math.min(batchSize, remaining);
+                }
+                // Fetch current batch
+                const response = await this.getArticleList(accessToken, {
+                    offset,
+                    limit: currentLimit,
+                    type
+                });
+                // Add articles to collection
+                // Check if response is successful and has data
+                if ('data' in response && response.data?.medias && response.data.medias.length > 0) {
+                    allArticles.push(...response.data.medias);
+                    offset += response.data.medias.length;
+                    // Check if we have more data
+                    hasMore = response.data.medias.length === currentLimit;
+                    // Stop if we've reached max articles
+                    if (maxArticles > 0 && allArticles.length >= maxArticles) {
+                        hasMore = false;
+                    }
+                }
+                else if ('medias' in response && response.medias && response.medias.length > 0) {
+                    // Handle direct response format (fallback)
+                    allArticles.push(...response.medias);
+                    offset += response.medias.length;
+                    // Check if we have more data
+                    hasMore = response.medias.length === currentLimit;
+                    // Stop if we've reached max articles
+                    if (maxArticles > 0 && allArticles.length >= maxArticles) {
+                        hasMore = false;
+                    }
+                }
+                else {
+                    hasMore = false;
+                }
+                // Call progress callback if provided
+                if (onProgress) {
+                    onProgress({
+                        currentBatch,
+                        totalFetched: allArticles.length,
+                        hasMore
+                    });
+                }
+                // Safety check to prevent infinite loops
+                if (currentBatch > 100) {
+                    console.warn("Reached maximum batch limit (100), stopping fetch");
+                    break;
+                }
+            }
+            return {
+                articles: allArticles,
+                totalFetched: allArticles.length,
+                totalBatches: currentBatch,
+                hasMore: hasMore && (maxArticles === 0 || allArticles.length < maxArticles)
+            };
+        }
+        catch (error) {
+            throw this.handleArticleError(error, "Failed to get all articles");
+        }
+    }
+    /**
+     * Get all articles of both types (normal and video) combined
+     *
+     * @example
+     * ```typescript
+     * // Get all articles (both normal and video)
+     * const result = await articleService.getAllArticlesCombined(accessToken, {
+     *   batchSize: 50,
+     *   maxArticlesPerType: 500,
+     *   onProgress: (progress) => {
+     *     console.log(`${progress.type}: Batch ${progress.currentBatch}, Total: ${progress.totalFetched}`);
+     *   }
+     * });
+     *
+     * console.log(`Total articles: ${result.totalFetched}`);
+     * console.log(`Normal articles: ${result.breakdown.normal.totalFetched}`);
+     * console.log(`Video articles: ${result.breakdown.video.totalFetched}`);
+     * ```
+     *
+     * @param accessToken OA access token
+     * @param options Configuration options for fetching
+     * @returns All articles (normal + video) with combined pagination info
+     */
+    async getAllArticlesCombined(accessToken, options = {}) {
+        try {
+            const { batchSize = 50, maxArticlesPerType = 500, onProgress } = options;
+            // Fetch normal articles
+            const normalResult = await this.getAllArticles(accessToken, "normal", {
+                batchSize,
+                maxArticles: maxArticlesPerType,
+                onProgress: onProgress ? (progress) => onProgress({
+                    type: "normal",
+                    ...progress
+                }) : undefined
+            });
+            // Fetch video articles
+            const videoResult = await this.getAllArticles(accessToken, "video", {
+                batchSize,
+                maxArticles: maxArticlesPerType,
+                onProgress: onProgress ? (progress) => onProgress({
+                    type: "video",
+                    ...progress
+                }) : undefined
+            });
+            // Combine results
+            const allArticles = [...normalResult.articles, ...videoResult.articles];
+            return {
+                articles: allArticles,
+                breakdown: {
+                    normal: normalResult,
+                    video: videoResult
+                },
+                totalFetched: allArticles.length,
+                totalBatches: normalResult.totalBatches + videoResult.totalBatches
+            };
+        }
+        catch (error) {
+            throw this.handleArticleError(error, "Failed to get all articles combined");
+        }
+    }
     /**
      * Remove article
      * @param accessToken OA access token