@warriorteam/redai-zalo-sdk 1.1.0

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

@@ -0,0 +1,110 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { SendMessageResponse, TransactionMessage, MessageRecipient } from "../types/message";
+/**
+ * Service xử lý các API tin nhắn giao dịch của Zalo Official Account
+ *
+ * ĐIỀU KIỆN GỬI TIN GIAO DỊCH:
+ *
+ * 1. THỜI GIAN GỬI:
+ *    - Chỉ được gửi trong vòng 24 giờ kể từ khi người dùng tương tác cuối cùng với OA
+ *    - Tương tác bao gồm: gửi tin nhắn, nhấn button, gọi điện, truy cập website từ OA
+ *
+ * 2. NỘI DUNG TIN NHẮN:
+ *    - Phải liên quan trực tiếp đến giao dịch thực tế
+ *    - Bao gồm: xác nhận đơn hàng, thông báo thanh toán, cập nhật trạng thái giao hàng
+ *    - Không được chứa nội dung quảng cáo, khuyến mãi
+ *
+ * 3. TẦN SUẤT GỬI:
+ *    - Tối đa 3 tin nhắn giao dịch/ngày cho mỗi người dùng
+ *    - Phải có khoảng cách ít nhất 1 giờ giữa các tin nhắn
+ *
+ * 4. ĐỊNH DẠNG:
+ *    - Phải sử dụng template được Zalo phê duyệt trước
+ *    - Template phải tuân thủ format chuẩn của tin giao dịch
+ *
+ * 5. NGƯỜI DÙNG:
+ *    - Người dùng phải đã follow OA
+ *    - Người dùng không được block OA
+ *    - Người dùng phải có tương tác gần đây với OA
+ *
+ * 6. OFFICIAL ACCOUNT:
+ *    - OA phải được xác minh (verified)
+ *    - OA phải có quyền gửi tin giao dịch được Zalo cấp phép
+ *    - OA không được vi phạm chính sách của Zalo
+ *
+ * LỖI THƯỜNG GẶP:
+ * - 1004: Người dùng chưa follow OA hoặc đã unfollow
+ * - 1005: Vượt quá thời gian 24 giờ từ lần tương tác cuối
+ * - 1006: Vượt quá giới hạn 3 tin/ngày
+ * - 1007: Template chưa được phê duyệt hoặc không hợp lệ
+ * - 1008: Nội dung tin nhắn vi phạm chính sách
+ */
+export declare class TransactionService {
+    private readonly client;
+    private readonly transactionApiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Gửi tin nhắn giao dịch
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param message Nội dung tin nhắn giao dịch
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendTransactionMessage(accessToken: string, recipient: MessageRecipient, message: TransactionMessage): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn xác nhận đơn hàng
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param orderInfo Thông tin đơn hàng
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendOrderConfirmation(accessToken: string, recipient: MessageRecipient, orderInfo: {
+        orderId: string;
+        orderDate: string;
+        totalAmount: number;
+        items: Array<{
+            name: string;
+            quantity: number;
+            price: number;
+        }>;
+        customerInfo: {
+            name: string;
+            phone: string;
+            address: string;
+        };
+    }): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn thông báo thanh toán
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param paymentInfo Thông tin thanh toán
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendPaymentNotification(accessToken: string, recipient: MessageRecipient, paymentInfo: {
+        orderId: string;
+        amount: number;
+        paymentMethod: string;
+        paymentDate: string;
+        status: "success" | "failed" | "pending";
+    }): Promise<SendMessageResponse>;
+    /**
+     * Gửi tin nhắn cập nhật trạng thái giao hàng
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param shippingInfo Thông tin giao hàng
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendShippingUpdate(accessToken: string, recipient: MessageRecipient, shippingInfo: {
+        orderId: string;
+        trackingNumber: string;
+        status: "preparing" | "shipped" | "in_transit" | "delivered";
+        estimatedDelivery?: string;
+        carrier?: string;
+    }): Promise<SendMessageResponse>;
+    /**
+     * Validate transaction message format
+     * @param message Transaction message to validate
+     */
+    private validateTransactionMessage;
+}
+//# sourceMappingURL=transaction.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.service.d.ts","sourceRoot":"","sources":["../../src/services/transaction.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CACsB;gBAE3B,MAAM,EAAE,UAAU;IAE/C;;;;;;OAMG;IACU,sBAAsB,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;;;;;OAMG;IACU,qBAAqB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;QACH,YAAY,EAAE;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,GACA,OAAO,CAAC,mBAAmB,CAAC;IAuC/B;;;;;;OAMG;IACU,uBAAuB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;KAC1C,GACA,OAAO,CAAC,mBAAmB,CAAC;IAiD/B;;;;;;OAMG;IACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;QAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,mBAAmB,CAAC;IAgD/B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;CAmBnC"}

