@warriorteam/redai-zalo-sdk 1.1.0

package/dist/services/video-upload.service.d.ts

@@ -0,0 +1,83 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { VideoUploadResponse, VideoStatusResponse } from "../types/article";
+/**
+ * Service for handling Zalo Official Account Video Upload APIs
+ *
+ * CONDITIONS FOR USING ZALO VIDEO UPLOAD:
+ *
+ * 1. GENERAL CONDITIONS:
+ *    - OA must have permission to upload videos
+ *    - Access token must have "manage_article" scope
+ *    - OA must have active status and be verified
+ *
+ * 2. VIDEO FILE REQUIREMENTS:
+ *    - File formats: MP4, AVI only
+ *    - Maximum file size: 50MB
+ *    - Video processing: asynchronous, use token to check status
+ *    - Processing time: varies based on video size and quality
+ *
+ * 3. UPLOAD PROCESS:
+ *    - Step 1: Upload video file and get token
+ *    - Step 2: Use token to check processing status
+ *    - Step 3: Get video_id when processing is complete
+ *    - Step 4: Use video_id in article creation
+ *
+ * 4. STATUS CODES:
+ *    - 1: Upload successful, processing started
+ *    - 2: Processing in progress
+ *    - 3: Processing completed successfully
+ *    - 4: Processing failed
+ */
+export declare class VideoUploadService {
+    private readonly client;
+    private readonly apiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Upload video file for article
+     * @param accessToken OA access token
+     * @param file Video file (Buffer or File)
+     * @param filename Original filename (optional, will be generated if not provided)
+     * @returns Token for tracking upload progress
+     */
+    uploadVideo(accessToken: string, file: Buffer | File, filename?: string): Promise<VideoUploadResponse>;
+    /**
+     * Check video upload status
+     * @param accessToken OA access token
+     * @param token Token from video upload response
+     * @returns Video status information
+     */
+    checkVideoStatus(accessToken: string, token: string): Promise<VideoStatusResponse>;
+    /**
+     * Wait for video upload completion with polling
+     * @param accessToken OA access token
+     * @param token Token from video upload response
+     * @param maxWaitTime Maximum wait time in milliseconds (default: 5 minutes)
+     * @param pollInterval Polling interval in milliseconds (default: 5 seconds)
+     * @returns Final video status when completed
+     */
+    waitForUploadCompletion(accessToken: string, token: string, maxWaitTime?: number, // 5 minutes
+    pollInterval?: number): Promise<VideoStatusResponse>;
+    /**
+     * Upload video from URL
+     * @param accessToken OA access token
+     * @param videoUrl URL of the video to upload
+     * @returns Token for tracking upload progress
+     */
+    uploadVideoFromUrl(accessToken: string, videoUrl: string): Promise<VideoUploadResponse>;
+    /**
+     * Get video information by video ID
+     * @param accessToken OA access token
+     * @param videoId Video ID
+     * @returns Video information
+     */
+    getVideoInfo(accessToken: string, videoId: string): Promise<any>;
+    /**
+     * Validate video file
+     */
+    private validateVideoFile;
+    private getMimeTypeFromFilename;
+    private extractFilenameFromUrl;
+    private sleep;
+    private handleVideoUploadError;
+}
+//# sourceMappingURL=video-upload.service.d.ts.map

package/dist/services/video-upload.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-upload.service.d.ts","sourceRoot":"","sources":["../../src/services/video-upload.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAE5B,MAAM,EAAE,UAAU;IAE/C;;;;;;OAMG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;;;;OAKG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;;;;;;OAOG;IACG,uBAAuB,CAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,MAAsB,EAAE,YAAY;IACjD,YAAY,GAAE,MAAiB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IA8C/B;;;;;OAKG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC;IAmC/B;;;;;OAKG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAsBtE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyDzB,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,sBAAsB;CAoB/B"}

