@warriorteam/redai-zalo-sdk 1.26.1 → 1.27.0

package/examples/group-message-list.ts

@@ -1,288 +0,0 @@
-import { 
-  GroupMessageService, 
-  GroupMessageItem, 
-  SendMessageListToGroupRequest,
-  SendMessageListToMultipleGroupsRequest,
-  GroupMessageProgressInfo,
-  MultipleGroupsProgressInfo 
-} from "../src/services/group-message.service";
-import { ZaloClient } from "../src/clients/zalo-client";
-
-/**
- * Ví dụ sử dụng API gửi danh sách tin nhắn tới 1 group với callback tracking
- */
-async function sendMessageListToGroupExample() {
-  // Khởi tạo Zalo client và group message service
-  const zaloClient = new ZaloClient();
-  const groupMessageService = new GroupMessageService(zaloClient);
-
-  // Thông tin cấu hình
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  const groupId = "GROUP_ID_TO_SEND_TO";
-
-  // Định nghĩa danh sách tin nhắn thông báo
-  const messages: GroupMessageItem[] = [
-    {
-      type: "text",
-      text: "📢 THÔNG BÁO QUAN TRỌNG",
-      delay: 2000,
-    },
-    {
-      type: "text",
-      text: "🔧 Hệ thống sẽ bảo trì từ 2:00 - 4:00 sáng ngày mai (15/09/2024)",
-      delay: 1500,
-    },
-    {
-      type: "image",
-      imageUrl: "https://example.com/maintenance-schedule.jpg",
-      caption: "Lịch trình bảo trì chi tiết",
-      delay: 2000,
-    },
-    {
-      type: "text",
-      text: "⚠️ Trong thời gian bảo trì, các dịch vụ sau sẽ tạm ngưng:\n• Website chính\n• Mobile App\n• API Services",
-      delay: 1500,
-    },
-    {
-      type: "sticker",
-      stickerId: "MAINTENANCE_STICKER_ID",
-      delay: 1000,
-    },
-    {
-      type: "text",
-      text: "📞 Hotline hỗ trợ khẩn cấp: 1900-xxxx\n📧 Email: support@company.com",
-    },
-  ];
-
-  // Callback function để tracking tiến trình
-  const onProgress = (progress: GroupMessageProgressInfo) => {
-    const percentage = Math.round(((progress.messageIndex + 1) / progress.totalMessages) * 100);
-    
-    switch (progress.status) {
-      case 'started':
-        console.log(`🚀 [${percentage}%] Bắt đầu gửi tin nhắn ${progress.messageIndex + 1}/${progress.totalMessages} (${progress.messageType})`);
-        break;
-        
-      case 'completed':
-        const duration = progress.endTime ? progress.endTime - progress.startTime : 0;
-        console.log(`✅ [${percentage}%] Hoàn thành tin nhắn ${progress.messageIndex + 1}/${progress.totalMessages} - ${duration}ms`);
-        break;
-        
-      case 'failed':
-        const failDuration = progress.endTime ? progress.endTime - progress.startTime : 0;
-        console.log(`❌ [${percentage}%] Thất bại tin nhắn ${progress.messageIndex + 1}/${progress.totalMessages} - ${failDuration}ms - Lỗi: ${progress.error}`);
-        break;
-    }
-  };
-
-  // Tạo request
-  const request: SendMessageListToGroupRequest = {
-    accessToken,
-    groupId,
-    messages,
-    defaultDelay: 1000, // Delay mặc định 1 giây giữa các tin nhắn
-    onProgress, // Callback tracking
-  };
-
-  try {
-    console.log("📢 Bắt đầu gửi danh sách tin nhắn thông báo tới group...");
-    console.log(`👥 Group ID: ${groupId}`);
-    console.log(`📝 Tổng số tin nhắn: ${messages.length}`);
-    console.log("─".repeat(60));
-    
-    // Gửi danh sách tin nhắn tới group
-    const result = await groupMessageService.sendMessageListToGroup(request);
-
-    console.log("─".repeat(60));
-    console.log("🎊 KẾT QUẢ:");
-    console.log(`📝 Tổng tin nhắn: ${result.totalMessages}`);
-    console.log(`✅ Thành công: ${result.successfulMessages} (${Math.round((result.successfulMessages / result.totalMessages) * 100)}%)`);
-    console.log(`❌ Thất bại: ${result.failedMessages} (${Math.round((result.failedMessages / result.totalMessages) * 100)}%)`);
-    console.log(`⏱️ Tổng thời gian: ${result.totalDuration}ms (${Math.round(result.totalDuration / 1000)}s)`);
-
-    // In chi tiết từng tin nhắn
-    console.log("\n📋 CHI TIẾT TỪNG TIN NHẮN:");
-    result.messageResults.forEach((messageResult, index) => {
-      const status = messageResult.success ? "✅" : "❌";
-      console.log(`${status} [${index + 1}] ${messageResult.messageType} - ${messageResult.duration}ms`);
-      
-      if (!messageResult.success && messageResult.error) {
-        console.log(`   ❌ Lỗi: ${messageResult.error}`);
-      }
-    });
-
-  } catch (error) {
-    console.error("❌ Lỗi khi gửi danh sách tin nhắn tới group:", error);
-  }
-}
-
-/**
- * Ví dụ gửi danh sách tin nhắn tới nhiều groups
- */
-async function sendMessageListToMultipleGroupsExample() {
-  const zaloClient = new ZaloClient();
-  const groupMessageService = new GroupMessageService(zaloClient);
-
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  const groupIds = [
-    "GROUP_ID_1",
-    "GROUP_ID_2", 
-    "GROUP_ID_3",
-    "GROUP_ID_4"
-  ];
-
-  // Danh sách tin nhắn marketing
-  const messages: GroupMessageItem[] = [
-    {
-      type: "text",
-      text: "🎉 FLASH SALE 24H - GIẢM GIÁ SỐC!",
-      delay: 2000,
-    },
-    {
-      type: "image",
-      imageUrl: "https://example.com/flash-sale-banner.jpg",
-      caption: "🔥 Giảm tới 70% + Freeship toàn quốc",
-      delay: 3000,
-    },
-    {
-      type: "text",
-      text: "⏰ Chỉ còn 12 giờ! Số lượng có hạn!\n🛒 Mua ngay: https://shop.example.com/flash-sale",
-      delay: 1500,
-    },
-    {
-      type: "sticker",
-      stickerId: "SALE_STICKER_ID",
-    },
-  ];
-
-  // Callback tracking cho multiple groups
-  let completedGroups = 0;
-  const onProgress = (progress: MultipleGroupsProgressInfo) => {
-    switch (progress.status) {
-      case 'started':
-        console.log(`🎯 Bắt đầu gửi tới Group ${progress.groupIndex + 1}/${progress.totalGroups} (${progress.groupId})`);
-        break;
-        
-      case 'completed':
-        completedGroups++;
-        const successRate = progress.result ? 
-          Math.round((progress.result.successfulMessages / progress.result.totalMessages) * 100) : 0;
-        console.log(`✅ Hoàn thành Group ${completedGroups}/${progress.totalGroups} - Thành công: ${successRate}%`);
-        break;
-        
-      case 'failed':
-        console.log(`❌ Thất bại Group ${progress.groupIndex + 1}/${progress.totalGroups} - Lỗi: ${progress.error}`);
-        break;
-    }
-  };
-
-  const request: SendMessageListToMultipleGroupsRequest = {
-    accessToken,
-    groupIds,
-    messages,
-    defaultDelay: 1000, // Delay giữa tin nhắn
-    delayBetweenGroups: 3000, // Delay 3 giây giữa các groups
-    onProgress,
-  };
-
-  try {
-    console.log("🎯 Bắt đầu chiến dịch marketing tới nhiều groups...");
-    console.log(`👥 Tổng số groups: ${groupIds.length}`);
-    console.log(`📝 Tổng số tin nhắn mỗi group: ${messages.length}`);
-    console.log(`📊 Tổng số tin nhắn sẽ gửi: ${groupIds.length * messages.length}`);
-    console.log("─".repeat(60));
-    
-    const result = await groupMessageService.sendMessageListToMultipleGroups(request);
-
-    console.log("─".repeat(60));
-    console.log("🎊 KẾT QUẢ TỔNG QUAN:");
-    console.log(`👥 Tổng groups: ${result.totalGroups}`);
-    console.log(`✅ Groups thành công: ${result.successfulGroups} (${Math.round((result.successfulGroups / result.totalGroups) * 100)}%)`);
-    console.log(`❌ Groups thất bại: ${result.failedGroups} (${Math.round((result.failedGroups / result.totalGroups) * 100)}%)`);
-    console.log(`⏱️ Tổng thời gian: ${result.totalDuration}ms (${Math.round(result.totalDuration / 1000)}s)`);
-    
-    console.log("\n📊 THỐNG KÊ TIN NHẮN:");
-    console.log(`✅ Tin nhắn thành công: ${result.messageStats.totalSuccessfulMessages}`);
-    console.log(`❌ Tin nhắn thất bại: ${result.messageStats.totalFailedMessages}`);
-    console.log(`📝 Tổng tin nhắn: ${result.messageStats.totalMessages}`);
-    console.log(`📈 Tỷ lệ thành công: ${Math.round((result.messageStats.totalSuccessfulMessages / result.messageStats.totalMessages) * 100)}%`);
-
-    // In chi tiết từng group
-    console.log("\n📋 CHI TIẾT TỪNG GROUP:");
-    result.groupResults.forEach((groupResult, index) => {
-      const status = groupResult.success ? "✅" : "❌";
-      const successRate = groupResult.messageListResult ? 
-        Math.round((groupResult.messageListResult.successfulMessages / groupResult.messageListResult.totalMessages) * 100) : 0;
-      
-      console.log(`${status} Group ${index + 1}: ${groupResult.groupId} - ${groupResult.duration}ms - Thành công: ${successRate}%`);
-      
-      if (!groupResult.success && groupResult.error) {
-        console.log(`   ❌ Lỗi: ${groupResult.error}`);
-      }
-    });
-
-  } catch (error) {
-    console.error("❌ Lỗi khi gửi danh sách tin nhắn tới nhiều groups:", error);
-  }
-}
-
-/**
- * Ví dụ gửi tin nhắn mention tới group
- */
-async function sendMentionMessageListExample() {
-  const zaloClient = new ZaloClient();
-  const groupMessageService = new GroupMessageService(zaloClient);
-
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  const groupId = "GROUP_ID";
-
-  const messages: GroupMessageItem[] = [
-    {
-      type: "text",
-      text: "🎯 Cuộc họp quan trọng sắp diễn ra!",
-      delay: 1000,
-    },
-    {
-      type: "mention",
-      text: "@Admin @Manager Vui lòng chuẩn bị tài liệu cho cuộc họp lúc 14:00",
-      mentions: [
-        { user_id: "ADMIN_USER_ID", offset: 0, length: 6 },
-        { user_id: "MANAGER_USER_ID", offset: 7, length: 8 }
-      ],
-      delay: 2000,
-    },
-    {
-      type: "text",
-      text: "📋 Agenda:\n1. Báo cáo tháng\n2. Kế hoạch quý mới\n3. Q&A",
-    },
-  ];
-
-  const onProgress = (progress: GroupMessageProgressInfo) => {
-    if (progress.status === 'completed') {
-      console.log(`✅ Đã gửi tin nhắn ${progress.messageIndex + 1}: ${progress.messageType}`);
-    } else if (progress.status === 'failed') {
-      console.log(`❌ Gửi thất bại tin nhắn ${progress.messageIndex + 1}: ${progress.error}`);
-    }
-  };
-
-  try {
-    const result = await groupMessageService.sendMessageListToGroup({
-      accessToken,
-      groupId,
-      messages,
-      defaultDelay: 1500,
-      onProgress,
-    });
-
-    console.log(`\n📢 Đã gửi thông báo cuộc họp: ${result.successfulMessages}/${result.totalMessages} tin nhắn thành công`);
-  } catch (error) {
-    console.error("❌ Lỗi gửi thông báo cuộc họp:", error);
-  }
-}
-
-// Export các function để sử dụng
-export {
-  sendMessageListToGroupExample,
-  sendMessageListToMultipleGroupsExample,
-  sendMentionMessageListExample,
-};