package/dist/services/transaction.service.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionService = void 0;
+const common_1 = require("../types/common");
+/**
+ * Service xử lý các API tin nhắn giao dịch của Zalo Official Account
+ *
+ * ĐIỀU KIỆN GỬI TIN GIAO DỊCH:
+ *
+ * 1. THỜI GIAN GỬI:
+ *    - Chỉ được gửi trong vòng 24 giờ kể từ khi người dùng tương tác cuối cùng với OA
+ *    - Tương tác bao gồm: gửi tin nhắn, nhấn button, gọi điện, truy cập website từ OA
+ *
+ * 2. NỘI DUNG TIN NHẮN:
+ *    - Phải liên quan trực tiếp đến giao dịch thực tế
+ *    - Bao gồm: xác nhận đơn hàng, thông báo thanh toán, cập nhật trạng thái giao hàng
+ *    - Không được chứa nội dung quảng cáo, khuyến mãi
+ *
+ * 3. TẦN SUẤT GỬI:
+ *    - Tối đa 3 tin nhắn giao dịch/ngày cho mỗi người dùng
+ *    - Phải có khoảng cách ít nhất 1 giờ giữa các tin nhắn
+ *
+ * 4. ĐỊNH DẠNG:
+ *    - Phải sử dụng template được Zalo phê duyệt trước
+ *    - Template phải tuân thủ format chuẩn của tin giao dịch
+ *
+ * 5. NGƯỜI DÙNG:
+ *    - Người dùng phải đã follow OA
+ *    - Người dùng không được block OA
+ *    - Người dùng phải có tương tác gần đây với OA
+ *
+ * 6. OFFICIAL ACCOUNT:
+ *    - OA phải được xác minh (verified)
+ *    - OA phải có quyền gửi tin giao dịch được Zalo cấp phép
+ *    - OA không được vi phạm chính sách của Zalo
+ *
+ * LỖI THƯỜNG GẶP:
+ * - 1004: Người dùng chưa follow OA hoặc đã unfollow
+ * - 1005: Vượt quá thời gian 24 giờ từ lần tương tác cuối
+ * - 1006: Vượt quá giới hạn 3 tin/ngày
+ * - 1007: Template chưa được phê duyệt hoặc không hợp lệ
+ * - 1008: Nội dung tin nhắn vi phạm chính sách
+ */
+class TransactionService {
+    constructor(client) {
+        this.client = client;
+        this.transactionApiUrl = "https://openapi.zalo.me/v2.0/oa/message/transaction";
+    }
+    /**
+     * Gửi tin nhắn giao dịch
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param message Nội dung tin nhắn giao dịch
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendTransactionMessage(accessToken, recipient, message) {
+        try {
+            // Validate transaction message
+            this.validateTransactionMessage(message);
+            const request = {
+                recipient,
+                message,
+            };
+            const result = await this.client.apiPost(this.transactionApiUrl, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to send transaction message", result.error, result);
+            }
+            if (!result.data) {
+                throw new common_1.ZaloSDKError("No response data received", -1);
+            }
+            return result.data;
+        }
+        catch (error) {
+            if (error instanceof common_1.ZaloSDKError) {
+                throw error;
+            }
+            throw new common_1.ZaloSDKError(`Failed to send transaction message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Gửi tin nhắn xác nhận đơn hàng
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param orderInfo Thông tin đơn hàng
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendOrderConfirmation(accessToken, recipient, orderInfo) {
+        try {
+            const message = {
+                type: "transaction",
+                attachment: {
+                    type: "template",
+                    payload: {
+                        template_type: "transaction",
+                        elements: [
+                            {
+                                title: `Xác nhận đơn hàng #${orderInfo.orderId}`,
+                                subtitle: `Ngày đặt: ${orderInfo.orderDate}`,
+                                default_action: {
+                                    type: "web_url",
+                                    url: `https://example.com/orders/${orderInfo.orderId}`,
+                                },
+                                buttons: [
+                                    {
+                                        type: "web_url",
+                                        title: "Xem chi tiết",
+                                        url: `https://example.com/orders/${orderInfo.orderId}`,
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            };
+            return this.sendTransactionMessage(accessToken, recipient, message);
+        }
+        catch (error) {
+            throw new common_1.ZaloSDKError(`Failed to send order confirmation: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Gửi tin nhắn thông báo thanh toán
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param paymentInfo Thông tin thanh toán
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendPaymentNotification(accessToken, recipient, paymentInfo) {
+        try {
+            const statusText = {
+                success: "Thành công",
+                failed: "Thất bại",
+                pending: "Đang xử lý",
+            };
+            const message = {
+                type: "transaction",
+                attachment: {
+                    type: "template",
+                    payload: {
+                        template_type: "transaction",
+                        elements: [
+                            {
+                                title: `Thông báo thanh toán - ${statusText[paymentInfo.status]}`,
+                                subtitle: `Đơn hàng #${paymentInfo.orderId} - ${paymentInfo.amount.toLocaleString("vi-VN")} VNĐ`,
+                                default_action: {
+                                    type: "web_url",
+                                    url: `https://example.com/payments/${paymentInfo.orderId}`,
+                                },
+                                buttons: [
+                                    {
+                                        type: "web_url",
+                                        title: "Xem chi tiết",
+                                        url: `https://example.com/payments/${paymentInfo.orderId}`,
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            };
+            return this.sendTransactionMessage(accessToken, recipient, message);
+        }
+        catch (error) {
+            throw new common_1.ZaloSDKError(`Failed to send payment notification: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Gửi tin nhắn cập nhật trạng thái giao hàng
+     * @param accessToken Access token của Official Account
+     * @param recipient Thông tin người nhận
+     * @param shippingInfo Thông tin giao hàng
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    async sendShippingUpdate(accessToken, recipient, shippingInfo) {
+        try {
+            const statusText = {
+                preparing: "Đang chuẩn bị hàng",
+                shipped: "Đã giao cho đơn vị vận chuyển",
+                in_transit: "Đang vận chuyển",
+                delivered: "Đã giao hàng thành công",
+            };
+            const message = {
+                type: "transaction",
+                attachment: {
+                    type: "template",
+                    payload: {
+                        template_type: "transaction",
+                        elements: [
+                            {
+                                title: `Cập nhật giao hàng - ${statusText[shippingInfo.status]}`,
+                                subtitle: `Đơn hàng #${shippingInfo.orderId} - Mã vận đơn: ${shippingInfo.trackingNumber}`,
+                                default_action: {
+                                    type: "web_url",
+                                    url: `https://example.com/tracking/${shippingInfo.trackingNumber}`,
+                                },
+                                buttons: [
+                                    {
+                                        type: "web_url",
+                                        title: "Theo dõi đơn hàng",
+                                        url: `https://example.com/tracking/${shippingInfo.trackingNumber}`,
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            };
+            return this.sendTransactionMessage(accessToken, recipient, message);
+        }
+        catch (error) {
+            throw new common_1.ZaloSDKError(`Failed to send shipping update: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Validate transaction message format
+     * @param message Transaction message to validate
+     */
+    validateTransactionMessage(message) {
+        if (!message.attachment) {
+            throw new common_1.ZaloSDKError("Transaction message must have attachment", -1);
+        }
+        if (!message.attachment.payload) {
+            throw new common_1.ZaloSDKError("Transaction message attachment must have payload", -1);
+        }
+        if (message.attachment.payload.template_type !== "transaction") {
+            throw new common_1.ZaloSDKError("Transaction message must use transaction template type", -1);
+        }
+    }
+}
+exports.TransactionService = TransactionService;
+//# sourceMappingURL=transaction.service.js.map

