@warriorteam/redai-zalo-sdk 1.26.1 → 1.26.2

package/examples/user-list-post-example.ts

@@ -1,186 +0,0 @@
-/**
- * Example: Using POST method to get user list
- * Demonstrates the new postUserList method in UserService
- */
-
-import { ZaloSDK, UserListRequest } from "../src/index";
-
-async function demonstratePostUserList() {
-  // Initialize SDK
-  const zalo = new ZaloSDK({
-    appId: "your-app-id",
-    appSecret: "your-app-secret"
-  });
-
-  const accessToken = "your-access-token";
-
-  try {
-    console.log("=== POST User List Example ===\n");
-
-    // Example 1: Basic user list with POST method
-    console.log("1. Getting user list with POST method:");
-    const basicRequest: UserListRequest = {
-      offset: 0,
-      count: 10
-    };
-
-    const basicResult = await zalo.user.postUserList(accessToken, basicRequest);
-    console.log("Basic POST result:", {
-      total: basicResult.total,
-      userCount: basicResult.users.length,
-      users: basicResult.users.map(user => ({
-        user_id: user.user_id,
-        display_name: user.display_name,
-        user_is_follower: user.user_is_follower
-      }))
-    });
-
-    // Example 2: Filtered user list with tag
-    console.log("\n2. Getting users with specific tag (POST method):");
-    const taggedRequest: UserListRequest = {
-      offset: 0,
-      count: 20,
-      tag_name: "VIP_CUSTOMER"
-    };
-
-    const taggedResult = await zalo.user.postUserList(accessToken, taggedRequest);
-    console.log("Tagged users POST result:", {
-      total: taggedResult.total,
-      userCount: taggedResult.users.length,
-      tag_filter: "VIP_CUSTOMER"
-    });
-
-    // Example 3: Followers only with POST method
-    console.log("\n3. Getting followers only (POST method):");
-    const followersRequest: UserListRequest = {
-      offset: 0,
-      count: 15,
-      is_follower: true
-    };
-
-    const followersResult = await zalo.user.postUserList(accessToken, followersRequest);
-    console.log("Followers POST result:", {
-      total: followersResult.total,
-      userCount: followersResult.users.length,
-      followers_only: true
-    });
-
-    // Example 4: Users with recent interaction (POST method)
-    console.log("\n4. Getting users with recent interaction (POST method):");
-    const recentRequest: UserListRequest = {
-      offset: 0,
-      count: 25,
-      last_interaction_period: "7d" // Last 7 days
-    };
-
-    const recentResult = await zalo.user.postUserList(accessToken, recentRequest);
-    console.log("Recent interaction POST result:", {
-      total: recentResult.total,
-      userCount: recentResult.users.length,
-      interaction_period: "7d"
-    });
-
-    // Example 5: Compare GET vs POST methods
-    console.log("\n5. Comparing GET vs POST methods:");
-    
-    const compareRequest: UserListRequest = {
-      offset: 0,
-      count: 5
-    };
-
-    // GET method
-    const getResult = await zalo.user.getUserList(accessToken, compareRequest);
-    console.log("GET method result:", {
-      total: getResult.total,
-      userCount: getResult.users.length,
-      method: "GET"
-    });
-
-    // POST method
-    const postResult = await zalo.user.postUserList(accessToken, compareRequest);
-    console.log("POST method result:", {
-      total: postResult.total,
-      userCount: postResult.users.length,
-      method: "POST"
-    });
-
-    console.log("Results should be identical:", {
-      totals_match: getResult.total === postResult.total,
-      counts_match: getResult.users.length === postResult.users.length
-    });
-
-  } catch (error) {
-    console.error("Error in POST user list example:", error);
-    
-    if (error instanceof Error) {
-      console.error("Error details:", {
-        name: error.name,
-        message: error.message,
-        stack: error.stack
-      });
-    }
-  }
-}
-
-// Example usage with pagination using POST method
-async function demonstratePaginationWithPost() {
-  const zalo = new ZaloSDK({
-    appId: "your-app-id",
-    appSecret: "your-app-secret"
-  });
-
-  const accessToken = "your-access-token";
-
-  try {
-    console.log("\n=== POST Method Pagination Example ===\n");
-
-    let offset = 0;
-    const count = 10;
-    let allUsers: any[] = [];
-    let totalUsers = 0;
-
-    do {
-      const request: UserListRequest = {
-        offset,
-        count
-      };
-
-      const result = await zalo.user.postUserList(accessToken, request);
-      
-      console.log(`Page ${Math.floor(offset / count) + 1}:`, {
-        offset,
-        returned: result.users.length,
-        total: result.total
-      });
-
-      allUsers.push(...result.users);
-      totalUsers = result.total;
-      offset += count;
-
-      // Break if we've got all users or no more users returned
-      if (result.users.length < count || allUsers.length >= totalUsers) {
-        break;
-      }
-
-    } while (true);
-
-    console.log("\nPagination complete:", {
-      total_users: totalUsers,
-      fetched_users: allUsers.length,
-      method: "POST"
-    });
-
-  } catch (error) {
-    console.error("Error in POST pagination example:", error);
-  }
-}
-
-// Run examples
-if (require.main === module) {
-  demonstratePostUserList()
-    .then(() => demonstratePaginationWithPost())
-    .then(() => console.log("\n✅ POST User List examples completed!"))
-    .catch(error => console.error("❌ Example failed:", error));
-}
-
-export { demonstratePostUserList, demonstratePaginationWithPost };

