@warriorteam/redai-zalo-sdk 1.30.0 → 1.31.0

package/CHANGELOG.md

@@ -2,6 +2,77 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.31.0] - 2025-01-05
+
+### ✨ Added - Complete Purchase API Support
+
+#### 🛒 New Purchase Service
+- **`PurchaseService`** - Complete service for Zalo OA Purchase API v3.0
+- Full support for creating and confirming orders for OA products and services
+- Type-safe order management with comprehensive validation
+
+#### 🎯 Core Purchase Functions
+- **`createOrder()`** - Create orders with product_id or redeem_code
+- **`confirmOrder()`** - Confirm order payment with OTT (One Time Token)
+- **`createOrderWithProduct()`** - Create order with specific product ID
+- **`createOrderWithRedeemCode()`** - Create order with gift/redeem code
+- **`confirmOrderById()`** - Confirm order with separate order ID and token
+
+#### 🏷️ Specialized Product APIs
+- **`createOASubscriptionOrder()`** - Create OA subscription orders (Advanced/Premium 6m/12m)
+- **`createGMFOrder()`** - Create Group Message Framework orders (10/50/100/1000 members)
+- **`createTransactionQuotaOrder()`** - Create transaction message quota orders (5k/50k/500k)
+
+#### 📦 Batch & Combo Operations
+- **`createMultipleOrders()`** - Create multiple orders in batch with error isolation
+- **`createOAPremiumGMFCombo()`** - Create Premium + GMF combo packages
+- **`recommendProducts()`** - Smart product recommendation system
+
+#### 🗂️ Product Management
+- **`getProductInfo()`** - Get detailed product information by ID
+- **`getAllProducts()`** - Get all available products
+- **`getProductsByCategory()`** - Filter products by category (subscription/gmf/quota)
+- **`getProductsByBeneficiary()`** - Filter products by beneficiary (OA/APP)
+- **`isProductCompatibleWithBeneficiary()`** - Validate product compatibility
+
+#### 🕐 Order Timing & Validation
+- **`isOrderCreationTimeValid()`** - Check if current time allows order creation (00:01-23:54)
+- **`calculateOTTExpiration()`** - Calculate OTT expiration time (5 minutes)
+- **`isOTTValid()`** - Check if OTT is still valid
+
+#### 📋 TypeScript Interfaces & Types
+- **`CreateOrderRequest`** - Union type for product_id or redeem_code orders
+- **`CreateOrderWithProductRequest`** - Interface for product-based orders
+- **`CreateOrderWithRedeemRequest`** - Interface for redeem code orders
+- **`ConfirmOrderRequest`** - Interface for order confirmation
+- **`OrderData`** - Complete order data with verified_token (OTT)
+- **`ConfirmedOrderData`** - Confirmed order data (without OTT)
+- **`ProductInfo`** - Product information interface
+- **`BeneficiaryType`** - Type for OA/APP beneficiaries
+
+#### 🏪 Complete Product Catalog
+- **OA Subscription Products**:
+  - OA Advanced 6/12 months
+  - OA Premium 6/12 months
+- **GMF Products**:
+  - GMF 10/50/100/1000 members
+- **Transaction Quota Products**:
+  - 5k/50k/500k transaction messages (1 month)
+
+#### ✅ Advanced Features
+- **Automatic Validation**: Product-beneficiary compatibility checking
+- **Error Isolation**: Batch operations continue on individual failures
+- **Smart Recommendations**: AI-powered product suggestions based on requirements
+- **Time Validation**: Automatic order creation time window checking
+- **OTT Management**: Complete One Time Token lifecycle management
+- **Type Safety**: Full TypeScript support with compile-time validation
+
+#### 🔧 Error Handling & Validation
+- Comprehensive error codes for all purchase scenarios
+- Detailed validation for all request parameters
+- Graceful error handling in batch operations
+- Clear error messages with context information
+
 ## [1.30.0] - 2025-01-05
 
 ### ✨ Added - Template Message Support for ConsultationService

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from "./types/article";
 export * from "./types/broadcast";
 export * from "./types/promotion";
 export * from "./types/consultation";
+export * from "./types/purchase";
 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, AnonymousTextMessage, AnonymousImageMessage, AnonymousFileMessage, AnonymousStickerMessage, MiniAppMessage, ExtendedMessage, } from "./types/message";
 export * from "./types/webhook";