package/dist/services/video-upload.service.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VideoUploadService = void 0;
+const article_1 = require("../types/article");
+const common_1 = require("../types/common");
+/**
+ * Service for handling Zalo Official Account Video Upload APIs
+ *
+ * CONDITIONS FOR USING ZALO VIDEO UPLOAD:
+ *
+ * 1. GENERAL CONDITIONS:
+ *    - OA must have permission to upload videos
+ *    - Access token must have "manage_article" scope
+ *    - OA must have active status and be verified
+ *
+ * 2. VIDEO FILE REQUIREMENTS:
+ *    - File formats: MP4, AVI only
+ *    - Maximum file size: 50MB
+ *    - Video processing: asynchronous, use token to check status
+ *    - Processing time: varies based on video size and quality
+ *
+ * 3. UPLOAD PROCESS:
+ *    - Step 1: Upload video file and get token
+ *    - Step 2: Use token to check processing status
+ *    - Step 3: Get video_id when processing is complete
+ *    - Step 4: Use video_id in article creation
+ *
+ * 4. STATUS CODES:
+ *    - 1: Upload successful, processing started
+ *    - 2: Processing in progress
+ *    - 3: Processing completed successfully
+ *    - 4: Processing failed
+ */
+class VideoUploadService {
+    constructor(client) {
+        this.client = client;
+        this.apiUrl = "https://openapi.zalo.me/v2.0";
+    }
+    /**
+     * Upload video file for article
+     * @param accessToken OA access token
+     * @param file Video file (Buffer or File)
+     * @param filename Original filename (optional, will be generated if not provided)
+     * @returns Token for tracking upload progress
+     */
+    async uploadVideo(accessToken, file, filename) {
+        try {
+            // Validate file
+            this.validateVideoFile(file, filename);
+            // Create FormData for upload
+            const formData = new FormData();
+            if (Buffer.isBuffer(file)) {
+                // Handle Buffer input - create a new ArrayBuffer to ensure compatibility
+                const actualFilename = filename || "video.mp4";
+                const arrayBuffer = new ArrayBuffer(file.length);
+                const uint8Array = new Uint8Array(arrayBuffer);
+                file.copy(uint8Array);
+                const blob = new Blob([uint8Array], {
+                    type: this.getMimeTypeFromFilename(actualFilename),
+                });
+                formData.append("file", blob, actualFilename);
+            }
+            else {
+                // Handle File input
+                const actualFilename = file.name || filename || "video.mp4";
+                formData.append("file", file, actualFilename);
+            }
+            const response = await this.client.apiPostFormData(`${this.apiUrl}/article/upload_video/preparevideo`, accessToken, formData);
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleVideoUploadError(error, "Failed to upload video");
+        }
+    }
+    /**
+     * Check video upload status
+     * @param accessToken OA access token
+     * @param token Token from video upload response
+     * @returns Video status information
+     */
+    async checkVideoStatus(accessToken, token) {
+        try {
+            if (!token || token.trim() === "") {
+                throw new common_1.ZaloSDKError("Token cannot be empty", -1);
+            }
+            const params = new URLSearchParams();
+            params.append("token", token);
+            const response = await this.client.apiGet(`${this.apiUrl}/article/upload_video/verify?${params.toString()}`, accessToken);
+            return response.data;
+        }
+        catch (error) {
+            throw this.handleVideoUploadError(error, "Failed to check video status");
+        }
+    }
+    /**
+     * Wait for video upload completion with polling
+     * @param accessToken OA access token
+     * @param token Token from video upload response
+     * @param maxWaitTime Maximum wait time in milliseconds (default: 5 minutes)
+     * @param pollInterval Polling interval in milliseconds (default: 5 seconds)
+     * @returns Final video status when completed
+     */
+    async waitForUploadCompletion(accessToken, token, maxWaitTime = 5 * 60 * 1000, // 5 minutes
+    pollInterval = 5 * 1000 // 5 seconds
+    ) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < maxWaitTime) {
+            try {
+                const status = await this.checkVideoStatus(accessToken, token);
+                // Status 3 = Processing completed successfully
+                if (status.status === 3 && status.video_id) {
+                    return status;
+                }
+                // Status 4 = Processing failed
+                if (status.status === 4) {
+                    throw new common_1.ZaloSDKError(`Video processing failed: ${status.status_message}`, status.convert_error_code);
+                }
+                // Continue polling for status 1 (uploaded) or 2 (processing)
+                if (status.status === 1 || status.status === 2) {
+                    await this.sleep(pollInterval);
+                    continue;
+                }
+                // Unknown status
+                throw new common_1.ZaloSDKError(`Unknown video processing status: ${status.status}`, -1);
+            }
+            catch (error) {
+                if (error instanceof common_1.ZaloSDKError) {
+                    throw error;
+                }
+                // Continue polling on network errors
+                await this.sleep(pollInterval);
+            }
+        }
+        throw new common_1.ZaloSDKError(`Video processing timeout after ${maxWaitTime / 1000} seconds`, -1);
+    }
+    /**
+     * Upload video from URL
+     * @param accessToken OA access token
+     * @param videoUrl URL of the video to upload
+     * @returns Token for tracking upload progress
+     */
+    async uploadVideoFromUrl(accessToken, videoUrl) {
+        try {
+            if (!videoUrl || videoUrl.trim() === "") {
+                throw new common_1.ZaloSDKError("Video URL cannot be empty", -1);
+            }
+            // Validate URL format
+            try {
+                new URL(videoUrl);
+            }
+            catch {
+                throw new common_1.ZaloSDKError("Invalid video URL format", -1);
+            }
+            // Download video from URL
+            const response = await fetch(videoUrl);
+            if (!response.ok) {
+                throw new common_1.ZaloSDKError(`Failed to download video from URL: ${response.statusText}`, -1);
+            }
+            const videoBuffer = Buffer.from(await response.arrayBuffer());
+            const filename = this.extractFilenameFromUrl(videoUrl) || "video.mp4";
+            // Upload the downloaded video
+            return await this.uploadVideo(accessToken, videoBuffer, filename);
+        }
+        catch (error) {
+            throw this.handleVideoUploadError(error, "Failed to upload video from URL");
+        }
+    }
+    /**
+     * Get video information by video ID
+     * @param accessToken OA access token
+     * @param videoId Video ID
+     * @returns Video information
+     */
+    async getVideoInfo(accessToken, videoId) {
+        try {
+            if (!videoId || videoId.trim() === "") {
+                throw new common_1.ZaloSDKError("Video ID cannot be empty", -1);
+            }
+            const params = new URLSearchParams();
+            params.append("video_id", videoId);
+            const response = await this.client.apiGet(`${this.apiUrl}/article/video/info?${params.toString()}`, accessToken);
+            return response;
+        }
+        catch (error) {
+            throw this.handleVideoUploadError(error, "Failed to get video info");
+        }
+    }
+    // ==================== VALIDATION METHODS ====================
+    /**
+     * Validate video file
+     */
+    validateVideoFile(file, filename) {
+        if (!file) {
+            throw new common_1.ZaloSDKError("Video file cannot be empty", -1);
+        }
+        let fileSize;
+        let fileName;
+        let mimeType;
+        if (Buffer.isBuffer(file)) {
+            fileSize = file.length;
+            fileName = filename || "video.mp4";
+            mimeType = this.getMimeTypeFromFilename(fileName);
+        }
+        else {
+            // Handle File input with proper type casting
+            const fileObj = file;
+            fileSize = fileObj.size;
+            fileName = fileObj.name || filename || "video.mp4";
+            mimeType = fileObj.type || this.getMimeTypeFromFilename(fileName);
+        }
+        // Check file size (50MB)
+        if (fileSize > article_1.VIDEO_CONSTRAINTS.maxSize) {
+            throw new common_1.ZaloSDKError(`Video file size exceeds ${article_1.VIDEO_CONSTRAINTS.maxSize / (1024 * 1024)}MB limit`, -1);
+        }
+        // Check file extension
+        const fileExtension = fileName
+            .toLowerCase()
+            .substring(fileName.lastIndexOf("."));
+        if (!article_1.VIDEO_CONSTRAINTS.allowedExtensions.includes(fileExtension)) {
+            throw new common_1.ZaloSDKError(`Unsupported video format. Only ${article_1.VIDEO_CONSTRAINTS.allowedExtensions.join(", ")} are supported`, -1);
+        }
+        // Check MIME type
+        if (!article_1.VIDEO_CONSTRAINTS.allowedMimeTypes.includes(mimeType)) {
+            throw new common_1.ZaloSDKError(`Unsupported video MIME type. Only ${article_1.VIDEO_CONSTRAINTS.allowedMimeTypes.join(", ")} are supported`, -1);
+        }
+    }
+    // ==================== HELPER METHODS ====================
+    getMimeTypeFromFilename(filename) {
+        const extension = filename
+            .toLowerCase()
+            .substring(filename.lastIndexOf("."));
+        switch (extension) {
+            case ".mp4":
+                return "video/mp4";
+            case ".avi":
+                return "video/x-msvideo";
+            default:
+                return "video/mp4"; // Default fallback
+        }
+    }
+    extractFilenameFromUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            const pathname = urlObj.pathname;
+            const filename = pathname.substring(pathname.lastIndexOf("/") + 1);
+            return filename || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    handleVideoUploadError(error, defaultMessage) {
+        if (error instanceof common_1.ZaloSDKError) {
+            return error;
+        }
+        if (error.response?.data) {
+            const errorData = error.response.data;
+            return new common_1.ZaloSDKError(`${defaultMessage}: ${errorData.message || errorData.error || "Unknown error"}`, errorData.error || -1, errorData);
+        }
+        return new common_1.ZaloSDKError(`${defaultMessage}: ${error.message || "Unknown error"}`, -1, error);
+    }
+}
+exports.VideoUploadService = VideoUploadService;
+//# sourceMappingURL=video-upload.service.js.map

