@warriorteam/redai-zalo-sdk 1.26.1 → 1.26.2

package/examples/promotion-examples.ts

@@ -1,514 +0,0 @@
-import { PromotionService } from "../src/services/promotion.service";
-import { ZaloClient } from "../src/clients/zalo-client";
-import { PromotionButtonInput } from "../src/types/promotion";
-
-/**
- * Examples sử dụng Promotion Service với API v3.0
- */
-
-// Khởi tạo service
-const client = new ZaloClient();
-const promotionService = new PromotionService(client);
-
-const ACCESS_TOKEN = "your_access_token_here";
-const USER_ID = "4356639876691778517";
-
-/**
- * Example 1: Gửi promotion message theo format chuẩn docs v3.0
- */
-export async function sendStandardPromotion() {
-  try {
-    const result = await promotionService.sendCustomPromotion(
-      ACCESS_TOKEN,
-      { user_id: USER_ID },
-      {
-        attachmentId: "aERC3A0iYGgQxim8fYIK6fxzsXkaFfq7ZFRB3RCyZH6RyziRis3RNydebK3iSPCJX_cJ3k1nW1EQufjN_pUL1f6Ypq3rTef5nxp6H_HnXKFDiyD5y762HS-baqRpQe5FdA376lTfq1sRyPr8ypd74ecbaLyA-tGmuJ-97W",
-        headerContent: "💥💥Ưu đãi thành viên Platinum💥💥",
-        textContent: "Ưu đãi dành riêng cho khách hàng Nguyen Van A hạng thẻ Platinum<br>Voucher trị giá 150$",
-        tableData: [
-          {
-            key: "Voucher",
-            value: "VC09279222"
-          },
-          {
-            key: "Hạn sử dụng", 
-            value: "30/12/2023"
-          }
-        ],
-        footerText: "Áp dụng tất cả cửa hàng trên toàn quốc",
-        buttons: [
-          {
-            title: "Tham khảo chương trình",
-            imageIcon: "",
-            type: "oa.open.url" as const,
-            payload: {
-              url: "https://oa.zalo.me/home"
-            }
-          },
-          {
-            title: "Liên hệ chăm sóc viên",
-            imageIcon: "aeqg9SYn3nIUYYeWohGI1fYRF3V9f0GHceig8Ckq4WQVcpmWb-9SL8JLPt-6gX0QbTCfSuQv40UEst1imAm53CwFPsQ1jq9MsOnlQe6rIrZOYcrlWBTAKy_UQsV9vnfGozCuOvFfIbN5rcXddFKM4sSYVM0D50I9eWy3",
-            type: "oa.query.hide" as const,
-            payload: "#tuvan" // String trực tiếp theo docs
-          }
-        ],
-        language: "VI"
-      }
-    );
-
-    console.log("Promotion sent successfully:", result);
-    return result;
-  } catch (error) {
-    console.error("Failed to send promotion:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 2: Gửi product promotion
- */
-export async function sendProductPromotion() {
-  try {
-    const result = await promotionService.sendProductPromotion(
-      ACCESS_TOKEN,
-      { user_id: USER_ID },
-      {
-        title: "iPhone 15 Pro Max",
-        description: "Siêu phẩm công nghệ mới nhất từ Apple với chip A17 Pro mạnh mẽ",
-        attachmentId: "your_product_image_attachment_id",
-        originalPrice: 34990000,
-        discountPrice: 29990000,
-        discountPercent: 14,
-        validUntil: "31/12/2024",
-        productUrl: "https://example.com/iphone-15-pro-max"
-      }
-    );
-
-    console.log("Product promotion sent successfully:", result);
-    return result;
-  } catch (error) {
-    console.error("Failed to send product promotion:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 3: Gửi event notification
- */
-export async function sendEventNotification() {
-  try {
-    const result = await promotionService.sendEventNotification(
-      ACCESS_TOKEN,
-      { user_id: USER_ID },
-      {
-        title: "Hội thảo Digital Marketing 2024",
-        description: "Khám phá xu hướng marketing số mới nhất và chiến lược tăng trưởng bền vững",
-        attachmentId: "your_event_image_attachment_id",
-        eventDate: "15/01/2024 - 9:00 AM",
-        location: "Trung tâm Hội nghị Quốc gia, Hà Nội",
-        registrationUrl: "https://example.com/register-event"
-      }
-    );
-
-    console.log("Event notification sent successfully:", result);
-    return result;
-  } catch (error) {
-    console.error("Failed to send event notification:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 4: Gửi newsletter
- */
-export async function sendNewsletter() {
-  try {
-    const result = await promotionService.sendNewsletter(
-      ACCESS_TOKEN,
-      { user_id: USER_ID },
-      {
-        title: "Bản tin công nghệ tuần 52/2024",
-        summary: "Cập nhật những tin tức công nghệ hot nhất trong tuần qua",
-        attachmentId: "your_newsletter_image_attachment_id",
-        articles: [
-          {
-            title: "AI và tương lai của lập trình",
-            url: "https://example.com/ai-programming-future"
-          },
-          {
-            title: "Blockchain trong fintech",
-            url: "https://example.com/blockchain-fintech"
-          },
-          {
-            title: "IoT và smart city",
-            url: "https://example.com/iot-smart-city"
-          }
-        ],
-        unsubscribeUrl: "https://example.com/unsubscribe"
-      }
-    );
-
-    console.log("Newsletter sent successfully:", result);
-    return result;
-  } catch (error) {
-    console.error("Failed to send newsletter:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 5: Demo tất cả button types
- */
-export async function sendAllButtonTypes() {
-  try {
-    const result = await promotionService.sendCustomPromotion(
-      ACCESS_TOKEN,
-      { user_id: USER_ID },
-      {
-        attachmentId: "your_attachment_id",
-        headerContent: "🔘 Demo tất cả button types",
-        textContent: "Thử nghiệm các loại button được hỗ trợ trong Zalo API v3.0",
-        tableData: [
-          { key: "Button types", value: "5 loại" },
-          { key: "Tính năng", value: "Chỉ trên Mobile" }
-        ],
-        buttons: [
-          {
-            title: "Mở URL",
-            type: "oa.open.url" as const,
-            payload: { url: "https://developers.zalo.me/" }
-          },
-          {
-            title: "Query Show",
-            type: "oa.query.show" as const,
-            payload: "#callback_show"
-          },
-          {
-            title: "Query Hide",
-            type: "oa.query.hide" as const,
-            payload: "#callback_hide"
-          },
-          {
-            title: "Gửi SMS",
-            type: "oa.open.sms" as const,
-            payload: {
-              content: "Xin chào từ Zalo OA",
-              phone_code: "84919018791"
-            }
-          },
-          {
-            title: "Gọi điện",
-            type: "oa.open.phone" as const,
-            payload: { phone_code: "84919018791" }
-          }
-        ],
-        language: "VI"
-      }
-    );
-
-    console.log("All button types demo sent successfully:", result);
-    return result;
-  } catch (error) {
-    console.error("Failed to send all button types demo:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 6: Gửi promotion đến nhiều users với tracking
- */
-export async function sendPromotionToMultipleUsers() {
-  try {
-    const userIds = [
-      "4356639876691778517",
-      "1234567890123456789",
-      "9876543210987654321",
-      "5555666677778888999"
-    ];
-
-    console.log(`🚀 Bắt đầu gửi promotion đến ${userIds.length} users...`);
-
-    const result = await promotionService.sendCustomPromotionToMultipleUsers(
-      ACCESS_TOKEN,
-      userIds,
-      {
-        attachmentId: "your_attachment_id",
-        headerContent: "🎉 Khuyến mãi đặc biệt cho bạn!",
-        textContent: "Ưu đãi độc quyền dành riêng cho khách hàng VIP. Nhanh tay đặt hàng để nhận ngay voucher giảm giá!",
-        tableData: [
-          { key: "Mã giảm giá", value: "SAVE50" },
-          { key: "Giảm giá", value: "50%" },
-          { key: "Hạn sử dụng", value: "31/12/2024" },
-          { key: "Áp dụng", value: "Tất cả sản phẩm" }
-        ],
-        footerText: "⏰ Ưu đãi có thời hạn - Đặt hàng ngay!",
-        buttons: [
-          {
-            title: "Mua ngay",
-            type: "oa.open.url" as const,
-            payload: { url: "https://shop.example.com/sale" }
-          },
-          {
-            title: "Xem thêm ưu đãi",
-            type: "oa.query.hide" as const,
-            payload: "#xemthem"
-          }
-        ],
-        language: "VI"
-      },
-      {
-        mode: "sequential", // Gửi tuần tự để tránh rate limit
-        delayMs: 2000, // Delay 2 giây giữa các tin
-        continueOnError: true, // Tiếp tục khi có lỗi
-
-        // Callback tracking progress
-        onProgress: (progress) => {
-          const percent = Math.round((progress.completed / progress.total) * 100);
-          const eta = progress.estimatedTimeRemaining
-            ? Math.round(progress.estimatedTimeRemaining / 1000)
-            : 0;
-
-          console.log(`📊 Progress: ${percent}% (${progress.completed}/${progress.total})`);
-          console.log(`✅ Thành công: ${progress.successful} | ❌ Thất bại: ${progress.failed}`);
-
-          if (progress.currentUserId) {
-            console.log(`🔄 Đang gửi đến user: ${progress.currentUserId}`);
-          }
-
-          if (eta > 0) {
-            console.log(`⏱️ Thời gian còn lại: ~${eta}s`);
-          }
-
-          console.log("---");
-        },
-
-        // Callback cho từng user hoàn thành
-        onUserComplete: (userResult) => {
-          if (userResult.success) {
-            console.log(`✅ Gửi thành công đến user ${userResult.userId}`);
-            console.log(`   Message ID: ${userResult.result?.message_id}`);
-          } else {
-            console.log(`❌ Gửi thất bại đến user ${userResult.userId}`);
-            console.log(`   Lỗi: ${userResult.error?.message}`);
-          }
-        }
-      }
-    );
-
-    // Kết quả cuối cùng
-    console.log("\n🎯 KẾT QUẢ CUỐI CÙNG:");
-    console.log(`📊 Tổng số users: ${result.total}`);
-    console.log(`✅ Thành công: ${result.successful}`);
-    console.log(`❌ Thất bại: ${result.failed}`);
-    console.log(`📈 Tỷ lệ thành công: ${result.successRate.toFixed(1)}%`);
-    console.log(`⏱️ Thời gian thực hiện: ${(result.executionTime / 1000).toFixed(1)}s`);
-    console.log(`🔄 Chế độ gửi: ${result.mode}`);
-
-    // Chi tiết lỗi (nếu có)
-    const failedResults = result.results.filter(r => !r.success);
-    if (failedResults.length > 0) {
-      console.log("\n❌ CHI TIẾT LỖI:");
-      failedResults.forEach(failed => {
-        console.log(`- User ${failed.userId}: ${failed.error?.message}`);
-      });
-    }
-
-    return result;
-  } catch (error) {
-    console.error("Failed to send promotion to multiple users:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 7: Gửi promotion song song (parallel mode)
- */
-export async function sendPromotionParallel() {
-  try {
-    const userIds = ["user1", "user2", "user3"];
-
-    const result = await promotionService.sendCustomPromotionToMultipleUsers(
-      ACCESS_TOKEN,
-      userIds,
-      {
-        attachmentId: "your_attachment_id",
-        headerContent: "⚡ Flash Sale - Chỉ 1 giờ!",
-        textContent: "Giảm giá sốc 70% cho 100 khách hàng đầu tiên!",
-        tableData: [
-          { key: "Giảm giá", value: "70%" },
-          { key: "Thời gian", value: "1 giờ" }
-        ],
-        buttons: [
-          {
-            title: "Mua ngay",
-            type: "oa.open.url" as const,
-            payload: { url: "https://flash-sale.example.com" }
-          }
-        ]
-      },
-      {
-        mode: "parallel", // Gửi song song để tối ưu tốc độ
-        continueOnError: true,
-        onProgress: (progress) => {
-          console.log(`⚡ Parallel sending: ${progress.completed}/${progress.total} completed`);
-        }
-      }
-    );
-
-    console.log(`⚡ Parallel sending completed in ${result.executionTime}ms`);
-    return result;
-  } catch (error) {
-    console.error("Failed to send parallel promotion:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 8: Demo proper TypeScript typing với discriminated union
- */
-export async function sendProperTypedButtons() {
-  try {
-    // TypeScript sẽ enforce đúng payload type cho từng button
-    const result = await promotionService.sendCustomPromotion(
-      ACCESS_TOKEN,
-      { user_id: USER_ID },
-      {
-        attachmentId: "your_attachment_id",
-        headerContent: "🎯 TypeScript Typed Buttons Demo",
-        textContent: "Demo các button types với proper TypeScript typing",
-        tableData: [
-          { key: "Feature", value: "Type Safety" },
-          { key: "Support", value: "Full IntelliSense" }
-        ],
-        buttons: [
-          // URL Button - TypeScript enforces { url: string }
-          {
-            title: "Open Website",
-            type: "oa.open.url",
-            payload: { url: "https://typescript.example.com" }
-            // payload: "invalid" // ❌ TypeScript error!
-          },
-
-          // Query Hide - TypeScript enforces string payload
-          {
-            title: "Hidden Query",
-            type: "oa.query.hide",
-            payload: "#hidden_query"
-            // payload: { invalid: true } // ❌ TypeScript error!
-          },
-
-          // SMS Button - TypeScript enforces proper structure
-          {
-            title: "Send SMS",
-            type: "oa.open.sms",
-            payload: {
-              content: "Hello from typed button!",
-              phone_code: "84919018791"
-              // phoneCode: "84919018791" // ✅ Also supported (camelCase)
-            }
-          },
-
-          // Phone Button - Support both object and string
-          {
-            title: "Call Phone",
-            type: "oa.open.phone",
-            payload: { phone_code: "84919018791" }
-            // payload: "84919018791" // ✅ Also supported (string)
-          }
-        ],
-        language: "VI"
-      }
-    );
-
-    console.log("✅ Properly typed buttons sent successfully:", result);
-    return result;
-  } catch (error) {
-    console.error("❌ Failed to send properly typed buttons:", error);
-    throw error;
-  }
-}
-
-/**
- * Example 9: Demo type safety - compile errors
- */
-export function demoTypeSafety() {
-  // These examples show TypeScript compile-time errors
-
-  /* ❌ This will cause TypeScript error:
-  const invalidButtons: PromotionButtonInput[] = [
-    {
-      title: "Invalid URL",
-      type: "oa.open.url",
-      payload: "just-a-string" // Error: string not assignable to { url: string }
-    },
-    {
-      title: "Invalid SMS",
-      type: "oa.open.sms",
-      payload: { url: "wrong-property" } // Error: missing content and phone_code
-    }
-  ];
-  */
-
-  // ✅ Correct typing:
-  const validButtons: PromotionButtonInput[] = [
-    {
-      title: "Valid URL",
-      type: "oa.open.url",
-      payload: { url: "https://example.com" }
-    },
-    {
-      title: "Valid SMS",
-      type: "oa.open.sms",
-      payload: {
-        content: "Valid message",
-        phone_code: "84919018791"
-      }
-    }
-  ];
-
-  console.log("✅ Valid buttons with proper typing:", validButtons);
-}
-
-/**
- * Chạy tất cả examples
- */
-export async function runAllExamples() {
-  console.log("=== Zalo Promotion API v3.0 Examples ===\n");
-
-  try {
-    console.log("1. Sending standard promotion...");
-    await sendStandardPromotion();
-    console.log("✅ Standard promotion sent\n");
-
-    console.log("2. Sending product promotion...");
-    await sendProductPromotion();
-    console.log("✅ Product promotion sent\n");
-
-    console.log("3. Sending event notification...");
-    await sendEventNotification();
-    console.log("✅ Event notification sent\n");
-
-    console.log("4. Sending newsletter...");
-    await sendNewsletter();
-    console.log("✅ Newsletter sent\n");
-
-    console.log("5. Sending all button types demo...");
-    await sendAllButtonTypes();
-    console.log("✅ All button types demo sent\n");
-
-    console.log("6. Sending promotion to multiple users...");
-    await sendPromotionToMultipleUsers();
-    console.log("✅ Multiple users promotion sent\n");
-
-    console.log("7. Sending promotion in parallel mode...");
-    await sendPromotionParallel();
-    console.log("✅ Parallel promotion sent\n");
-
-    console.log("🎉 All examples completed successfully!");
-  } catch (error) {
-    console.error("❌ Error running examples:", error);
-  }
-}
-
-// Uncomment để chạy examples
-// runAllExamples();

package/examples/send-message-sequence.ts

@@ -1,200 +0,0 @@
-import { ConsultationService, MessageItem, SendMessageSequenceRequest } from "../src/services/consultation.service";
-import { ZaloClient } from "../src/clients/zalo-client";
-
-/**
- * Ví dụ sử dụng API gửi chuỗi tin nhắn tư vấn
- */
-async function sendMessageSequenceExample() {
-  // Khởi tạo Zalo client và consultation service
-  const zaloClient = new ZaloClient();
-  const consultationService = new ConsultationService(zaloClient);
-
-  // Thông tin cấu hình
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  const userId = "USER_ID_TO_SEND_TO";
-
-  // Định nghĩa chuỗi tin nhắn
-  const messages: MessageItem[] = [
-    // 1. Tin nhắn chào hỏi
-    {
-      type: "text",
-      text: "Xin chào! Cảm ơn bạn đã liên hệ với chúng tôi 👋",
-      delay: 2000, // Delay 2 giây sau tin nhắn này
-    },
-
-    // 2. Gửi sticker
-    {
-      type: "sticker",
-      stickerAttachmentId: "STICKER_ID",
-      delay: 1500, // Delay 1.5 giây
-    },
-
-    // 3. Tin nhắn giới thiệu dịch vụ
-    {
-      type: "text",
-      text: "Chúng tôi cung cấp các dịch vụ tư vấn chuyên nghiệp. Dưới đây là một số thông tin chi tiết:",
-      delay: 3000, // Delay 3 giây
-    },
-
-    // 4. Gửi hình ảnh minh họa
-    {
-      type: "image",
-      imageUrl: "https://example.com/service-image.jpg",
-      text: "Dịch vụ tư vấn của chúng tôi",
-      delay: 2000,
-    },
-
-    // 5. Gửi file tài liệu
-    {
-      type: "file",
-      fileToken: "FILE_TOKEN_FROM_UPLOAD_API",
-      delay: 1000,
-    },
-
-    // 6. Gửi GIF
-    {
-      type: "gif",
-      gifUrl: "https://example.com/animation.gif",
-      width: 300,
-      height: 200,
-      text: "Quy trình làm việc của chúng tôi",
-      delay: 2500,
-    },
-
-    // 7. Yêu cầu thông tin người dùng
-    {
-      type: "request_user_info",
-      title: "Đăng ký tư vấn miễn phí",
-      subtitle: "Vui lòng cung cấp thông tin để chúng tôi hỗ trợ bạn tốt nhất",
-      imageUrl: "https://example.com/consultation-form.jpg",
-      delay: 1000,
-    },
-
-    // 8. Tin nhắn kết thúc (không có delay vì là tin cuối)
-    {
-      type: "text",
-      text: "Cảm ơn bạn! Chúng tôi sẽ liên hệ lại trong thời gian sớm nhất. 🙏",
-    },
-  ];
-
-  // Tạo request
-  const request: SendMessageSequenceRequest = {
-    accessToken,
-    userId,
-    messages,
-    defaultDelay: 1000, // Delay mặc định 1 giây nếu tin nhắn không có delay riêng
-  };
-
-  try {
-    console.log("🚀 Bắt đầu gửi chuỗi tin nhắn...");
-    console.log(`📝 Tổng số tin nhắn: ${messages.length}`);
-    
-    // Gửi chuỗi tin nhắn
-    const result = await consultationService.sendMessageSequence(request);
-
-    console.log("\n✅ Kết quả gửi tin nhắn:");
-    console.log(`✅ Thành công: ${result.successCount}/${messages.length}`);
-    console.log(`❌ Thất bại: ${result.failureCount}/${messages.length}`);
-    console.log(`⏱️ Tổng thời gian: ${result.totalDuration}ms`);
-
-    // In chi tiết kết quả từng tin nhắn
-    console.log("\n📊 Chi tiết từng tin nhắn:");
-    result.results.forEach((messageResult, index) => {
-      const status = messageResult.success ? "✅" : "❌";
-      const time = new Date(messageResult.timestamp).toLocaleTimeString();
-      
-      console.log(`${status} [${index + 1}] ${messageResult.type} - ${time}`);
-      
-      if (messageResult.success && messageResult.response) {
-        console.log(`   📧 Message ID: ${messageResult.response.message_id}`);
-      }
-      
-      if (!messageResult.success && messageResult.error) {
-        console.log(`   ❌ Lỗi: ${messageResult.error}`);
-      }
-    });
-
-  } catch (error) {
-    console.error("❌ Lỗi khi gửi chuỗi tin nhắn:", error);
-  }
-}
-
-/**
- * Ví dụ gửi chuỗi tin nhắn đơn giản chỉ có text
- */
-async function sendSimpleTextSequence() {
-  const zaloClient = new ZaloClient();
-  const consultationService = new ConsultationService(zaloClient);
-
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  const userId = "USER_ID_TO_SEND_TO";
-
-  const messages: MessageItem[] = [
-    {
-      type: "text",
-      text: "Tin nhắn đầu tiên",
-      delay: 1000,
-    },
-    {
-      type: "text", 
-      text: "Tin nhắn thứ hai",
-      delay: 1500,
-    },
-    {
-      type: "text",
-      text: "Tin nhắn cuối cùng",
-    },
-  ];
-
-  const request: SendMessageSequenceRequest = {
-    accessToken,
-    userId,
-    messages,
-  };
-
-  try {
-    const result = await consultationService.sendMessageSequence(request);
-    console.log("Kết quả:", result);
-  } catch (error) {
-    console.error("Lỗi:", error);
-  }
-}
-
-/**
- * Ví dụ gửi chuỗi tin nhắn với delay mặc định
- */
-async function sendSequenceWithDefaultDelay() {
-  const zaloClient = new ZaloClient();
-  const consultationService = new ConsultationService(zaloClient);
-
-  const accessToken = "YOUR_ACCESS_TOKEN";
-  const userId = "USER_ID_TO_SEND_TO";
-
-  // Các tin nhắn không có delay riêng sẽ sử dụng defaultDelay
-  const messages: MessageItem[] = [
-    { type: "text", text: "Tin nhắn 1" },
-    { type: "text", text: "Tin nhắn 2" },
-    { type: "text", text: "Tin nhắn 3" },
-  ];
-
-  const request: SendMessageSequenceRequest = {
-    accessToken,
-    userId,
-    messages,
-    defaultDelay: 2000, // Delay 2 giây giữa các tin nhắn
-  };
-
-  try {
-    const result = await consultationService.sendMessageSequence(request);
-    console.log("Kết quả:", result);
-  } catch (error) {
-    console.error("Lỗi:", error);
-  }
-}
-
-// Export các function để sử dụng
-export {
-  sendMessageSequenceExample,
-  sendSimpleTextSequence,
-  sendSequenceWithDefaultDelay,
-};