react-native-custom-ota 0.0.0-stage → 1.0.0

package/lib/commonjs/manager.js

@@ -0,0 +1,262 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomOTAManager = void 0;
+const react_native_1 = require("react-native");
+const react_native_fs_1 = __importDefault(require("react-native-fs"));
+const native_1 = require("./native");
+const storage_1 = require("./storage");
+const types_1 = require("./types");
+class CustomOTAManager {
+    /**
+     * Đá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.
+     */
+    static async markReady() {
+        try {
+            const state = await (0, storage_1.readState)();
+            state.pending = false;
+            state.ready = true;
+            state.trial = false;
+            await (0, storage_1.writeState)(state);
+        }
+        catch (e) {
+            console.warn("[CustomOTA] Error updating state in markReady:", e);
+        }
+        if (native_1.OTAUpdater?.markReady) {
+            try {
+                await native_1.OTAUpdater.markReady();
+            }
+            catch (e) {
+                console.warn("[CustomOTA] Error calling native markReady:", e);
+            }
+        }
+    }
+    /**
+     * Khởi động lại ứng dụng để nạp ngay bản OTA mới.
+     */
+    static async restartApp() {
+        if (native_1.OTAUpdater?.restart) {
+            await native_1.OTAUpdater.restart();
+        }
+    }
+    /**
+     * Lấy thông tin phiên bản OTA hiện hành trên máy.
+     */
+    static async getUpdateMetadata() {
+        return (0, storage_1.readState)();
+    }
+    /**
+     * Kiểm tra xem server có bản cập nhật mới hay không.
+     */
+    static async checkForUpdate(options) {
+        await (0, storage_1.ensureOTADirs)();
+        const state = await (0, storage_1.readState)();
+        const platform = react_native_1.Platform.OS === "ios" ? "ios" : "android";
+        const nativeVersion = options.nativeVersion || "1.0.0";
+        const channel = options.channel || "production";
+        const params = new URLSearchParams({
+            platform,
+            nativeVersion,
+            otaVersion: state.currentVersion,
+            channel
+        });
+        if (options.appId) {
+            params.append("appId", options.appId);
+        }
+        if (options.apiKey) {
+            params.append("apiKey", options.apiKey);
+        }
+        const headers = {};
+        if (options.apiKey) {
+            headers["X-OTA-API-KEY"] = options.apiKey;
+        }
+        const response = await fetch(`${options.serverUrl.replace(/\/$/, "")}/ota/check?${params}`, {
+            headers
+        });
+        if (!response.ok) {
+            throw new Error(`OTA Check failed: HTTP ${response.status}`);
+        }
+        const rawData = await response.json();
+        if (!rawData.updateAvailable) {
+            return null;
+        }
+        const targetVersion = rawData.otaVersion || rawData.version;
+        // Không báo cập nhật nếu phiên bản đã được cài đặt trên máy
+        if (targetVersion && state.currentVersion === targetVersion) {
+            return null;
+        }
+        // Không báo cập nhật nếu phiên bản này từng bị crash và tự rollback
+        if (targetVersion && state.failedVersions?.includes(targetVersion)) {
+            return null;
+        }
+        const serverUrlClean = options.serverUrl.replace(/\/$/, "");
+        const rawUrl = rawData.downloadUrl || "";
+        const fullDownloadUrl = rawUrl.startsWith("http")
+            ? rawUrl
+            : `${serverUrlClean}${rawUrl.startsWith("/") ? "" : "/"}${rawUrl}`;
+        const data = {
+            ...rawData,
+            updateAvailable: true,
+            version: targetVersion,
+            otaVersion: targetVersion,
+            downloadUrl: fullDownloadUrl,
+            mandatory: Boolean(rawData.mandatory || rawData.isMandatory),
+            isMandatory: Boolean(rawData.mandatory || rawData.isMandatory)
+        };
+        return data;
+    }
+    /**
+     * Tải và cài đặt bản cập nhật.
+     */
+    static async downloadAndInstall(update, onProgress, installMode) {
+        const version = update.otaVersion || update.version;
+        if (!update.downloadUrl || !version || !update.sha256) {
+            const missingFields = [
+                !update.downloadUrl && "downloadUrl",
+                !version && "version",
+                !update.sha256 && "sha256"
+            ].filter(Boolean).join(", ");
+            throw new Error(`Invalid update package metadata: missing ${missingFields}`);
+        }
+        const zipPath = `${storage_1.TEMP_DIR}/update-${version}.zip`;
+        await react_native_fs_1.default.unlink(zipPath).catch(() => { });
+        // Download zip file
+        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 res = await downloadRes.promise;
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+            throw new Error(`Download failed with status ${res.statusCode}`);
+        }
+        // SHA-256 verification
+        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(() => { });
+            throw new Error(`SHA-256 Checksum mismatch! Expected ${update.sha256}, got ${actualHash}`);
+        }
+        // Unpack temp directory
+        const tempDir = `${storage_1.TEMP_DIR}/${version}`;
+        await react_native_fs_1.default.unlink(tempDir).catch(() => { });
+        await react_native_fs_1.default.mkdir(tempDir);
+        await native_1.OTAUpdater.unzip(zipPath, tempDir);
+        const bundleName = react_native_1.Platform.OS === "ios" ? "main.jsbundle" : "index.android.bundle";
+        const bundleFile = `${tempDir}/${bundleName}`;
+        if (!(await react_native_fs_1.default.exists(bundleFile))) {
+            throw new Error(`Bundle missing after unzip: ${bundleName}`);
+        }
+        // Atomic move & backup
+        await react_native_fs_1.default.unlink(storage_1.BACKUP_DIR).catch(() => { });
+        if (await react_native_fs_1.default.exists(storage_1.CURRENT_DIR)) {
+            await react_native_fs_1.default.moveFile(storage_1.CURRENT_DIR, storage_1.BACKUP_DIR);
+        }
+        await react_native_fs_1.default.moveFile(tempDir, storage_1.CURRENT_DIR);
+        // Save state
+        const oldState = await (0, storage_1.readState)();
+        await (0, storage_1.writeState)({
+            currentVersion: version,
+            previousVersion: oldState.currentVersion !== "0.0.0" ? oldState.currentVersion : null,
+            pending: true,
+            ready: false,
+            trial: false,
+            failedVersions: oldState.failedVersions || []
+        });
+        await react_native_fs_1.default.unlink(zipPath).catch(() => { });
+        if (installMode === types_1.InstallMode.IMMEDIATE) {
+            await this.restartApp();
+        }
+        return true;
+    }
+    /**
+     * Phương thức đồng bộ tự động như CodePush.sync()
+     */
+    static async sync(options, syncStatusCallback, downloadProgressCallback) {
+        try {
+            // 1. Tự động markReady khi khởi động
+            await this.markReady();
+            // 2. Kiểm tra update
+            const update = await this.checkForUpdate({
+                serverUrl: options.serverUrl,
+                appId: options.appId,
+                apiKey: options.apiKey,
+                nativeVersion: options.nativeVersion,
+                channel: options.channel
+            });
+            if (!update || !update.updateAvailable) {
+                syncStatusCallback?.(types_1.SyncStatus.UP_TO_DATE);
+                return types_1.SyncStatus.UP_TO_DATE;
+            }
+            syncStatusCallback?.(types_1.SyncStatus.UPDATE_AVAILABLE);
+            const proceedWithInstall = async () => {
+                syncStatusCallback?.(types_1.SyncStatus.DOWNLOADING_PACKAGE);
+                const serverUrlClean = options.serverUrl.replace(/\/$/, "");
+                const fullDownloadUrl = update.downloadUrl?.startsWith("http")
+                    ? update.downloadUrl
+                    : `${serverUrlClean}${update.downloadUrl}`;
+                await this.downloadAndInstall({ ...update, downloadUrl: fullDownloadUrl }, downloadProgressCallback);
+                syncStatusCallback?.(types_1.SyncStatus.INSTALLING_UPDATE);
+                syncStatusCallback?.(types_1.SyncStatus.UPDATE_INSTALLED);
+                const effectiveInstallMode = (update.mandatory && options.mandatoryInstallMode)
+                    ? options.mandatoryInstallMode
+                    : (options.installMode || types_1.InstallMode.ON_NEXT_RESTART);
+                if (effectiveInstallMode === types_1.InstallMode.ON_NEXT_RESTART) {
+                    return types_1.SyncStatus.UPDATE_INSTALLED;
+                }
+                // Restart immediate
+                await this.restartApp();
+                return types_1.SyncStatus.UPDATE_INSTALLED;
+            };
+            // 3. Nếu cấu hình hiển thị Update Dialog
+            if (options.updateDialog) {
+                const dialogOpts = typeof options.updateDialog === "object"
+                    ? { ...this.defaultDialog, ...options.updateDialog }
+                    : this.defaultDialog;
+                const isMandatory = Boolean(update.mandatory);
+                const message = isMandatory
+                    ? `${dialogOpts.mandatoryUpdateMessage}\n\nPhiên bản: ${update.otaVersion}\n${update.releaseNotes || ""}`
+                    : `${dialogOpts.optionalUpdateMessage}\n\nPhiên bản: ${update.otaVersion}\n${update.releaseNotes || ""}`;
+                const buttons = [];
+                if (!isMandatory) {
+                    buttons.push({
+                        text: dialogOpts.optionalIgnoreButtonLabel,
+                        style: "cancel"
+                    });
+                }
+                buttons.push({
+                    text: dialogOpts.optionalInstallButtonLabel,
+                    onPress: () => {
+                        proceedWithInstall();
+                    }
+                });
+                react_native_1.Alert.alert(dialogOpts.title || "Cập nhật ứng dụng", message, buttons, {
+                    cancelable: !isMandatory
+                });
+                return types_1.SyncStatus.UPDATE_AVAILABLE;
+            }
+            // Tự động tải ngầm không hiện dialog
+            return await proceedWithInstall();
+        }
+        catch (error) {
+            console.error("[react-native-custom-ota] Sync error:", error);
+            syncStatusCallback?.(types_1.SyncStatus.ERROR);
+            return types_1.SyncStatus.ERROR;
+        }
+    }
+}
+exports.CustomOTAManager = CustomOTAManager;
+CustomOTAManager.defaultDialog = {
+    title: "Có bản cập nhật mới",
+    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"
+};