package/dist/services/video-upload.service.js.map

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

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

@@ -0,0 +1,116 @@
+import { ZaloClient } from "../clients/zalo-client";
+import { ZNSMessage, ZNSSendResult, ZNSTemplate, ZNSTemplateList, ZNSCreateTemplateRequest, ZNSUpdateTemplateRequest, ZNSUploadImageResult, ZNSHashPhoneMessage, ZNSDevModeMessage, ZNSRsaMessage, ZNSJourneyMessage, ZNSMessageStatusInfo, ZNSQuotaInfo } from "../types/zns";
+/**
+ * Service for Zalo Notification Service (ZNS)
+ *
+ * Requirements for using ZNS API:
+ * - Official Account must be approved and have ZNS sending permission
+ * - Valid Official Account access token
+ * - ZNS template must be approved before use
+ * - Recipient phone number must be in correct format and valid
+ * - Template data must match defined parameters
+ * - Comply with message quantity limits according to service package
+ *
+ * Reference: https://developers.zalo.me/docs/zalo-notification-service/
+ */
+export declare class ZNSService {
+    private readonly client;
+    private readonly znsApiUrl;
+    private readonly templateApiUrl;
+    constructor(client: ZaloClient);
+    /**
+     * Send ZNS message
+     * @param accessToken OA access token
+     * @param message ZNS message data
+     * @returns Send result
+     */
+    sendMessage(accessToken: string, message: ZNSMessage): Promise<ZNSSendResult>;
+    /**
+     * Send ZNS message with phone hash
+     * @param accessToken OA access token
+     * @param message ZNS message with hashed phone
+     * @returns Send result
+     */
+    sendHashPhoneMessage(accessToken: string, message: ZNSHashPhoneMessage): Promise<ZNSSendResult>;
+    /**
+     * Send ZNS message in development mode
+     * @param accessToken OA access token
+     * @param message ZNS dev mode message
+     * @returns Send result
+     */
+    sendDevModeMessage(accessToken: string, message: ZNSDevModeMessage): Promise<ZNSSendResult>;
+    /**
+     * Send ZNS message with RSA encryption
+     * @param accessToken OA access token
+     * @param message ZNS RSA message
+     * @returns Send result
+     */
+    sendRsaMessage(accessToken: string, message: ZNSRsaMessage): Promise<ZNSSendResult>;
+    /**
+     * Send ZNS journey message
+     * @param accessToken OA access token
+     * @param message ZNS journey message
+     * @returns Send result
+     */
+    sendJourneyMessage(accessToken: string, message: ZNSJourneyMessage): Promise<ZNSSendResult>;
+    /**
+     * Get ZNS message status
+     * @param accessToken OA access token
+     * @param messageId Message ID
+     * @returns Message status info
+     */
+    getMessageStatus(accessToken: string, messageId: string): Promise<ZNSMessageStatusInfo>;
+    /**
+     * Get ZNS quota information
+     * @param accessToken OA access token
+     * @returns Quota information
+     */
+    getQuotaInfo(accessToken: string): Promise<ZNSQuotaInfo>;
+    /**
+     * Get ZNS template list
+     * @param accessToken OA access token
+     * @param offset Offset for pagination
+     * @param limit Limit for pagination
+     * @returns Template list
+     */
+    getTemplateList(accessToken: string, offset?: number, limit?: number): Promise<ZNSTemplateList>;
+    /**
+     * Get ZNS template details
+     * @param accessToken OA access token
+     * @param templateId Template ID
+     * @returns Template details
+     */
+    getTemplateDetails(accessToken: string, templateId: string): Promise<ZNSTemplate>;
+    /**
+     * Create ZNS template
+     * @param accessToken OA access token
+     * @param templateData Template creation data
+     * @returns Created template
+     */
+    createTemplate(accessToken: string, templateData: ZNSCreateTemplateRequest): Promise<ZNSTemplate>;
+    /**
+     * Update ZNS template
+     * @param accessToken OA access token
+     * @param templateData Template update data
+     * @returns Updated template
+     */
+    updateTemplate(accessToken: string, templateData: ZNSUpdateTemplateRequest): Promise<ZNSTemplate>;
+    /**
+     * Delete ZNS template
+     * @param accessToken OA access token
+     * @param templateId Template ID
+     * @returns Deletion result
+     */
+    deleteTemplate(accessToken: string, templateId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Upload image for ZNS template
+     * @param accessToken OA access token
+     * @param imageFile Image file
+     * @returns Upload result
+     */
+    uploadImage(accessToken: string, imageFile: Buffer | NodeJS.ReadableStream, filename?: string): Promise<ZNSUploadImageResult>;
+    private handleZNSError;
+}
+//# sourceMappingURL=zns.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zns.service.d.ts","sourceRoot":"","sources":["../../src/services/zns.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACb,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IACxE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;gBAEjD,MAAM,EAAE,UAAU;IAE/C;;;;;OAKG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,aAAa,CAAC;IAczB;;;;;OAKG;IACG,oBAAoB,CACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAczB;;;;;OAKG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC;IAczB;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC;IAczB;;;;;OAKG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC;IAczB;;;;;OAKG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC;IAgBhC;;;;OAIG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa9D;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,MAAU,EAClB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,eAAe,CAAC;IAiB3B;;;;;OAKG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC;IAgBvB;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAAC,WAAW,CAAC;IAcvB;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAAC,WAAW,CAAC;IAcvB;;;;;OAKG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAchC;;;;;OAKG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EACzC,QAAQ,GAAE,MAAoB,GAC7B,OAAO,CAAC,oBAAoB,CAAC;IAehC,OAAO,CAAC,cAAc;CAWvB"}