package/examples/video-upload-combined.example.ts

@@ -1,228 +0,0 @@
-/**
- * Example: Combined Video Upload and Status Checking
- * 
- * This example demonstrates how to use the new combined method
- * uploadVideoAndWaitForCompletion() which handles both video upload
- * and status checking in a single call.
- */
-
-import { ZaloSDK, VideoUploadStatus } from '../src/index';
-import * as fs from 'fs';
-
-async function videoUploadCombinedExample() {
-  // Initialize SDK
-  const zalo = new ZaloSDK();
-  
-  // Your access token
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  
-  try {
-    console.log("🚀 Starting combined video upload example...");
-    
-    // Read video file
-    const videoBuffer = fs.readFileSync('./path/to/your/video.mp4');
-    console.log(`📁 Video file size: ${videoBuffer.length} bytes`);
-    
-    // Method 1: Combined upload and wait for completion
-    console.log("\n📤 Method 1: Using combined uploadVideoAndWaitForCompletion()");
-    
-    const startTime = Date.now();
-    const finalResult = await zalo.videoUpload.uploadVideoAndWaitForCompletion(
-      accessToken,
-      videoBuffer,
-      "example-video.mp4",
-      5 * 60 * 1000, // 5 minutes timeout
-      5 * 1000       // 5 seconds polling interval
-    );
-    
-    const duration = Date.now() - startTime;
-    console.log(`✅ Video upload completed in ${duration}ms`);
-    console.log(`📹 Video ID: ${finalResult.video_id}`);
-    console.log(`📊 Status: ${finalResult.status} (${getStatusDescription(finalResult.status)})`);
-    console.log(`📝 Status Message: ${finalResult.status_message}`);
-    console.log(`🎬 Video Name: ${finalResult.video_name}`);
-    console.log(`📏 Video Size: ${finalResult.video_size} bytes`);
-    console.log(`🔄 Convert Progress: ${finalResult.convert_percent}%`);
-    
-    // Method 2: Manual step-by-step approach (for comparison)
-    console.log("\n📤 Method 2: Manual step-by-step approach");
-    
-    // Step 1: Upload video
-    const uploadResult = await zalo.videoUpload.uploadVideo(
-      accessToken,
-      videoBuffer,
-      "example-video-manual.mp4"
-    );
-    console.log(`🎫 Upload token: ${uploadResult.token}`);
-    
-    // Step 2: Check status manually
-    let attempts = 0;
-    const maxAttempts = 60; // 5 minutes with 5-second intervals
-    
-    while (attempts < maxAttempts) {
-      const status = await zalo.videoUpload.checkVideoStatus(accessToken, uploadResult.token);
-      
-      console.log(`🔍 Attempt ${attempts + 1}: Status ${status.status} - ${status.status_message} (${status.convert_percent}%)`);
-      
-      if (status.status === VideoUploadStatus.SUCCESS && status.video_id) {
-        console.log(`✅ Manual upload completed!`);
-        console.log(`📹 Video ID: ${status.video_id}`);
-        break;
-      }
-      
-      if (status.status === VideoUploadStatus.FAILED) {
-        console.error(`❌ Manual upload failed: ${status.status_message}`);
-        break;
-      }
-      
-      if (status.status === VideoUploadStatus.LOCKED) {
-        console.error(`🔒 Video has been locked: ${status.status_message}`);
-        break;
-      }
-      
-      if (status.status === VideoUploadStatus.DELETED) {
-        console.error(`🗑️ Video has been deleted: ${status.status_message}`);
-        break;
-      }
-      
-      // Continue polling for PROCESSING or UNKNOWN status
-      await new Promise(resolve => setTimeout(resolve, 5000));
-      attempts++;
-    }
-    
-    if (attempts >= maxAttempts) {
-      console.error(`⏰ Manual upload timeout after ${maxAttempts} attempts`);
-    }
-    
-    // Method 3: Upload from URL (bonus feature)
-    console.log("\n🌐 Method 3: Upload video from URL");
-    
-    try {
-      const urlUploadResult = await zalo.videoUpload.uploadVideoFromUrl(
-        accessToken,
-        "https://example.com/sample-video.mp4"
-      );
-      
-      console.log(`🎫 URL upload token: ${urlUploadResult.token}`);
-      
-      // Wait for completion
-      const urlFinalResult = await zalo.videoUpload.waitForUploadCompletion(
-        accessToken,
-        urlUploadResult.token
-      );
-      
-      console.log(`✅ URL upload completed!`);
-      console.log(`📹 Video ID: ${urlFinalResult.video_id}`);
-    } catch (error) {
-      console.log(`ℹ️ URL upload example skipped (URL not accessible): ${error.message}`);
-    }
-    
-  } catch (error) {
-    console.error("❌ Error in video upload example:", error);
-    
-    if (error.message.includes("Token cannot be empty")) {
-      console.log("💡 Please set your access token in the example");
-    }
-    
-    if (error.message.includes("Video file size exceeds")) {
-      console.log("💡 Video file is too large. Maximum size is 50MB");
-    }
-    
-    if (error.message.includes("Unsupported video format")) {
-      console.log("💡 Only MP4 and AVI formats are supported");
-    }
-  }
-}
-
-/**
- * Get human-readable status description
- */
-function getStatusDescription(status: number): string {
-  switch (status) {
-    case VideoUploadStatus.UNKNOWN:
-      return "Trạng thái không xác định";
-    case VideoUploadStatus.SUCCESS:
-      return "Video đã được xử lý thành công và có thể sử dụng";
-    case VideoUploadStatus.LOCKED:
-      return "Video đã bị khóa";
-    case VideoUploadStatus.PROCESSING:
-      return "Video đang được xử lý";
-    case VideoUploadStatus.FAILED:
-      return "Video xử lý thất bại";
-    case VideoUploadStatus.DELETED:
-      return "Video đã bị xóa";
-    default:
-      return "Unknown status";
-  }
-}
-
-/**
- * Example usage with error handling and retry logic
- */
-async function robustVideoUploadExample() {
-  const zalo = new ZaloSDK();
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  
-  try {
-    const videoBuffer = fs.readFileSync('./path/to/your/video.mp4');
-    
-    // Retry logic for robust upload
-    const maxRetries = 3;
-    let attempt = 0;
-    
-    while (attempt < maxRetries) {
-      try {
-        console.log(`🔄 Upload attempt ${attempt + 1}/${maxRetries}`);
-        
-        const result = await zalo.videoUpload.uploadVideoAndWaitForCompletion(
-          accessToken,
-          videoBuffer,
-          "robust-upload.mp4",
-          10 * 60 * 1000, // 10 minutes timeout
-          3 * 1000        // 3 seconds polling interval
-        );
-        
-        console.log(`✅ Upload successful on attempt ${attempt + 1}`);
-        console.log(`📹 Video ID: ${result.video_id}`);
-        return result;
-        
-      } catch (error) {
-        attempt++;
-        console.log(`❌ Attempt ${attempt} failed: ${error.message}`);
-        
-        if (attempt >= maxRetries) {
-          throw new Error(`Upload failed after ${maxRetries} attempts: ${error.message}`);
-        }
-        
-        // Wait before retry
-        console.log(`⏳ Waiting 10 seconds before retry...`);
-        await new Promise(resolve => setTimeout(resolve, 10000));
-      }
-    }
-    
-  } catch (error) {
-    console.error("❌ Robust upload failed:", error);
-  }
-}
-
-// Run examples
-if (require.main === module) {
-  console.log("🎬 Zalo Video Upload Combined Example");
-  console.log("=====================================\n");
-  
-  videoUploadCombinedExample()
-    .then(() => {
-      console.log("\n🎯 Basic example completed");
-      return robustVideoUploadExample();
-    })
-    .then(() => {
-      console.log("\n🛡️ Robust example completed");
-      console.log("\n✨ All examples completed successfully!");
-    })
-    .catch(error => {
-      console.error("\n💥 Example failed:", error);
-      process.exit(1);
-    });
-}
-
-export { videoUploadCombinedExample, robustVideoUploadExample };

