react-native-custom-ota 1.0.2 → 1.0.3

package/lib/typescript/ProgressModal.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTAProgressModal = void 0;
+exports.formatBytes = formatBytes;
+const react_1 = __importDefault(require("react"));
+const react_native_1 = require("react-native");
+function formatBytes(bytes, decimals = 1) {
+    if (!bytes || bytes <= 0)
+        return "0 B";
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = ["B", "KB", "MB", "GB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+}
+const OTAProgressModal = ({ visible, progress, title = "Cập nhật ứng dụng", statusText = "Đang tải bản cập nhật...", version }) => {
+    // Chuẩn hóa dữ liệu tiến độ
+    let percent = 0;
+    let receivedBytes = 0;
+    let totalBytes = 0;
+    if (typeof progress === "number") {
+        percent = Math.min(100, Math.max(0, Math.round(progress * 100)));
+    }
+    else if (progress && typeof progress === "object") {
+        percent = Math.min(100, Math.max(0, Math.round(progress.percentage || 0)));
+        receivedBytes = progress.receivedBytes || 0;
+        totalBytes = progress.totalBytes || 0;
+    }
+    const bytesInfo = totalBytes > 0
+        ? `${formatBytes(receivedBytes)} / ${formatBytes(totalBytes)}`
+        : "";
+    return (react_1.default.createElement(react_native_1.Modal, { transparent: true, animationType: "fade", visible: visible, statusBarTranslucent: true },
+        react_1.default.createElement(react_native_1.View, { style: styles.overlay },
+            react_1.default.createElement(react_native_1.View, { style: styles.card },
+                react_1.default.createElement(react_native_1.View, { style: styles.header },
+                    react_1.default.createElement(react_native_1.View, { style: styles.iconContainer },
+                        react_1.default.createElement(react_native_1.Text, { style: styles.iconText }, "\u26A1")),
+                    react_1.default.createElement(react_native_1.View, { style: styles.headerTextContainer },
+                        react_1.default.createElement(react_native_1.Text, { style: styles.title }, title),
+                        version ? (react_1.default.createElement(react_native_1.Text, { style: styles.versionBadge },
+                            "Phi\u00EAn b\u1EA3n v",
+                            version)) : null)),
+                react_1.default.createElement(react_native_1.Text, { style: styles.statusText }, statusText),
+                react_1.default.createElement(react_native_1.View, { style: styles.progressBarTrack },
+                    react_1.default.createElement(react_native_1.View, { style: [styles.progressBarFill, { width: `${percent}%` }] })),
+                react_1.default.createElement(react_native_1.View, { style: styles.detailsRow },
+                    react_1.default.createElement(react_native_1.Text, { style: styles.percentageText },
+                        percent,
+                        "%"),
+                    bytesInfo ? (react_1.default.createElement(react_native_1.Text, { style: styles.bytesText }, bytesInfo)) : null),
+                react_1.default.createElement(react_native_1.View, { style: styles.footer },
+                    react_1.default.createElement(react_native_1.ActivityIndicator, { size: "small", color: "#38bdf8", style: { marginRight: 8 } }),
+                    react_1.default.createElement(react_native_1.Text, { style: styles.footerText }, "Vui l\u00F2ng kh\u00F4ng \u0111\u00F3ng \u1EE9ng d\u1EE5ng..."))))));
+};
+exports.OTAProgressModal = OTAProgressModal;
+const styles = react_native_1.StyleSheet.create({
+    overlay: {
+        flex: 1,
+        backgroundColor: "rgba(0, 0, 0, 0.72)",
+        justifyContent: "center",
+        alignItems: "center",
+        paddingHorizontal: 24
+    },
+    card: {
+        width: "100%",
+        maxWidth: 380,
+        backgroundColor: "#0f172a",
+        borderRadius: 20,
+        padding: 24,
+        borderWidth: 1,
+        borderColor: "rgba(255, 255, 255, 0.12)",
+        shadowColor: "#000",
+        shadowOffset: { width: 0, height: 12 },
+        shadowOpacity: 0.5,
+        shadowRadius: 20,
+        elevation: 16
+    },
+    header: {
+        flexDirection: "row",
+        alignItems: "center",
+        marginBottom: 16
+    },
+    iconContainer: {
+        width: 44,
+        height: 44,
+        borderRadius: 12,
+        backgroundColor: "rgba(56, 189, 248, 0.15)",
+        justifyContent: "center",
+        alignItems: "center",
+        marginRight: 14,
+        borderWidth: 1,
+        borderColor: "rgba(56, 189, 248, 0.3)"
+    },
+    iconText: {
+        fontSize: 22
+    },
+    headerTextContainer: {
+        flex: 1
+    },
+    title: {
+        fontSize: 18,
+        fontWeight: "700",
+        color: "#f8fafc",
+        letterSpacing: 0.2
+    },
+    versionBadge: {
+        fontSize: 12,
+        color: "#38bdf8",
+        fontWeight: "600",
+        marginTop: 2
+    },
+    statusText: {
+        fontSize: 14,
+        color: "#94a3b8",
+        marginBottom: 16,
+        lineHeight: 20
+    },
+    progressBarTrack: {
+        height: 10,
+        backgroundColor: "rgba(255, 255, 255, 0.08)",
+        borderRadius: 999,
+        overflow: "hidden",
+        marginBottom: 10
+    },
+    progressBarFill: {
+        height: "100%",
+        backgroundColor: "#38bdf8",
+        borderRadius: 999
+    },
+    detailsRow: {
+        flexDirection: "row",
+        justifyContent: "space-between",
+        alignItems: "center",
+        marginBottom: 20
+    },
+    percentageText: {
+        fontSize: 16,
+        fontWeight: "800",
+        color: "#38bdf8"
+    },
+    bytesText: {
+        fontSize: 13,
+        color: "#64748b",
+        fontWeight: "500"
+    },
+    footer: {
+        flexDirection: "row",
+        alignItems: "center",
+        justifyContent: "center",
+        paddingTop: 12,
+        borderTopWidth: 1,
+        borderTopColor: "rgba(255, 255, 255, 0.06)"
+    },
+    footerText: {
+        fontSize: 12,
+        color: "#64748b",
+        fontWeight: "500"
+    }
+});
+exports.default = exports.OTAProgressModal;

package/lib/typescript/hoc.d.ts

@@ -1,3 +1,4 @@
 import { ComponentType } from "react";
 import { SyncOptions } from "./types";
 export declare function withCustomOTA(options: SyncOptions): <P extends object>(WrappedComponent: ComponentType<P>) => ComponentType<P>;
+export default withCustomOTA;

package/lib/typescript/hoc.js

@@ -38,10 +38,39 @@ const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const manager_1 = require("./manager");
 const types_1 = require("./types");
+const ProgressModal_1 = require("./ProgressModal");
 function withCustomOTA(options) {
     return function (WrappedComponent) {
         return function CustomOTAWrapper(props) {
+            const [isDownloading, setIsDownloading] = (0, react_1.useState)(false);
+            const [progress, setProgress] = (0, react_1.useState)({
+                totalBytes: 0,
+                receivedBytes: 0,
+                percentage: 0,
+                progress: 0
+            });
+            const [statusText, setStatusText] = (0, react_1.useState)("Đang tải bản cập nhật...");
             (0, react_1.useEffect)(() => {
+                let removeProg;
+                let removeStatus;
+                if (options.showProgressModal) {
+                    removeProg = manager_1.CustomOTAManager.addProgressListener((p) => {
+                        setProgress(p);
+                        setIsDownloading(true);
+                    });
+                    removeStatus = manager_1.CustomOTAManager.addDetailedStatusListener((s, msg) => {
+                        if (msg)
+                            setStatusText(msg);
+                        if (s === types_1.DetailedStatus.DOWNLOADING ||
+                            s === types_1.DetailedStatus.VERIFYING ||
+                            s === types_1.DetailedStatus.INSTALLING) {
+                            setIsDownloading(true);
+                        }
+                        else if (s === types_1.DetailedStatus.COMPLETED || s === types_1.DetailedStatus.ERROR) {
+                            setIsDownloading(false);
+                        }
+                    });
+                }
                 // Tự động kiểm tra cập nhật khi app khởi động
                 if (options.checkFrequency !== types_1.CheckFrequency.MANUAL) {
                     manager_1.CustomOTAManager.sync(options);
@@ -55,10 +84,19 @@ function withCustomOTA(options) {
                     });
                     return () => {
                         subscription.remove();
+                        removeProg?.();
+                        removeStatus?.();
                     };
                 }
+                return () => {
+                    removeProg?.();
+                    removeStatus?.();
+                };
             }, []);
-            return react_1.default.createElement(WrappedComponent, { ...props });
+            return (react_1.default.createElement(react_native_1.View, { style: { flex: 1 } },
+                react_1.default.createElement(WrappedComponent, { ...props }),
+                options.showProgressModal && (react_1.default.createElement(ProgressModal_1.OTAProgressModal, { visible: isDownloading, progress: progress, statusText: statusText }))));
         };
     };
 }
+exports.default = withCustomOTA;

package/lib/typescript/index.d.ts

@@ -1,9 +1,12 @@
 import { CustomOTAManager } from "./manager";
 import { withCustomOTA } from "./hoc";
+import { useCustomOTA } from "./useCustomOTA";
 export * from "./types";
 export * from "./manager";
 export * from "./hoc";
 export * from "./storage";
+export * from "./ProgressModal";
+export * from "./useCustomOTA";
 declare const CustomOTA: {
     sync: typeof CustomOTAManager.sync;
     checkForUpdate: typeof CustomOTAManager.checkForUpdate;
@@ -11,6 +14,10 @@ declare const CustomOTA: {
     restartApp: typeof CustomOTAManager.restartApp;
     getUpdateMetadata: typeof CustomOTAManager.getUpdateMetadata;
     markReady: typeof CustomOTAManager.markReady;
+    addProgressListener: typeof CustomOTAManager.addProgressListener;
+    addDetailedStatusListener: typeof CustomOTAManager.addDetailedStatusListener;
     wrap: typeof withCustomOTA;
+    ProgressModal: import("@types/react").FC<import("./ProgressModal").OTAProgressModalProps>;
+    useCustomOTA: typeof useCustomOTA;
 };
 export default CustomOTA;

package/lib/typescript/index.js

@@ -16,10 +16,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const manager_1 = require("./manager");
 const hoc_1 = require("./hoc");
+const ProgressModal_1 = require("./ProgressModal");
+const useCustomOTA_1 = require("./useCustomOTA");
 __exportStar(require("./types"), exports);
 __exportStar(require("./manager"), exports);
 __exportStar(require("./hoc"), exports);
 __exportStar(require("./storage"), exports);
+__exportStar(require("./ProgressModal"), exports);
+__exportStar(require("./useCustomOTA"), exports);
 const CustomOTA = {
     sync: manager_1.CustomOTAManager.sync.bind(manager_1.CustomOTAManager),
     checkForUpdate: manager_1.CustomOTAManager.checkForUpdate.bind(manager_1.CustomOTAManager),
@@ -27,6 +31,10 @@ const CustomOTA = {
     restartApp: manager_1.CustomOTAManager.restartApp.bind(manager_1.CustomOTAManager),
     getUpdateMetadata: manager_1.CustomOTAManager.getUpdateMetadata.bind(manager_1.CustomOTAManager),
     markReady: manager_1.CustomOTAManager.markReady.bind(manager_1.CustomOTAManager),
-    wrap: hoc_1.withCustomOTA
+    addProgressListener: manager_1.CustomOTAManager.addProgressListener.bind(manager_1.CustomOTAManager),
+    addDetailedStatusListener: manager_1.CustomOTAManager.addDetailedStatusListener.bind(manager_1.CustomOTAManager),
+    wrap: hoc_1.withCustomOTA,
+    ProgressModal: ProgressModal_1.OTAProgressModal,
+    useCustomOTA: useCustomOTA_1.useCustomOTA
 };
 exports.default = CustomOTA;

package/lib/typescript/manager.d.ts

@@ -1,6 +1,20 @@
-import { InstallMode, LocalPackage, RemotePackage, SyncOptions, SyncStatus } from "./types";
+import { DownloadProgress, InstallMode, LocalPackage, RemotePackage, SyncOptions, SyncStatus, DetailedStatus } from "./types";
 export declare class CustomOTAManager {
     private static defaultDialog;
+    private static progressListeners;
+    private static detailedStatusListeners;
+    /**
+     * Đăng ký lắng nghe tiến độ tải về toàn cục
+     * @returns Hàm hủy đăng ký (unsubscribe)
+     */
+    static addProgressListener(listener: (progress: DownloadProgress) => void): () => void;
+    /**
+     * Đăng ký lắng nghe trạng thái chi tiết của quá trình OTA
+     * @returns Hàm hủy đăng ký (unsubscribe)
+     */
+    static addDetailedStatusListener(listener: (status: DetailedStatus, message?: string) => void): () => void;
+    private static emitProgress;
+    private static emitDetailedStatus;
     /**
      * Đánh dấu bản build OTA hiện tại đã khởi động thành công.
      * Xóa bản backup trước đó và tắt cờ pending.
@@ -15,7 +29,7 @@ export declare class CustomOTAManager {
      */
     static getUpdateMetadata(): Promise<LocalPackage>;
     /**
-     * Kiểm tra xem server có bản cập nhật mới hay không.
+     * Kiểm tra xem có bản cập nhật mới từ OTA Server hay không.
      */
     static checkForUpdate(options: {
         serverUrl: string;
@@ -25,11 +39,11 @@ export declare class CustomOTAManager {
         channel?: string;
     }): Promise<RemotePackage | null>;
     /**
-     * Tải và cài đặt bản cập nhật.
+     * Tải và cài đặt bản cập nhật với theo dõi tiến độ chi tiết.
      */
-    static downloadAndInstall(update: RemotePackage, onProgress?: (progress: number) => void, installMode?: InstallMode): Promise<boolean>;
+    static downloadAndInstall(update: RemotePackage, onProgress?: ((progress: DownloadProgress) => void) | ((progressValue: number) => void), installMode?: InstallMode): Promise<boolean>;
     /**
      * Phương thức đồng bộ tự động như CodePush.sync()
      */
-    static sync(options: SyncOptions, syncStatusCallback?: (status: SyncStatus) => void, downloadProgressCallback?: (progress: number) => void): Promise<SyncStatus>;
+    static sync(options: SyncOptions, syncStatusCallback?: (status: SyncStatus) => void, downloadProgressCallback?: ((progress: DownloadProgress) => void) | ((progressValue: number) => void)): Promise<SyncStatus>;
 }

package/lib/typescript/manager.js

@@ -10,6 +10,46 @@ const native_1 = require("./native");
 const storage_1 = require("./storage");
 const types_1 = require("./types");
 class CustomOTAManager {
+    /**
+     * Đăng ký lắng nghe tiến độ tải về toàn cục
+     * @returns Hàm hủy đăng ký (unsubscribe)
+     */
+    static addProgressListener(listener) {
+        this.progressListeners.add(listener);
+        return () => {
+            this.progressListeners.delete(listener);
+        };
+    }
+    /**
+     * Đăng ký lắng nghe trạng thái chi tiết của quá trình OTA
+     * @returns Hàm hủy đăng ký (unsubscribe)
+     */
+    static addDetailedStatusListener(listener) {
+        this.detailedStatusListeners.add(listener);
+        return () => {
+            this.detailedStatusListeners.delete(listener);
+        };
+    }
+    static emitProgress(progress) {
+        for (const listener of this.progressListeners) {
+            try {
+                listener(progress);
+            }
+            catch (e) {
+                console.warn("[CustomOTA] Error in progress listener:", e);
+            }
+        }
+    }
+    static emitDetailedStatus(status, message) {
+        for (const listener of this.detailedStatusListeners) {
+            try {
+                listener(status, message);
+            }
+            catch (e) {
+                console.warn("[CustomOTA] Error in detailed status listener:", e);
+            }
+        }
+    }
     /**
      * Đánh dấu bản build OTA hiện tại đã khởi động thành công.
      * Xóa bản backup trước đó và tắt cờ pending.
@@ -49,7 +89,7 @@ class CustomOTAManager {
         return (0, storage_1.readState)();
     }
     /**
-     * Kiểm tra xem server có bản cập nhật mới hay không.
+     * Kiểm tra xem có bản cập nhật mới từ OTA Server hay không.
      */
     static async checkForUpdate(options) {
         await (0, storage_1.ensureOTADirs)();
@@ -109,7 +149,7 @@ class CustomOTAManager {
         return data;
     }
     /**
-     * Tải và cài đặt bản cập nhật.
+     * Tải và cài đặt bản cập nhật với theo dõi tiến độ chi tiết.
      */
     static async downloadAndInstall(update, onProgress, installMode) {
         const version = update.otaVersion || update.version;
@@ -121,30 +161,51 @@ class CustomOTAManager {
             ].filter(Boolean).join(", ");
             throw new Error(`Invalid update package metadata: missing ${missingFields}`);
         }
+        this.emitDetailedStatus(types_1.DetailedStatus.DOWNLOADING, `Bắt đầu tải bản cập nhật v${version}...`);
         const zipPath = `${storage_1.TEMP_DIR}/update-${version}.zip`;
         await react_native_fs_1.default.unlink(zipPath).catch(() => { });
-        // Download zip file
+        // Download zip file với theo dõi byte chính xác
         const downloadRes = react_native_fs_1.default.downloadFile({
             fromUrl: update.downloadUrl.startsWith("http") ? update.downloadUrl : `${update.downloadUrl}`,
             toFile: zipPath,
             progressDivider: 1,
             progress: ({ bytesWritten, contentLength }) => {
-                if (contentLength > 0 && onProgress) {
-                    onProgress(bytesWritten / contentLength);
+                const total = contentLength > 0 ? contentLength : (update.size || 0);
+                const percent = total > 0 ? Math.min(100, Math.round((bytesWritten / total) * 100)) : 0;
+                const progressVal = total > 0 ? Math.min(1, bytesWritten / total) : 0;
+                const progressObj = {
+                    totalBytes: total,
+                    receivedBytes: bytesWritten,
+                    percentage: percent,
+                    progress: progressVal
+                };
+                if (onProgress) {
+                    // Callback nhận cả object lẫn hỗ trợ kiểu cũ nhận số
+                    try {
+                        onProgress(progressObj, progressVal);
+                    }
+                    catch {
+                        onProgress(progressVal);
+                    }
                 }
+                this.emitProgress(progressObj);
             }
         });
         const res = await downloadRes.promise;
         if (res.statusCode < 200 || res.statusCode >= 300) {
+            this.emitDetailedStatus(types_1.DetailedStatus.ERROR, `Tải thất bại với mã lỗi HTTP ${res.statusCode}`);
             throw new Error(`Download failed with status ${res.statusCode}`);
         }
         // SHA-256 verification
+        this.emitDetailedStatus(types_1.DetailedStatus.VERIFYING, "Đang kiểm tra tính toàn vẹn (SHA-256)...");
         const actualHash = await react_native_fs_1.default.hash(zipPath, "sha256");
         if (actualHash.toLowerCase() !== update.sha256.toLowerCase()) {
             await react_native_fs_1.default.unlink(zipPath).catch(() => { });
+            this.emitDetailedStatus(types_1.DetailedStatus.ERROR, "Mã băm SHA-256 không trùng khớp!");
             throw new Error(`SHA-256 Checksum mismatch! Expected ${update.sha256}, got ${actualHash}`);
         }
         // Unpack temp directory
+        this.emitDetailedStatus(types_1.DetailedStatus.INSTALLING, "Đang giải nén và nạp gói cập nhật...");
         const tempDir = `${storage_1.TEMP_DIR}/${version}`;
         await react_native_fs_1.default.unlink(tempDir).catch(() => { });
         await react_native_fs_1.default.mkdir(tempDir);
@@ -171,6 +232,7 @@ class CustomOTAManager {
             failedVersions: oldState.failedVersions || []
         });
         await react_native_fs_1.default.unlink(zipPath).catch(() => { });
+        this.emitDetailedStatus(types_1.DetailedStatus.COMPLETED, `Đã cài đặt bản cập nhật v${version} thành công!`);
         if (installMode === types_1.InstallMode.IMMEDIATE) {
             await this.restartApp();
         }
@@ -258,5 +320,8 @@ CustomOTAManager.defaultDialog = {
     optionalUpdateMessage: "Đã có bản cập nhật ứng dụng mới. Bạn có muốn cài đặt ngay bây giờ?",
     mandatoryUpdateMessage: "Đã có bản cập nhật bắt buộc. Vui lòng cài đặt để tiếp tục sử dụng.",
     optionalInstallButtonLabel: "Cập nhật",
-    optionalIgnoreButtonLabel: "Để sau"
+    optionalIgnoreButtonLabel: "Để sau",
+    showProgressModal: true
 };
+CustomOTAManager.progressListeners = new Set();
+CustomOTAManager.detailedStatusListeners = new Set();

package/lib/typescript/types.d.ts

@@ -6,6 +6,16 @@ export declare enum SyncStatus {
     UPDATE_INSTALLED = 4,
     ERROR = -1
 }
+export declare enum DetailedStatus {
+    IDLE = "IDLE",
+    CHECKING = "CHECKING",
+    UPDATE_AVAILABLE = "UPDATE_AVAILABLE",
+    DOWNLOADING = "DOWNLOADING",
+    VERIFYING = "VERIFYING",
+    INSTALLING = "INSTALLING",
+    COMPLETED = "COMPLETED",
+    ERROR = "ERROR"
+}
 export declare enum CheckFrequency {
     ON_APP_START = "ON_APP_START",
     ON_APP_RESUME = "ON_APP_RESUME",
@@ -15,12 +25,29 @@ export declare enum InstallMode {
     IMMEDIATE = "IMMEDIATE",
     ON_NEXT_RESTART = "ON_NEXT_RESTART"
 }
+/**
+ * Thông tin tiến độ tải về bản cập nhật
+ */
+export interface DownloadProgress {
+    /** Tổng số byte cần tải */
+    totalBytes: number;
+    /** Số byte đã tải về máy */
+    receivedBytes: number;
+    /** Tỷ lệ hoàn thành từ 0 đến 100 (%) */
+    percentage: number;
+    /** Giá trị tỷ lệ từ 0.0 đến 1.0 (tương thích CodePush / Progress Bar) */
+    progress: number;
+}
+export type DownloadProgressCallback = (progress: DownloadProgress) => void;
+export type DetailedStatusCallback = (status: DetailedStatus, message?: string) => void;
 export interface UpdateDialogOptions {
     title?: string;
     optionalUpdateMessage?: string;
     mandatoryUpdateMessage?: string;
     optionalInstallButtonLabel?: string;
     optionalIgnoreButtonLabel?: string;
+    /** Hiển thị modal tiến độ tải sau khi người dùng bấm cập nhật */
+    showProgressModal?: boolean;
 }
 export interface SyncOptions {
     serverUrl: string;
@@ -31,6 +58,8 @@ export interface SyncOptions {
     installMode?: InstallMode;
     mandatoryInstallMode?: InstallMode;
     updateDialog?: boolean | UpdateDialogOptions;
+    /** Tự động hiển thị modal tiến độ tải cập nhật */
+    showProgressModal?: boolean;
     checkFrequency?: CheckFrequency;
 }
 export interface RemotePackage {

package/lib/typescript/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InstallMode = exports.CheckFrequency = exports.SyncStatus = void 0;
+exports.InstallMode = exports.CheckFrequency = exports.DetailedStatus = exports.SyncStatus = void 0;
 var SyncStatus;
 (function (SyncStatus) {
     SyncStatus[SyncStatus["UP_TO_DATE"] = 0] = "UP_TO_DATE";
@@ -10,6 +10,17 @@ var SyncStatus;
     SyncStatus[SyncStatus["UPDATE_INSTALLED"] = 4] = "UPDATE_INSTALLED";
     SyncStatus[SyncStatus["ERROR"] = -1] = "ERROR";
 })(SyncStatus || (exports.SyncStatus = SyncStatus = {}));
+var DetailedStatus;
+(function (DetailedStatus) {
+    DetailedStatus["IDLE"] = "IDLE";
+    DetailedStatus["CHECKING"] = "CHECKING";
+    DetailedStatus["UPDATE_AVAILABLE"] = "UPDATE_AVAILABLE";
+    DetailedStatus["DOWNLOADING"] = "DOWNLOADING";
+    DetailedStatus["VERIFYING"] = "VERIFYING";
+    DetailedStatus["INSTALLING"] = "INSTALLING";
+    DetailedStatus["COMPLETED"] = "COMPLETED";
+    DetailedStatus["ERROR"] = "ERROR";
+})(DetailedStatus || (exports.DetailedStatus = DetailedStatus = {}));
 var CheckFrequency;
 (function (CheckFrequency) {
     CheckFrequency["ON_APP_START"] = "ON_APP_START";

package/lib/typescript/useCustomOTA.d.ts

@@ -0,0 +1,35 @@
+import { DownloadProgress, LocalPackage, RemotePackage, SyncOptions, SyncStatus, DetailedStatus } from "./types";
+export interface UseCustomOTAReturn {
+    /** Đang kiểm tra cập nhật */
+    isChecking: boolean;
+    /** Đang trong tiến trình tải xuống hoặc cài đặt */
+    isDownloading: boolean;
+    /** Thông tin tiến độ tải chi tiết */
+    progress: DownloadProgress;
+    /** Trạng thái tổng quát của Sync */
+    syncStatus: SyncStatus;
+    /** Trạng thái chi tiết (IDLE, CHECKING, DOWNLOADING, VERIFYING, INSTALLING, COMPLETED, ERROR) */
+    detailedStatus: DetailedStatus;
+    /** Thông điệp trạng thái bằng chữ (tiếng Việt thân thiện) */
+    statusText: string;
+    /** Thông tin phiên bản OTA hiện tại của máy */
+    activeMetadata: LocalPackage | null;
+    /** Phiên bản active hiện tại (vd: '1.0.8') */
+    activeVersion: string;
+    /** Kiểm tra bản cập nhật mới từ server */
+    checkForUpdate: (options: {
+        serverUrl: string;
+        appId?: string;
+        apiKey?: string;
+        nativeVersion?: string;
+        channel?: string;
+    }) => Promise<RemotePackage | null>;
+    /** Thực hiện đồng bộ tự động */
+    sync: (options: SyncOptions) => Promise<SyncStatus>;
+    /** Khởi động lại ứng dụng để áp dụng bản OTA */
+    restartApp: () => Promise<void>;
+    /** Làm mới thông tin metadata phiên bản hiện tại */
+    refreshMetadata: () => Promise<LocalPackage>;
+}
+export declare function useCustomOTA(): UseCustomOTAReturn;
+export default useCustomOTA;