package/dist/services/transaction.service.js.map

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

package/dist/services/user-management.service.d.ts

@@ -0,0 +1,117 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { UserProfile, UserList, UserTag, UserTagList, UserNote, UserInteraction } from "../types/user-management";
+/**
+ * Service for managing Zalo OA users
+ * Provides comprehensive user management capabilities including:
+ * - User profile management
+ * - User tagging and segmentation
+ * - User notes and interactions
+ * - User analytics and insights
+ */
+export declare class UserManagementService {
+    private readonly client;
+    private readonly apiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Get user profile information
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @returns User profile
+     */
+    getUserProfile(accessToken: string, userId: string): Promise<UserProfile>;
+    /**
+     * Get list of users who follow the OA
+     * @param accessToken OA access token
+     * @param offset Offset for pagination
+     * @param count Number of users to retrieve
+     * @returns User list
+     */
+    getFollowersList(accessToken: string, offset?: number, count?: number): Promise<UserList>;
+    /**
+     * Search users by phone number
+     * @param accessToken OA access token
+     * @param phoneNumber Phone number to search
+     * @returns User profile if found
+     */
+    searchUserByPhone(accessToken: string, phoneNumber: string): Promise<UserProfile | null>;
+    /**
+     * Get user tags
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @returns User tags
+     */
+    getUserTags(accessToken: string, userId: string): Promise<UserTag[]>;
+    /**
+     * Tag user with specific tags
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param tagNames Array of tag names
+     * @returns Tag result
+     */
+    tagUser(accessToken: string, userId: string, tagNames: string[]): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Remove tags from user
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param tagNames Array of tag names to remove
+     * @returns Untag result
+     */
+    untagUser(accessToken: string, userId: string, tagNames: string[]): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get all available tags
+     * @param accessToken OA access token
+     * @returns List of all tags
+     */
+    getAllTags(accessToken: string): Promise<UserTagList>;
+    /**
+     * Create new tag
+     * @param accessToken OA access token
+     * @param tagName Tag name
+     * @returns Created tag
+     */
+    createTag(accessToken: string, tagName: string): Promise<UserTag>;
+    /**
+     * Delete tag
+     * @param accessToken OA access token
+     * @param tagName Tag name to delete
+     * @returns Deletion result
+     */
+    deleteTag(accessToken: string, tagName: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Add note to user
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param note Note content
+     * @returns Note result
+     */
+    addUserNote(accessToken: string, userId: string, note: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get user notes
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @returns User notes
+     */
+    getUserNotes(accessToken: string, userId: string): Promise<UserNote[]>;
+    /**
+     * Get user interaction history
+     * @param accessToken OA access token
+     * @param userId User ID
+     * @param offset Offset for pagination
+     * @param count Number of interactions to retrieve
+     * @returns User interactions
+     */
+    getUserInteractions(accessToken: string, userId: string, offset?: number, count?: number): Promise<{
+        data: UserInteraction[];
+        total: number;
+    }>;
+    private handleUserManagementError;
+}
+//# sourceMappingURL=user-management.service.d.ts.map

package/dist/services/user-management.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-management.service.d.ts","sourceRoot":"","sources":["../../src/services/user-management.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,OAAO,EACP,WAAW,EACX,QAAQ,EACR,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAE/B,MAAM,EAAE,UAAU;IAE/C;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAgBvB;;;;;;OAMG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAiBpB;;;;;OAKG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAgB9B;;;;;OAKG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgB1E;;;;;;OAMG;IACG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiBhC;;;;;;OAMG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiBhC;;;;OAIG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAa3D;;;;;OAKG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBvE;;;;;OAKG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgBhC;;;;;;OAMG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAiBhC;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgB5E;;;;;;;OAOG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBtD,OAAO,CAAC,yBAAyB;CAWlC"}