package/examples/webhook-message-classification.ts

@@ -1,285 +0,0 @@
-/**
- * Ví dụ sử dụng các hàm helper để phân loại tin nhắn webhook
- */
-
-import {
-  isUserMessageEvent,
-  isGroupMessageEvent,
-  isOAToUserMessageEvent,
-  isOAToGroupMessageEvent,
-  getMessageDirection,
-  WebhookEvent,
-  UserMessageWebhookEvent,
-  GroupWebhookEvent,
-  OAMessageWebhookEvent,
-} from '@warriorteam/redai-zalo-sdk';
-
-/**
- * Service xử lý webhook với phân loại tin nhắn
- */
-export class ZaloWebhookMessageHandler {
-  /**
-   * Xử lý webhook event chính
-   */
-  public handleWebhook(event: WebhookEvent): void {
-    console.log('=== Webhook Event Received ===');
-    console.log('Event Name:', event.event_name);
-    console.log('Timestamp:', event.timestamp);
-
-    // Phương pháp 1: Sử dụng các hàm kiểm tra riêng lẻ
-    this.classifyBySpecificChecks(event);
-
-    // Phương pháp 2: Sử dụng getMessageDirection
-    this.classifyByDirection(event);
-
-    // Xử lý tin nhắn dựa trên loại
-    this.processMessage(event);
-  }
-
-  /**
-   * Phân loại bằng các hàm kiểm tra riêng lẻ
-   */
-  private classifyBySpecificChecks(event: WebhookEvent): void {
-    console.log('\n--- Classification by Specific Checks ---');
-
-    if (isUserMessageEvent(event)) {
-      console.log('✅ Tin nhắn từ người dùng cá nhân');
-      this.logUserMessageDetails(event);
-    } else if (isGroupMessageEvent(event)) {
-      console.log('✅ Tin nhắn từ group');
-      this.logGroupMessageDetails(event);
-    } else if (isOAToUserMessageEvent(event)) {
-      console.log('✅ OA gửi tin nhắn cho người dùng cá nhân');
-      this.logOAToUserDetails(event);
-    } else if (isOAToGroupMessageEvent(event)) {
-      console.log('✅ OA gửi tin nhắn tới group');
-      this.logOAToGroupDetails(event);
-    } else {
-      console.log('❓ Sự kiện không phải tin nhắn hoặc không xác định');
-    }
-  }
-
-  /**
-   * Phân loại bằng getMessageDirection
-   */
-  private classifyByDirection(event: WebhookEvent): void {
-    console.log('\n--- Classification by Direction ---');
-
-    const messageInfo = getMessageDirection(event);
-    console.log(`Direction: ${messageInfo.direction}`);
-    console.log(`Target: ${messageInfo.target}`);
-    console.log(`Description: ${messageInfo.description}`);
-
-    // Xử lý dựa trên direction và target
-    const key = `${messageInfo.direction}-${messageInfo.target}`;
-    switch (key) {
-      case 'incoming-user':
-        console.log('🔵 Xử lý tin nhắn đến từ user cá nhân');
-        break;
-      case 'incoming-group':
-        console.log('🟢 Xử lý tin nhắn đến từ group');
-        break;
-      case 'outgoing-user':
-        console.log('🟡 Xử lý tin nhắn OA gửi cho user');
-        break;
-      case 'outgoing-group':
-        console.log('🟠 Xử lý tin nhắn OA gửi tới group');
-        break;
-      default:
-        console.log('⚪ Sự kiện không xác định');
-    }
-  }
-
-  /**
-   * Xử lý tin nhắn dựa trên loại
-   */
-  private processMessage(event: WebhookEvent): void {
-    console.log('\n--- Message Processing ---');
-
-    if (isUserMessageEvent(event)) {
-      this.processUserMessage(event);
-    } else if (isGroupMessageEvent(event)) {
-      this.processGroupMessage(event);
-    } else if (isOAToUserMessageEvent(event)) {
-      this.processOAToUserMessage(event);
-    } else if (isOAToGroupMessageEvent(event)) {
-      this.processOAToGroupMessage(event);
-    }
-  }
-
-  /**
-   * Xử lý tin nhắn từ user cá nhân
-   */
-  private processUserMessage(event: UserMessageWebhookEvent): void {
-    console.log('Processing user message...');
-    
-    // Logic xử lý tin nhắn từ user cá nhân
-    // - Lưu vào database
-    // - Trigger AI response
-    // - Update conversation state
-    
-    console.log('✅ User message processed');
-  }
-
-  /**
-   * Xử lý tin nhắn từ group
-   */
-  private processGroupMessage(event: GroupWebhookEvent): void {
-    console.log('Processing group message...');
-    
-    // Logic xử lý tin nhắn từ group
-    // - Check if OA is mentioned
-    // - Apply group-specific rules
-    // - Handle group moderation
-    
-    console.log('✅ Group message processed');
-  }
-
-  /**
-   * Xử lý tin nhắn OA gửi cho user
-   */
-  private processOAToUserMessage(event: OAMessageWebhookEvent): void {
-    console.log('Processing OA to user message...');
-    
-    // Logic xử lý tin nhắn OA gửi
-    // - Log outbound message
-    // - Update delivery status
-    // - Track engagement metrics
-    
-    console.log('✅ OA to user message processed');
-  }
-
-  /**
-   * Xử lý tin nhắn OA gửi tới group
-   */
-  private processOAToGroupMessage(event: GroupWebhookEvent): void {
-    console.log('Processing OA to group message...');
-    
-    // Logic xử lý tin nhắn OA gửi tới group
-    // - Log group broadcast
-    // - Track group engagement
-    // - Update group statistics
-    
-    console.log('✅ OA to group message processed');
-  }
-
-  /**
-   * Log chi tiết tin nhắn user
-   */
-  private logUserMessageDetails(event: UserMessageWebhookEvent): void {
-    console.log(`  - Sender ID: ${event.sender.id}`);
-    console.log(`  - Recipient ID: ${event.recipient.id}`);
-    if ('message' in event && event.message.text) {
-      console.log(`  - Text: ${event.message.text}`);
-    }
-  }
-
-  /**
-   * Log chi tiết tin nhắn group
-   */
-  private logGroupMessageDetails(event: GroupWebhookEvent): void {
-    console.log(`  - Sender ID: ${event.sender.id}`);
-    console.log(`  - Group ID: ${event.recipient.id}`);
-    if ('oa_id' in event) {
-      console.log(`  - OA ID: ${event.oa_id}`);
-    }
-    if ('message' in event && event.message.text) {
-      console.log(`  - Text: ${event.message.text}`);
-    }
-  }
-
-  /**
-   * Log chi tiết OA to user
-   */
-  private logOAToUserDetails(event: OAMessageWebhookEvent): void {
-    console.log(`  - OA ID: ${event.sender.id}`);
-    console.log(`  - User ID: ${event.recipient.id}`);
-    if ('message' in event && event.message.text) {
-      console.log(`  - Text: ${event.message.text}`);
-    }
-  }
-
-  /**
-   * Log chi tiết OA to group
-   */
-  private logOAToGroupDetails(event: GroupWebhookEvent): void {
-    console.log(`  - OA ID: ${event.sender.id}`);
-    console.log(`  - Group ID: ${event.recipient.id}`);
-    if ('oa_id' in event) {
-      console.log(`  - OA ID: ${event.oa_id}`);
-    }
-    if ('message' in event && event.message.text) {
-      console.log(`  - Text: ${event.message.text}`);
-    }
-  }
-}
-
-/**
- * Ví dụ sử dụng
- */
-export function exampleUsage(): void {
-  const handler = new ZaloWebhookMessageHandler();
-
-  // Ví dụ 1: Tin nhắn từ user cá nhân
-  const userMessage = {
-    app_id: 'test-app',
-    user_id_by_app: 'test-user',
-    event_name: 'user_send_text',
-    timestamp: '1234567890',
-    sender: { id: 'user123' },
-    recipient: { id: 'oa123' },
-    message: { msg_id: 'msg123', text: 'Xin chào!' }
-  };
-
-  console.log('=== Example 1: User Message ===');
-  handler.handleWebhook(userMessage as any);
-
-  // Ví dụ 2: Tin nhắn từ group
-  const groupMessage = {
-    app_id: 'test-app',
-    user_id_by_app: 'test-user',
-    event_name: 'user_send_group_text',
-    timestamp: '1234567890',
-    oa_id: 'oa123',
-    sender: { id: 'user456' },
-    recipient: { id: 'group789' },
-    message: { msg_id: 'msg456', text: 'Hello group!' }
-  };
-
-  console.log('\n=== Example 2: Group Message ===');
-  handler.handleWebhook(groupMessage as any);
-
-  // Ví dụ 3: OA gửi cho user
-  const oaToUserMessage = {
-    app_id: 'test-app',
-    user_id_by_app: 'test-user',
-    event_name: 'oa_send_text',
-    timestamp: '1234567890',
-    sender: { id: 'oa123' },
-    recipient: { id: 'user789' },
-    message: { msg_id: 'msg789', text: 'Cảm ơn bạn đã liên hệ!' }
-  };
-
-  console.log('\n=== Example 3: OA to User Message ===');
-  handler.handleWebhook(oaToUserMessage as any);
-
-  // Ví dụ 4: OA gửi tới group
-  const oaToGroupMessage = {
-    app_id: 'test-app',
-    user_id_by_app: 'test-user',
-    event_name: 'oa_send_group_text',
-    timestamp: '1234567890',
-    oa_id: 'oa123',
-    sender: { id: 'oa123' },
-    recipient: { id: 'group456' },
-    message: { msg_id: 'msg101', text: 'Thông báo từ OA!' }
-  };
-
-  console.log('\n=== Example 4: OA to Group Message ===');
-  handler.handleWebhook(oaToGroupMessage as any);
-}
-
-// Chạy ví dụ nếu file được execute trực tiếp
-if (require.main === module) {
-  exampleUsage();
-}