package/examples/oa-auth-with-pkce.ts

@@ -1,179 +0,0 @@
-/**
- * Example: Official Account Authentication with PKCE
- * Demonstrates how to use the updated createOAAuthUrl method with PKCE support
- */
-
-import { ZaloSDK } from '../src';
-
-// Initialize SDK
-const sdk = new ZaloSDK({
-  appId: 'your_app_id',
-  appSecret: 'your_app_secret',
-});
-
-// Example 1: Basic OA Auth without PKCE
-async function basicOAAuth() {
-  console.log('=== Basic OA Auth (without PKCE) ===');
-  
-  const redirectUri = 'https://your-app.com/callback';
-  
-  // Create auth URL - state will be auto-generated with 'zalo_oa_' prefix
-  const authResult = sdk.auth.createOAAuthUrl(redirectUri);
-  
-  console.log('Authorization URL:', authResult.url);
-  console.log('Generated State:', authResult.state);
-  
-  // You can also provide custom state
-  const customAuthResult = sdk.auth.createOAAuthUrl(redirectUri, 'my_custom_state');
-  console.log('Custom State URL:', customAuthResult.url);
-  console.log('Custom State:', customAuthResult.state);
-}
-
-// Example 2: OA Auth with PKCE for enhanced security (Manual PKCE)
-async function oaAuthWithPKCE() {
-  console.log('\n=== OA Auth with Manual PKCE ===');
-
-  const redirectUri = 'https://your-app.com/callback';
-
-  // Step 1: Generate PKCE configuration
-  const pkce = sdk.auth.generatePKCE();
-  console.log('Generated PKCE:');
-  console.log('- Code Verifier:', pkce.code_verifier);
-  console.log('- Code Challenge:', pkce.code_challenge);
-  console.log('- Challenge Method:', pkce.code_challenge_method);
-
-  // Step 2: Create auth URL with manual PKCE
-  const authResult = sdk.auth.createOAAuthUrl(redirectUri, undefined, pkce, true);
-
-  console.log('\nAuthorization URL with PKCE:', authResult.url);
-  console.log('Generated State:', authResult.state);
-  console.log('Used PKCE:', authResult.pkce);
-
-  // IMPORTANT: Store the code_verifier and state for later use
-  // You'll need these when exchanging the authorization code for access token
-  console.log('\n⚠️  IMPORTANT: Store these values for token exchange:');
-  console.log('- Code Verifier:', pkce.code_verifier);
-  console.log('- State:', authResult.state);
-
-  return { pkce, state: authResult.state };
-}
-
-// Example 2b: OA Auth with Auto-Generated PKCE
-async function oaAuthWithAutoPKCE() {
-  console.log('\n=== OA Auth with Auto-Generated PKCE ===');
-
-  const redirectUri = 'https://your-app.com/callback';
-
-  // Create auth URL with auto-generated PKCE (pkce=undefined, usePkce=true)
-  const authResult = sdk.auth.createOAAuthUrl(redirectUri, undefined, undefined, true);
-
-  console.log('Authorization URL with Auto PKCE:', authResult.url);
-  console.log('Generated State:', authResult.state);
-  console.log('Auto-Generated PKCE:', authResult.pkce);
-
-  // IMPORTANT: Store the auto-generated PKCE and state
-  console.log('\n⚠️  IMPORTANT: Store these auto-generated values:');
-  console.log('- Code Verifier:', authResult.pkce?.code_verifier);
-  console.log('- State:', authResult.state);
-
-  return authResult;
-}
-
-// Example 3: Complete flow - Authorization + Token Exchange
-async function completeOAFlow() {
-  console.log('\n=== Complete OA Flow with PKCE ===');
-  
-  const redirectUri = 'https://your-app.com/callback';
-  
-  // Step 1: Generate PKCE and create auth URL
-  const pkce = sdk.auth.generatePKCE();
-  const authResult = sdk.auth.createOAAuthUrl(redirectUri, 'my_oa_flow', pkce);
-  
-  console.log('1. Redirect user to:', authResult.url);
-  console.log('2. Store state and code_verifier:', {
-    state: authResult.state,
-    code_verifier: pkce.code_verifier
-  });
-  
-  // Step 2: After user authorizes and returns with code
-  // (This would happen in your callback handler)
-  const simulateCallback = async (authorizationCode: string, returnedState: string) => {
-    console.log('\n3. User returned with authorization code');
-    
-    // Verify state matches
-    if (returnedState !== authResult.state) {
-      throw new Error('State mismatch - possible CSRF attack');
-    }
-    
-    // Step 3: Exchange code for access token with PKCE
-    try {
-      const tokenResult = await sdk.auth.getOAAccessToken({
-        app_id: 'your_app_id',
-        app_secret: 'your_app_secret',
-        code: authorizationCode,
-        redirect_uri: redirectUri,
-        code_verifier: pkce.code_verifier, // Include code_verifier for PKCE
-      });
-      
-      console.log('4. Successfully obtained access token:', {
-        access_token: tokenResult.access_token.substring(0, 20) + '...',
-        expires_in: tokenResult.expires_in,
-        has_refresh_token: !!tokenResult.refresh_token
-      });
-      
-      return tokenResult;
-    } catch (error) {
-      console.error('Failed to exchange code for token:', error);
-      throw error;
-    }
-  };
-  
-  // Simulate the callback (in real app, this would be handled by your callback endpoint)
-  console.log('\n--- Simulating callback ---');
-  // await simulateCallback('simulated_auth_code', authResult.state);
-}
-
-// Example 4: Using getAuthUrls method
-async function getAuthUrlsExample() {
-  console.log('\n=== Get Auth URLs ===');
-  
-  const redirectUri = 'https://your-app.com/callback';
-  const pkce = sdk.auth.generatePKCE();
-  
-  const authUrls = sdk.auth.getAuthUrls(redirectUri, pkce);
-  
-  console.log('All auth URLs:', {
-    oa_auth_url: authUrls.oa_auth_url,
-    social_auth_url: authUrls.social_auth_url,
-    token_url: authUrls.token_url,
-    refresh_url: authUrls.refresh_url
-  });
-}
-
-// Run examples
-async function runExamples() {
-  try {
-    await basicOAAuth();
-    await oaAuthWithPKCE();
-    await oaAuthWithAutoPKCE();
-    await completeOAFlow();
-    await getAuthUrlsExample();
-  } catch (error) {
-    console.error('Example error:', error);
-  }
-}
-
-// Export for use in other files
-export {
-  basicOAAuth,
-  oaAuthWithPKCE,
-  oaAuthWithAutoPKCE,
-  completeOAFlow,
-  getAuthUrlsExample,
-  runExamples
-};
-
-// Run if this file is executed directly
-if (require.main === module) {
-  runExamples();
-}