@@ -40,6 +41,7 @@ export { PromotionService } from "./services/promotion.service";
 export { GeneralMessageService } from "./services/general-message.service";
 export { MessageManagementService, UploadFileResult, UploadImageResult, MessageQuotaInfo, ConversationMessage, Conversation, MessagePagination } from "./services/message-management.service";
 export { BroadcastService } from "./services/broadcast.service";
+export { PurchaseService } from "./services/purchase.service";
 export { ZaloSDK } from "./zalo-sdk";
 export { ZaloSDK as default } from "./zalo-sdk";
 //# sourceMappingURL=index.d.ts.map

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":"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"}

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.BroadcastService = 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;
+exports.default = exports.ZaloSDK = exports.PurchaseService = exports.BroadcastService = 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);
@@ -35,6 +35,7 @@ __exportStar(require("./types/article"), exports);
 __exportStar(require("./types/broadcast"), exports);
 __exportStar(require("./types/promotion"), exports);
 __exportStar(require("./types/consultation"), exports);
+__exportStar(require("./types/purchase"), exports);
 // Export ZNS constants and helpers
 __exportStar(require("./constants/zns.constants"), exports);
 // Export webhook types (avoiding conflicts with message and group types)
@@ -103,6 +104,8 @@ var message_management_service_1 = require("./services/message-management.servic
 Object.defineProperty(exports, "MessageManagementService", { enumerable: true, get: function () { return message_management_service_1.MessageManagementService; } });
 var broadcast_service_1 = require("./services/broadcast.service");
 Object.defineProperty(exports, "BroadcastService", { enumerable: true, get: function () { return broadcast_service_1.BroadcastService; } });
+var purchase_service_1 = require("./services/purchase.service");
+Object.defineProperty(exports, "PurchaseService", { enumerable: true, get: function () { return purchase_service_1.PurchaseService; } });
 // Export main SDK class
 var zalo_sdk_1 = require("./zalo-sdk");
 Object.defineProperty(exports, "ZaloSDK", { enumerable: true, get: function () { return zalo_sdk_1.ZaloSDK; } });

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;AAChC,oDAAkC;AAClC,oDAAkC;AAClC,uDAAqC;AAErC,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;AAQ1B,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AAEzB,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;AAChC,oDAAkC;AAClC,oDAAkC;AAClC,uDAAqC;AACrC,mDAAiC;AAEjC,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;AAQ1B,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,gEAA8D;AAArD,mHAAA,eAAe,OAAA;AAExB,wBAAwB;AACxB,uCAAqC;AAA5B,mGAAA,OAAO,OAAA;AAEhB,iBAAiB;AACjB,uCAAgD;AAAvC,mGAAA,OAAO,OAAW"}

package/dist/services/purchase.service.d.ts

@@ -0,0 +1,209 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { CreateOrderRequest, OrderData, ConfirmOrderRequest, ConfirmedOrderData, ProductInfo } from "../types/purchase";
+/**
+ * Service xử lý các API mua sản phẩm/dịch vụ OA của Zalo
+ *
+ * ĐIỀU KIỆN SỬ DỤNG PURCHASE API:
+ *
+ * 1. QUYỀN TRUY CẬP:
+ *    - Ứng dụng cần được cấp quyền quản lý "Mua sản phẩm dịch vụ OA"
+ *    - OA phải được xác minh và có quyền bán sản phẩm/dịch vụ
+ *
+ * 2. THỜI GIAN TẠO ĐỚN:
+ *    - Order chỉ được tạo từ 00:01 đến 23:54 hàng ngày
+ *    - Không thể tạo đơn hàng trong khung giờ bảo trì (23:55 - 00:00)
+ *
+ * 3. SẢN PHẨM/DỊCH VỤ:
+ *    - Sản phẩm phải có sẵn và được phép bán
+ *    - Đối tượng thụ hưởng (beneficiary) phải phù hợp với sản phẩm
+ *    - Có thể sử dụng product_id HOẶC redeem_code, không được dùng cả hai
+ *
+ * 4. THANH TOÁN:
+ *    - Tài khoản ZCA phải có đủ số dư để thanh toán
+ *    - Voucher code (nếu có) phải hợp lệ và chưa hết hạn
+ *
+ * 5. XÁC THỰC:
+ *    - Mỗi đơn hàng sẽ có verified_token (OTT) để xác nhận thanh toán
+ *    - OTT có hiệu lực trong vòng 5 phút kể từ khi tạo đơn
+ *
+ * LỖI THƯỜNG GẶP:
+ * - 1001: Beneficiary không hợp lệ
+ * - 1002: Product ID không tồn tại hoặc không khả dụng
+ * - 1003: Redeem code không hợp lệ hoặc đã được sử dụng
+ * - 1004: Voucher code không hợp lệ hoặc đã hết hạn
+ * - 1005: Sản phẩm không khả dụng cho đối tượng thụ hưởng
+ * - 1006: Số dư tài khoản không đủ
+ * - 1007: Ngoài thời gian cho phép tạo đơn hàng
+ * - 1008: Đơn hàng trùng lặp
+ * - 1009: Không có quyền truy cập
+ */
+export declare class PurchaseService {
+    private readonly client;
+    private readonly purchaseApiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Tạo đơn hàng mua sản phẩm/dịch vụ OA
+     * @param accessToken Access token của Official Account
+     * @param request Thông tin đơn hàng cần tạo
+     * @returns Thông tin đơn hàng đã tạo
+     */
+    createOrder(accessToken: string, request: CreateOrderRequest): Promise<OrderData>;
+    /**
+     * Tạo đơn hàng với product_id
+     * @param accessToken Access token của Official Account
+     * @param beneficiary Đối tượng thụ hưởng (OA hoặc APP)
+     * @param productId ID sản phẩm
+     * @param voucherCode Mã giảm giá (tùy chọn)
+     * @returns Thông tin đơn hàng đã tạo
+     */
+    createOrderWithProduct(accessToken: string, beneficiary: "OA" | "APP", productId: number, voucherCode?: string): Promise<OrderData>;
+    /**
+     * Tạo đơn hàng với redeem_code (mã quà tặng)
+     * @param accessToken Access token của Official Account
+     * @param beneficiary Đối tượng thụ hưởng (OA hoặc APP)
+     * @param redeemCode Mã quà tặng
+     * @param voucherCode Mã giảm giá (tùy chọn)
+     * @returns Thông tin đơn hàng đã tạo
+     */
+    createOrderWithRedeemCode(accessToken: string, beneficiary: "OA" | "APP", redeemCode: string, voucherCode?: string): Promise<OrderData>;
+    /**
+     * Validate create order request
+     * @param request Request to validate
+     */
+    private validateCreateOrderRequest;
+    /**
+     * Kiểm tra thời gian có thể tạo đơn hàng
+     * @returns true nếu trong thời gian cho phép tạo đơn hàng
+     */
+    isOrderCreationTimeValid(): boolean;
+    /**
+     * Tính toán thời gian hết hạn của OTT (One Time Token)
+     * @param createdTime Thời gian tạo đơn hàng (milliseconds)
+     * @returns Thời gian hết hạn OTT (milliseconds)
+     */
+    calculateOTTExpiration(createdTime: number): number;
+    /**
+     * Kiểm tra OTT còn hiệu lực hay không
+     * @param createdTime Thời gian tạo đơn hàng (milliseconds)
+     * @returns true nếu OTT còn hiệu lực
+     */
+    isOTTValid(createdTime: number): boolean;
+    /**
+     * Xác nhận thanh toán đơn hàng
+     * @param accessToken Access token của Official Account
+     * @param request Thông tin xác nhận đơn hàng
+     * @returns Thông tin đơn hàng đã được xác nhận thanh toán
+     */
+    confirmOrder(accessToken: string, request: ConfirmOrderRequest): Promise<ConfirmedOrderData>;
+    /**
+     * Xác nhận thanh toán đơn hàng với order ID và verified token
+     * @param accessToken Access token của Official Account
+     * @param orderId ID đơn hàng
+     * @param verifiedToken OTT token để xác nhận
+     * @returns Thông tin đơn hàng đã được xác nhận thanh toán
+     */
+    confirmOrderById(accessToken: string, orderId: string, verifiedToken: string): Promise<ConfirmedOrderData>;
+    /**
+     * Lấy thông tin sản phẩm theo ID
+     * @param productId ID sản phẩm
+     * @returns Thông tin sản phẩm hoặc undefined nếu không tìm thấy
+     */
+    getProductInfo(productId: number): ProductInfo | undefined;
+    /**
+     * Lấy danh sách tất cả sản phẩm có sẵn
+     * @returns Danh sách thông tin sản phẩm
+     */
+    getAllProducts(): ProductInfo[];
+    /**
+     * Lấy danh sách sản phẩm theo loại
+     * @param category Loại sản phẩm
+     * @returns Danh sách sản phẩm thuộc loại đó
+     */
+    getProductsByCategory(category: 'subscription' | 'gmf' | 'quota'): ProductInfo[];
+    /**
+     * Lấy danh sách sản phẩm theo đối tượng thụ hưởng
+     * @param beneficiary Đối tượng thụ hưởng
+     * @returns Danh sách sản phẩm phù hợp với đối tượng thụ hưởng
+     */
+    getProductsByBeneficiary(beneficiary: "OA" | "APP"): ProductInfo[];
+    /**
+     * Kiểm tra sản phẩm có phù hợp với đối tượng thụ hưởng không
+     * @param productId ID sản phẩm
+     * @param beneficiary Đối tượng thụ hưởng
+     * @returns true nếu sản phẩm phù hợp với đối tượng thụ hưởng
+     */
+    isProductCompatibleWithBeneficiary(productId: number, beneficiary: "OA" | "APP"): boolean;
+    /**
+     * Tạo đơn hàng gói OA Subscription
+     * @param accessToken Access token của Official Account
+     * @param subscriptionType Loại gói subscription
+     * @param voucherCode Mã giảm giá (tùy chọn)
+     * @returns Thông tin đơn hàng đã tạo
+     */
+    createOASubscriptionOrder(accessToken: string, subscriptionType: 'advanced_6m' | 'advanced_12m' | 'premium_6m' | 'premium_12m', voucherCode?: string): Promise<OrderData>;
+    /**
+     * Tạo đơn hàng gói GMF (Group Message Framework)
+     * @param accessToken Access token của Official Account
+     * @param memberLimit Giới hạn số thành viên
+     * @param voucherCode Mã giảm giá (tùy chọn)
+     * @returns Thông tin đơn hàng đã tạo
+     */
+    createGMFOrder(accessToken: string, memberLimit: 10 | 50 | 100 | 1000, voucherCode?: string): Promise<OrderData>;
+    /**
+     * Tạo đơn hàng gói quota tin nhắn giao dịch
+     * @param accessToken Access token của Official Account
+     * @param beneficiary Đối tượng thụ hưởng (OA hoặc APP)
+     * @param quotaSize Kích thước gói quota
+     * @param voucherCode Mã giảm giá (tùy chọn)
+     * @returns Thông tin đơn hàng đã tạo
+     */
+    createTransactionQuotaOrder(accessToken: string, beneficiary: "OA" | "APP", quotaSize: '5k' | '50k' | '500k', voucherCode?: string): Promise<OrderData>;
+    /**
+     * Tạo nhiều đơn hàng cùng lúc (batch operation)
+     * @param accessToken Access token của Official Account
+     * @param orders Danh sách đơn hàng cần tạo
+     * @returns Danh sách kết quả tạo đơn hàng
+     */
+    createMultipleOrders(accessToken: string, orders: CreateOrderRequest[]): Promise<Array<{
+        success: boolean;
+        data?: OrderData;
+        error?: string;
+    }>>;
+    /**
+     * Tạo combo đơn hàng OA Premium + GMF
+     * @param accessToken Access token của Official Account
+     * @param premiumDuration Thời hạn gói Premium
+     * @param gmfMemberLimit Giới hạn thành viên GMF
+     * @param voucherCode Mã giảm giá (tùy chọn)
+     * @returns Danh sách kết quả tạo đơn hàng
+     */
+    createOAPremiumGMFCombo(accessToken: string, premiumDuration: '6m' | '12m', gmfMemberLimit: 10 | 50 | 100 | 1000, voucherCode?: string): Promise<{
+        premium: {
+            success: boolean;
+            data?: OrderData;
+            error?: string;
+        };
+        gmf: {
+            success: boolean;
+            data?: OrderData;
+            error?: string;
+        };
+    }>;
+    /**
+     * Gợi ý sản phẩm dựa trên nhu cầu
+     * @param requirements Yêu cầu của khách hàng
+     * @returns Danh sách sản phẩm được gợi ý
+     */
+    recommendProducts(requirements: {
+        beneficiary: "OA" | "APP";
+        budget?: 'low' | 'medium' | 'high';
+        features?: ('subscription' | 'group_messaging' | 'transaction_quota')[];
+        duration?: 'short' | 'long';
+    }): ProductInfo[];
+    /**
+     * Validate confirm order request
+     * @param request Request to validate
+     */
+    private validateConfirmOrderRequest;
+}
+//# sourceMappingURL=purchase.service.d.ts.map

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

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