@warriorteam/redai-zalo-sdk 1.32.17 → 1.33.0

package/dist/services/message-reaction.service.d.ts

@@ -0,0 +1,154 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { MessageRecipient, SenderAction, MessageReactionResponse, ReactIcon } from "../types/message";
+/**
+ * Request thả biểu tượng cảm xúc vào tin nhắn
+ */
+export interface MessageReactionRequest {
+    recipient: MessageRecipient;
+    sender_action: SenderAction;
+}
+/**
+ * Service xử lý API thả biểu tượng cảm xúc vào tin nhắn của Zalo Official Account
+ *
+ * Bao gồm chức năng:
+ * - Thả biểu tượng cảm xúc vào tin nhắn
+ * - Thu hồi biểu tượng cảm xúc
+ *
+ * ĐIỀU KIỆN SỬ DỤNG:
+ *
+ * 1. QUYỀN TRUY CẬP:
+ *    - Cần quyền: Gửi tin nhắn / Thả biểu tượng cảm xúc vào tin nhắn
+ *
+ * 2. GIỚI HẠN:
+ *    - Một message_id chỉ được thả tối đa 50 biểu tượng cảm xúc
+ *    - API này KHÔNG bị tính vào quota chủ động hàng tháng
+ *
+ * 3. CÁC BIỂU TƯỢNG CẢM XÚC HỖ TRỢ:
+ *    - :> (Thích - Like)
+ *    - --b (Haha)
+ *    - :-(( (Buồn - Sad)
+ *    - /-strong (Mạnh mẽ - Strong)
+ *    - /-heart (Yêu thích - Love)
+ *    - :-h (Ngạc nhiên - Wow)
+ *    - :o (Wow)
+ *    - /-remove (Thu hồi biểu tượng cảm xúc)
+ */
+export declare class MessageReactionService {
+    private readonly client;
+    private readonly endpoint;
+    constructor(client: ZaloClient);
+    /**
+     * Thả biểu tượng cảm xúc vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @param reactIcon Biểu tượng cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     *
+     * @example
+     * ```typescript
+     * // Thả icon tim
+     * const result = await reactionService.reactToMessage(
+     *   accessToken,
+     *   '186729651760683225',
+     *   '789f573aecf8a9a4f0eb',
+     *   '/-heart'
+     * );
+     *
+     * // Thu hồi biểu tượng cảm xúc
+     * const removeResult = await reactionService.reactToMessage(
+     *   accessToken,
+     *   '186729651760683225',
+     *   '789f573aecf8a9a4f0eb',
+     *   '/-remove'
+     * );
+     * ```
+     */
+    reactToMessage(accessToken: string, userId: string, messageId: string, reactIcon: ReactIcon): Promise<MessageReactionResponse>;
+    /**
+     * Thả icon "Thích" (Like) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    likeMessage(accessToken: string, userId: string, messageId: string): Promise<MessageReactionResponse>;
+    /**
+     * Thả icon "Haha" vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    hahaMessage(accessToken: string, userId: string, messageId: string): Promise<MessageReactionResponse>;
+    /**
+     * Thả icon "Buồn" (Sad) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    sadMessage(accessToken: string, userId: string, messageId: string): Promise<MessageReactionResponse>;
+    /**
+     * Thả icon "Mạnh mẽ" (Strong) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    strongMessage(accessToken: string, userId: string, messageId: string): Promise<MessageReactionResponse>;
+    /**
+     * Thả icon "Yêu thích" (Love) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    loveMessage(accessToken: string, userId: string, messageId: string): Promise<MessageReactionResponse>;
+    /**
+     * Thả icon "Ngạc nhiên" (Wow) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    wowMessage(accessToken: string, userId: string, messageId: string): Promise<MessageReactionResponse>;
+    /**
+     * Thu hồi biểu tượng cảm xúc khỏi tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thu hồi cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    removeReaction(accessToken: string, userId: string, messageId: string): Promise<MessageReactionResponse>;
+}
+/**
+ * Enum các loại biểu tượng cảm xúc hỗ trợ
+ */
+export declare enum ReactionIcon {
+    /** Thích (Like) */
+    LIKE = ":>",
+    /** Haha */
+    HAHA = "--b",
+    /** Buồn (Sad) */
+    SAD = ":-((",
+    /** Mạnh mẽ (Strong) */
+    STRONG = "/-strong",
+    /** Yêu thích (Love) */
+    HEART = "/-heart",
+    /** Ngạc nhiên (Wow) */
+    WOW_H = ":-h",
+    /** Wow */
+    WOW_O = ":o",
+    /** Thu hồi biểu tượng cảm xúc */
+    REMOVE = "/-remove"
+}
+//# sourceMappingURL=message-reaction.service.d.ts.map

package/dist/services/message-reaction.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-reaction.service.d.ts","sourceRoot":"","sources":["../../src/services/message-reaction.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,aAAa,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;gBAEzC,MAAM,EAAE,UAAU;IAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,uBAAuB,CAAC;IAsEnC;;;;;;;OAOG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;;OAOG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;;OAOG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;;OAOG;IACG,aAAa,CACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;;OAOG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;;OAOG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;;OAOG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;CAGpC;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,mBAAmB;IACnB,IAAI,OAAO;IACX,WAAW;IACX,IAAI,QAAQ;IACZ,iBAAiB;IACjB,GAAG,SAAS;IACZ,uBAAuB;IACvB,MAAM,aAAa;IACnB,uBAAuB;IACvB,KAAK,YAAY;IACjB,uBAAuB;IACvB,KAAK,QAAQ;IACb,UAAU;IACV,KAAK,OAAO;IACZ,iCAAiC;IACjC,MAAM,aAAa;CACpB"}

package/dist/services/message-reaction.service.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactionIcon = exports.MessageReactionService = void 0;
+const common_1 = require("../types/common");
+/**
+ * Service xử lý API thả biểu tượng cảm xúc vào tin nhắn của Zalo Official Account
+ *
+ * Bao gồm chức năng:
+ * - Thả biểu tượng cảm xúc vào tin nhắn
+ * - Thu hồi biểu tượng cảm xúc
+ *
+ * ĐIỀU KIỆN SỬ DỤNG:
+ *
+ * 1. QUYỀN TRUY CẬP:
+ *    - Cần quyền: Gửi tin nhắn / Thả biểu tượng cảm xúc vào tin nhắn
+ *
+ * 2. GIỚI HẠN:
+ *    - Một message_id chỉ được thả tối đa 50 biểu tượng cảm xúc
+ *    - API này KHÔNG bị tính vào quota chủ động hàng tháng
+ *
+ * 3. CÁC BIỂU TƯỢNG CẢM XÚC HỖ TRỢ:
+ *    - :> (Thích - Like)
+ *    - --b (Haha)
+ *    - :-(( (Buồn - Sad)
+ *    - /-strong (Mạnh mẽ - Strong)
+ *    - /-heart (Yêu thích - Love)
+ *    - :-h (Ngạc nhiên - Wow)
+ *    - :o (Wow)
+ *    - /-remove (Thu hồi biểu tượng cảm xúc)
+ */
+class MessageReactionService {
+    constructor(client) {
+        this.client = client;
+        this.endpoint = "https://openapi.zalo.me/v2.0/oa/message";
+    }
+    /**
+     * Thả biểu tượng cảm xúc vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @param reactIcon Biểu tượng cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     *
+     * @example
+     * ```typescript
+     * // Thả icon tim
+     * const result = await reactionService.reactToMessage(
+     *   accessToken,
+     *   '186729651760683225',
+     *   '789f573aecf8a9a4f0eb',
+     *   '/-heart'
+     * );
+     *
+     * // Thu hồi biểu tượng cảm xúc
+     * const removeResult = await reactionService.reactToMessage(
+     *   accessToken,
+     *   '186729651760683225',
+     *   '789f573aecf8a9a4f0eb',
+     *   '/-remove'
+     * );
+     * ```
+     */
+    async reactToMessage(accessToken, userId, messageId, reactIcon) {
+        try {
+            // Validate inputs
+            if (!userId || userId.trim().length === 0) {
+                throw new common_1.ZaloSDKError("User ID không được để trống", -1);
+            }
+            if (!messageId || messageId.trim().length === 0) {
+                throw new common_1.ZaloSDKError("Message ID không được để trống", -1);
+            }
+            // Danh sách các react icon hợp lệ
+            const validIcons = [
+                ":>",
+                "--b",
+                ":-((",
+                "/-strong",
+                "/-heart",
+                ":-h",
+                ":o",
+                "/-remove",
+            ];
+            if (!validIcons.includes(reactIcon)) {
+                throw new common_1.ZaloSDKError(`Biểu tượng cảm xúc không hợp lệ. Các giá trị hợp lệ: ${validIcons.join(", ")}`, -1);
+            }
+            const request = {
+                recipient: {
+                    user_id: userId,
+                },
+                sender_action: {
+                    react_icon: reactIcon,
+                    react_message_id: messageId,
+                },
+            };
+            const result = await this.client.apiPost(this.endpoint, accessToken, request);
+            if (result.error !== 0) {
+                throw new common_1.ZaloSDKError(result.message || "Failed to react to 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 react to message: ${error.message}`, -1, error);
+        }
+    }
+    /**
+     * Thả icon "Thích" (Like) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    async likeMessage(accessToken, userId, messageId) {
+        return this.reactToMessage(accessToken, userId, messageId, ":>");
+    }
+    /**
+     * Thả icon "Haha" vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    async hahaMessage(accessToken, userId, messageId) {
+        return this.reactToMessage(accessToken, userId, messageId, "--b");
+    }
+    /**
+     * Thả icon "Buồn" (Sad) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    async sadMessage(accessToken, userId, messageId) {
+        return this.reactToMessage(accessToken, userId, messageId, ":-((");
+    }
+    /**
+     * Thả icon "Mạnh mẽ" (Strong) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    async strongMessage(accessToken, userId, messageId) {
+        return this.reactToMessage(accessToken, userId, messageId, "/-strong");
+    }
+    /**
+     * Thả icon "Yêu thích" (Love) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    async loveMessage(accessToken, userId, messageId) {
+        return this.reactToMessage(accessToken, userId, messageId, "/-heart");
+    }
+    /**
+     * Thả icon "Ngạc nhiên" (Wow) vào tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thả cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    async wowMessage(accessToken, userId, messageId) {
+        return this.reactToMessage(accessToken, userId, messageId, ":-h");
+    }
+    /**
+     * Thu hồi biểu tượng cảm xúc khỏi tin nhắn
+     *
+     * @param accessToken Access token của Official Account
+     * @param userId ID của người nhận
+     * @param messageId message_id của tin nhắn cần thu hồi cảm xúc
+     * @returns Thông tin tin nhắn phản hồi
+     */
+    async removeReaction(accessToken, userId, messageId) {
+        return this.reactToMessage(accessToken, userId, messageId, "/-remove");
+    }
+}
+exports.MessageReactionService = MessageReactionService;
+/**
+ * Enum các loại biểu tượng cảm xúc hỗ trợ
+ */
+var ReactionIcon;
+(function (ReactionIcon) {
+    /** Thích (Like) */
+    ReactionIcon["LIKE"] = ":>";
+    /** Haha */
+    ReactionIcon["HAHA"] = "--b";
+    /** Buồn (Sad) */
+    ReactionIcon["SAD"] = ":-((";
+    /** Mạnh mẽ (Strong) */
+    ReactionIcon["STRONG"] = "/-strong";
+    /** Yêu thích (Love) */
+    ReactionIcon["HEART"] = "/-heart";
+    /** Ngạc nhiên (Wow) */
+    ReactionIcon["WOW_H"] = ":-h";
+    /** Wow */
+    ReactionIcon["WOW_O"] = ":o";
+    /** Thu hồi biểu tượng cảm xúc */
+    ReactionIcon["REMOVE"] = "/-remove";
+})(ReactionIcon || (exports.ReactionIcon = ReactionIcon = {}));
+//# sourceMappingURL=message-reaction.service.js.map

package/dist/services/message-reaction.service.js.map

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

package/dist/services/miniapp-message.service.d.ts

@@ -0,0 +1,127 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { MessageRecipient, MiniAppMessageRequest, MiniAppMessageResponse } from "../types/message";
+/**
+ * Request gửi tin nhắn miniapp
+ */
+export interface MiniAppSendMessageRequest {
+    recipient: MessageRecipient;
+    message: MiniAppMessageRequest;
+}
+/**
+ * Service xử lý API gửi tin nhắn miniapp của Zalo Official Account
+ *
+ * Bao gồm chức năng:
+ * - Gửi tin nhắn miniapp với template tùy chỉnh
+ *
+ * ĐIỀU KIỆN SỬ DỤNG:
+ *
+ * 1. QUYỀN TRUY CẬP:
+ *    - Cần quyền: Gửi tin và thông báo qua OA
+ *
+ * 2. THÔNG TIN BẮT BUỘC:
+ *    - access_token: Token của OA
+ *    - miniapp_message_token: Token được sinh ra từ miniapp, đại diện cho miniapp
+ *    - user_id: Phải khớp với user đã tương tác với Miniapp
+ *    - template_type: Token của template miniapp
+ *    - template_data: Các thuộc tính của mẫu tin (được quy định theo từng template_type)
+ *
+ * 3. QUOTA (HẠN MỨC):
+ *    API này có thể trả về thông tin quota trong response:
+ *    - reply: Tin Tư vấn miễn phí trong hạn mức 8 tin 48 giờ
+ *    - sub_quota: Tin Tư vấn miễn phí theo gói dịch vụ OA
+ *    - purchase_quota: Tin trong hạn mức gói tính năng lẻ
+ *    - reward_quota: Tin trong hạn mức Redeem code
+ *
+ *    Các loại quota không có thông tin chi tiết:
+ *    - Không có quota info: Tin không tính quota (ví dụ: tin trong 48h không còn hạn mức)
+ */
+export declare class MiniAppMessageService {
+    private readonly client;
+    private readonly endpoint;
+    constructor(client: ZaloClient);
+    /**
+     * Gửi tin nhắn miniapp đến người dùng
+     *
+     * @param accessToken Access token của Official Account
+     * @param miniappMessageToken Token được sinh ra từ miniapp
+     * @param userId ID của người nhận (phải khớp với user đã tương tác với Miniapp)
+     * @param templateType Token của template miniapp
+     * @param templateData Các thuộc tính của mẫu tin (tuỳ theo từng template_type)
+     * @returns Thông tin tin nhắn đã gửi (bao gồm quota info nếu có)
+     *
+     * @example
+     * ```typescript
+     * const result = await miniappService.sendMessage(
+     *   accessToken,
+     *   'miniapp_message_token',
+     *   '4153814862349165539',
+     *   'FB0001',
+     *   {
+     *     customer_name: 'Tùng Nguyễn',
+     *     queue_number: '12',
+     *     note: 'Khách hàng thanh toán bằng thẻ',
+     *     buttons: [
+     *       {
+     *         title: 'Chi tiết đơn hàng',
+     *         image_icon: 'https://stc-zmp.zadn.vn/oa/basket.png',
+     *         url: 'https://zalo.me/s/194839900003483517/'
+     *       },
+     *       {
+     *         title: 'Đánh giá',
+     *         image_icon: 'https://stc-zmp.zadn.vn/oa/star.png',
+     *         url: 'https://zalo.me/s/194839900003483517/'
+     *       }
+     *     ]
+     *   }
+     * );
+     *
+     * // Kiểm tra quota
+     * if (result.quota) {
+     *   console.log('Quota type:', result.quota.quota_type);
+     *   console.log('Remaining:', result.quota.remain);
+     * }
+     * ```
+     */
+    sendMessage(accessToken: string, miniappMessageToken: string, userId: string, templateType: string, templateData: Record<string, any>): Promise<MiniAppMessageResponse>;
+    /**
+     * Gửi tin nhắn miniapp với template queue notification
+     * (Template thông báo số thứ tự trong hàng đợi)
+     *
+     * @param accessToken Access token của Official Account
+     * @param miniappMessageToken Token từ miniapp
+     * @param userId ID của người nhận
+     * @param customerName Tên khách hàng
+     * @param queueNumber Số thứ tự trong hàng đợi
+     * @param note Ghi chú thêm
+     * @param buttons Danh sách các button kèm theo
+     * @returns Thông tin tin nhắn đã gửi
+     */
+    sendQueueNotification(accessToken: string, miniappMessageToken: string, userId: string, customerName: string, queueNumber: string, note: string, buttons?: Array<{
+        title: string;
+        image_icon: string;
+        url: string;
+    }>): Promise<MiniAppMessageResponse>;
+}
+/**
+ * Enum các loại quota (hạn mức) khi gửi tin nhắn miniapp
+ */
+export declare enum MiniAppQuotaType {
+    /** Tin Tư vấn miễn phí trong hạn mức 8 tin 48 giờ */
+    REPLY = "reply",
+    /** Tin Tư vấn miễn phí theo gói dịch vụ OA */
+    SUB_QUOTA = "sub_quota",
+    /** Tin trong hạn mức gói tính năng lẻ */
+    PURCHASE_QUOTA = "purchase_quota",
+    /** Tin trong hạn mức Redeem code */
+    REWARD_QUOTA = "reward_quota"
+}
+/**
+ * Enum các loại owner sở hữu Quota Package
+ */
+export declare enum QuotaOwnerType {
+    /** Thực thể sở hữu là OA */
+    OA = "OA",
+    /** Thực thể sở hữu là App */
+    APP = "App"
+}
+//# sourceMappingURL=miniapp-message.service.d.ts.map

package/dist/services/miniapp-message.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniapp-message.service.d.ts","sourceRoot":"","sources":["../../src/services/miniapp-message.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwD;gBAEpD,MAAM,EAAE,UAAU;IAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAChC,OAAO,CAAC,sBAAsB,CAAC;IAoElC;;;;;;;;;;;;OAYG;IACG,qBAAqB,CACzB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,GACD,OAAO,CAAC,sBAAsB,CAAC;CAmBnC;AAED;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,qDAAqD;IACrD,KAAK,UAAU;IACf,8CAA8C;IAC9C,SAAS,cAAc;IACvB,yCAAyC;IACzC,cAAc,mBAAmB;IACjC,oCAAoC;IACpC,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,4BAA4B;IAC5B,EAAE,OAAO;IACT,6BAA6B;IAC7B,GAAG,QAAQ;CACZ"}