package/lib/commonjs/native.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTAUpdater = void 0;
+const react_native_1 = require("react-native");
+exports.OTAUpdater = react_native_1.NativeModules.OTAUpdater;
+if (!exports.OTAUpdater) {
+    console.warn("[react-native-custom-ota] NativeModule.OTAUpdater is null! " +
+        "Make sure you have linked the library and rebuilt the native binary.");
+}

package/lib/commonjs/storage.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEMP_DIR = exports.BACKUP_DIR = exports.CURRENT_DIR = exports.OTA_ROOT = void 0;
+exports.ensureOTADirs = ensureOTADirs;
+exports.readState = readState;
+exports.writeState = writeState;
+const react_native_fs_1 = __importDefault(require("react-native-fs"));
+exports.OTA_ROOT = `${react_native_fs_1.default.DocumentDirectoryPath}/ota`;
+exports.CURRENT_DIR = `${exports.OTA_ROOT}/current`;
+exports.BACKUP_DIR = `${exports.OTA_ROOT}/backup`;
+exports.TEMP_DIR = `${exports.OTA_ROOT}/temp`;
+const STATE_FILE = `${exports.OTA_ROOT}/state.json`;
+async function ensureOTADirs() {
+    await react_native_fs_1.default.mkdir(exports.OTA_ROOT).catch(() => { });
+    await react_native_fs_1.default.mkdir(exports.TEMP_DIR).catch(() => { });
+}
+async function readState() {
+    await ensureOTADirs();
+    if (!(await react_native_fs_1.default.exists(STATE_FILE))) {
+        return {
+            currentVersion: "0.0.0",
+            previousVersion: null,
+            pending: false,
+            ready: true,
+            failedVersions: []
+        };
+    }
+    try {
+        const content = await react_native_fs_1.default.readFile(STATE_FILE, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {
+            currentVersion: "0.0.0",
+            previousVersion: null,
+            pending: false,
+            ready: true,
+            failedVersions: []
+        };
+    }
+}
+async function writeState(state) {
+    await ensureOTADirs();
+    await react_native_fs_1.default.writeFile(STATE_FILE, JSON.stringify(state, null, 2), "utf8");
+}

package/lib/commonjs/types.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallMode = exports.CheckFrequency = exports.SyncStatus = void 0;
+var SyncStatus;
+(function (SyncStatus) {
+    SyncStatus[SyncStatus["UP_TO_DATE"] = 0] = "UP_TO_DATE";
+    SyncStatus[SyncStatus["UPDATE_AVAILABLE"] = 1] = "UPDATE_AVAILABLE";
+    SyncStatus[SyncStatus["DOWNLOADING_PACKAGE"] = 2] = "DOWNLOADING_PACKAGE";
+    SyncStatus[SyncStatus["INSTALLING_UPDATE"] = 3] = "INSTALLING_UPDATE";
+    SyncStatus[SyncStatus["UPDATE_INSTALLED"] = 4] = "UPDATE_INSTALLED";
+    SyncStatus[SyncStatus["ERROR"] = -1] = "ERROR";
+})(SyncStatus || (exports.SyncStatus = SyncStatus = {}));
+var CheckFrequency;
+(function (CheckFrequency) {
+    CheckFrequency["ON_APP_START"] = "ON_APP_START";
+    CheckFrequency["ON_APP_RESUME"] = "ON_APP_RESUME";
+    CheckFrequency["MANUAL"] = "MANUAL";
+})(CheckFrequency || (exports.CheckFrequency = CheckFrequency = {}));
+var InstallMode;
+(function (InstallMode) {
+    InstallMode["IMMEDIATE"] = "IMMEDIATE";
+    InstallMode["ON_NEXT_RESTART"] = "ON_NEXT_RESTART";
+})(InstallMode || (exports.InstallMode = InstallMode = {}));

package/lib/module/hoc.js

@@ -0,0 +1,28 @@
+import React, { useEffect } from "react";
+import { AppState } from "react-native";
+import { CustomOTAManager } from "./manager";
+import { CheckFrequency } from "./types";
+export function withCustomOTA(options) {
+    return function (WrappedComponent) {
+        return function CustomOTAWrapper(props) {
+            useEffect(() => {
+                // Tự động kiểm tra cập nhật khi app khởi động
+                if (options.checkFrequency !== CheckFrequency.MANUAL) {
+                    CustomOTAManager.sync(options);
+                }
+                // Nếu bật kiểm tra khi App Resume từ background
+                if (options.checkFrequency === CheckFrequency.ON_APP_RESUME) {
+                    const subscription = AppState.addEventListener("change", (nextAppState) => {
+                        if (nextAppState === "active") {
+                            CustomOTAManager.sync(options);
+                        }
+                    });
+                    return () => {
+                        subscription.remove();
+                    };
+                }
+            }, []);
+            return React.createElement(WrappedComponent, { ...props });
+        };
+    };
+}

package/lib/module/index.js

@@ -0,0 +1,16 @@
+import { CustomOTAManager } from "./manager";
+import { withCustomOTA } from "./hoc";
+export * from "./types";
+export * from "./manager";
+export * from "./hoc";
+export * from "./storage";
+const CustomOTA = {
+    sync: CustomOTAManager.sync.bind(CustomOTAManager),
+    checkForUpdate: CustomOTAManager.checkForUpdate.bind(CustomOTAManager),
+    downloadAndInstall: CustomOTAManager.downloadAndInstall.bind(CustomOTAManager),
+    restartApp: CustomOTAManager.restartApp.bind(CustomOTAManager),
+    getUpdateMetadata: CustomOTAManager.getUpdateMetadata.bind(CustomOTAManager),
+    markReady: CustomOTAManager.markReady.bind(CustomOTAManager),
+    wrap: withCustomOTA
+};
+export default CustomOTA;

package/lib/module/manager.js

@@ -0,0 +1,255 @@
+import { Alert, Platform } from "react-native";
+import RNFS from "react-native-fs";
+import { OTAUpdater } from "./native";
+import { BACKUP_DIR, CURRENT_DIR, TEMP_DIR, ensureOTADirs, readState, writeState } from "./storage";
+import { InstallMode, SyncStatus } from "./types";
+export class CustomOTAManager {
+    /**
+     * Đá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.
+     */
+    static async markReady() {
+        try {
+            const state = await readState();
+            state.pending = false;
+            state.ready = true;
+            state.trial = false;
+            await writeState(state);
+        }
+        catch (e) {
+            console.warn("[CustomOTA] Error updating state in markReady:", e);
+        }
+        if (OTAUpdater?.markReady) {
+            try {
+                await OTAUpdater.markReady();
+            }
+            catch (e) {
+                console.warn("[CustomOTA] Error calling native markReady:", e);
+            }
+        }
+    }
+    /**
+     * Khởi động lại ứng dụng để nạp ngay bản OTA mới.
+     */
+    static async restartApp() {
+        if (OTAUpdater?.restart) {
+            await OTAUpdater.restart();
+        }
+    }
+    /**
+     * Lấy thông tin phiên bản OTA hiện hành trên máy.
+     */
+    static async getUpdateMetadata() {
+        return readState();
+    }
+    /**
+     * Kiểm tra xem server có bản cập nhật mới hay không.
+     */
+    static async checkForUpdate(options) {
+        await ensureOTADirs();
+        const state = await readState();
+        const platform = Platform.OS === "ios" ? "ios" : "android";
+        const nativeVersion = options.nativeVersion || "1.0.0";
+        const channel = options.channel || "production";
+        const params = new URLSearchParams({
+            platform,
+            nativeVersion,
+            otaVersion: state.currentVersion,
+            channel
+        });
+        if (options.appId) {
+            params.append("appId", options.appId);
+        }
+        if (options.apiKey) {
+            params.append("apiKey", options.apiKey);
+        }
+        const headers = {};
+        if (options.apiKey) {
+            headers["X-OTA-API-KEY"] = options.apiKey;
+        }
+        const response = await fetch(`${options.serverUrl.replace(/\/$/, "")}/ota/check?${params}`, {
+            headers
+        });
+        if (!response.ok) {
+            throw new Error(`OTA Check failed: HTTP ${response.status}`);
+        }
+        const rawData = await response.json();
+        if (!rawData.updateAvailable) {
+            return null;
+        }
+        const targetVersion = rawData.otaVersion || rawData.version;
+        // Không báo cập nhật nếu phiên bản đã được cài đặt trên máy
+        if (targetVersion && state.currentVersion === targetVersion) {
+            return null;
+        }
+        // Không báo cập nhật nếu phiên bản này từng bị crash và tự rollback
+        if (targetVersion && state.failedVersions?.includes(targetVersion)) {
+            return null;
+        }
+        const serverUrlClean = options.serverUrl.replace(/\/$/, "");
+        const rawUrl = rawData.downloadUrl || "";
+        const fullDownloadUrl = rawUrl.startsWith("http")
+            ? rawUrl
+            : `${serverUrlClean}${rawUrl.startsWith("/") ? "" : "/"}${rawUrl}`;
+        const data = {
+            ...rawData,
+            updateAvailable: true,
+            version: targetVersion,
+            otaVersion: targetVersion,
+            downloadUrl: fullDownloadUrl,
+            mandatory: Boolean(rawData.mandatory || rawData.isMandatory),
+            isMandatory: Boolean(rawData.mandatory || rawData.isMandatory)
+        };
+        return data;
+    }
+    /**
+     * Tải và cài đặt bản cập nhật.
+     */
+    static async downloadAndInstall(update, onProgress, installMode) {
+        const version = update.otaVersion || update.version;
+        if (!update.downloadUrl || !version || !update.sha256) {
+            const missingFields = [
+                !update.downloadUrl && "downloadUrl",
+                !version && "version",
+                !update.sha256 && "sha256"
+            ].filter(Boolean).join(", ");
+            throw new Error(`Invalid update package metadata: missing ${missingFields}`);
+        }
+        const zipPath = `${TEMP_DIR}/update-${version}.zip`;
+        await RNFS.unlink(zipPath).catch(() => { });
+        // Download zip file
+        const downloadRes = RNFS.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 res = await downloadRes.promise;
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+            throw new Error(`Download failed with status ${res.statusCode}`);
+        }
+        // SHA-256 verification
+        const actualHash = await RNFS.hash(zipPath, "sha256");
+        if (actualHash.toLowerCase() !== update.sha256.toLowerCase()) {
+            await RNFS.unlink(zipPath).catch(() => { });
+            throw new Error(`SHA-256 Checksum mismatch! Expected ${update.sha256}, got ${actualHash}`);
+        }
+        // Unpack temp directory
+        const tempDir = `${TEMP_DIR}/${version}`;
+        await RNFS.unlink(tempDir).catch(() => { });
+        await RNFS.mkdir(tempDir);
+        await OTAUpdater.unzip(zipPath, tempDir);
+        const bundleName = Platform.OS === "ios" ? "main.jsbundle" : "index.android.bundle";
+        const bundleFile = `${tempDir}/${bundleName}`;
+        if (!(await RNFS.exists(bundleFile))) {
+            throw new Error(`Bundle missing after unzip: ${bundleName}`);
+        }
+        // Atomic move & backup
+        await RNFS.unlink(BACKUP_DIR).catch(() => { });
+        if (await RNFS.exists(CURRENT_DIR)) {
+            await RNFS.moveFile(CURRENT_DIR, BACKUP_DIR);
+        }
+        await RNFS.moveFile(tempDir, CURRENT_DIR);
+        // Save state
+        const oldState = await readState();
+        await writeState({
+            currentVersion: version,
+            previousVersion: oldState.currentVersion !== "0.0.0" ? oldState.currentVersion : null,
+            pending: true,
+            ready: false,
+            trial: false,
+            failedVersions: oldState.failedVersions || []
+        });
+        await RNFS.unlink(zipPath).catch(() => { });
+        if (installMode === InstallMode.IMMEDIATE) {
+            await this.restartApp();
+        }
+        return true;
+    }
+    /**
+     * Phương thức đồng bộ tự động như CodePush.sync()
+     */
+    static async sync(options, syncStatusCallback, downloadProgressCallback) {
+        try {
+            // 1. Tự động markReady khi khởi động
+            await this.markReady();
+            // 2. Kiểm tra update
+            const update = await this.checkForUpdate({
+                serverUrl: options.serverUrl,
+                appId: options.appId,
+                apiKey: options.apiKey,
+                nativeVersion: options.nativeVersion,
+                channel: options.channel
+            });
+            if (!update || !update.updateAvailable) {
+                syncStatusCallback?.(SyncStatus.UP_TO_DATE);
+                return SyncStatus.UP_TO_DATE;
+            }
+            syncStatusCallback?.(SyncStatus.UPDATE_AVAILABLE);
+            const proceedWithInstall = async () => {
+                syncStatusCallback?.(SyncStatus.DOWNLOADING_PACKAGE);
+                const serverUrlClean = options.serverUrl.replace(/\/$/, "");
+                const fullDownloadUrl = update.downloadUrl?.startsWith("http")
+                    ? update.downloadUrl
+                    : `${serverUrlClean}${update.downloadUrl}`;
+                await this.downloadAndInstall({ ...update, downloadUrl: fullDownloadUrl }, downloadProgressCallback);
+                syncStatusCallback?.(SyncStatus.INSTALLING_UPDATE);
+                syncStatusCallback?.(SyncStatus.UPDATE_INSTALLED);
+                const effectiveInstallMode = (update.mandatory && options.mandatoryInstallMode)
+                    ? options.mandatoryInstallMode
+                    : (options.installMode || InstallMode.ON_NEXT_RESTART);
+                if (effectiveInstallMode === InstallMode.ON_NEXT_RESTART) {
+                    return SyncStatus.UPDATE_INSTALLED;
+                }
+                // Restart immediate
+                await this.restartApp();
+                return SyncStatus.UPDATE_INSTALLED;
+            };
+            // 3. Nếu cấu hình hiển thị Update Dialog
+            if (options.updateDialog) {
+                const dialogOpts = typeof options.updateDialog === "object"
+                    ? { ...this.defaultDialog, ...options.updateDialog }
+                    : this.defaultDialog;
+                const isMandatory = Boolean(update.mandatory);
+                const message = isMandatory
+                    ? `${dialogOpts.mandatoryUpdateMessage}\n\nPhiên bản: ${update.otaVersion}\n${update.releaseNotes || ""}`
+                    : `${dialogOpts.optionalUpdateMessage}\n\nPhiên bản: ${update.otaVersion}\n${update.releaseNotes || ""}`;
+                const buttons = [];
+                if (!isMandatory) {
+                    buttons.push({
+                        text: dialogOpts.optionalIgnoreButtonLabel,
+                        style: "cancel"
+                    });
+                }
+                buttons.push({
+                    text: dialogOpts.optionalInstallButtonLabel,
+                    onPress: () => {
+                        proceedWithInstall();
+                    }
+                });
+                Alert.alert(dialogOpts.title || "Cập nhật ứng dụng", message, buttons, {
+                    cancelable: !isMandatory
+                });
+                return SyncStatus.UPDATE_AVAILABLE;
+            }
+            // Tự động tải ngầm không hiện dialog
+            return await proceedWithInstall();
+        }
+        catch (error) {
+            console.error("[react-native-custom-ota] Sync error:", error);
+            syncStatusCallback?.(SyncStatus.ERROR);
+            return SyncStatus.ERROR;
+        }
+    }
+}
+CustomOTAManager.defaultDialog = {
+    title: "Có bản cập nhật mới",
+    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"
+};

package/lib/module/native.js

@@ -0,0 +1,6 @@
+import { NativeModules } from "react-native";
+export const OTAUpdater = NativeModules.OTAUpdater;
+if (!OTAUpdater) {
+    console.warn("[react-native-custom-ota] NativeModule.OTAUpdater is null! " +
+        "Make sure you have linked the library and rebuilt the native binary.");
+}