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

package/lib/module/storage.js

@@ -0,0 +1,39 @@
+import RNFS from "react-native-fs";
+export const OTA_ROOT = `${RNFS.DocumentDirectoryPath}/ota`;
+export const CURRENT_DIR = `${OTA_ROOT}/current`;
+export const BACKUP_DIR = `${OTA_ROOT}/backup`;
+export const TEMP_DIR = `${OTA_ROOT}/temp`;
+const STATE_FILE = `${OTA_ROOT}/state.json`;
+export async function ensureOTADirs() {
+    await RNFS.mkdir(OTA_ROOT).catch(() => { });
+    await RNFS.mkdir(TEMP_DIR).catch(() => { });
+}
+export async function readState() {
+    await ensureOTADirs();
+    if (!(await RNFS.exists(STATE_FILE))) {
+        return {
+            currentVersion: "0.0.0",
+            previousVersion: null,
+            pending: false,
+            ready: true,
+            failedVersions: []
+        };
+    }
+    try {
+        const content = await RNFS.readFile(STATE_FILE, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {
+            currentVersion: "0.0.0",
+            previousVersion: null,
+            pending: false,
+            ready: true,
+            failedVersions: []
+        };
+    }
+}
+export async function writeState(state) {
+    await ensureOTADirs();
+    await RNFS.writeFile(STATE_FILE, JSON.stringify(state, null, 2), "utf8");
+}

package/lib/module/types.js

@@ -0,0 +1,20 @@
+export 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 || (SyncStatus = {}));
+export var CheckFrequency;
+(function (CheckFrequency) {
+    CheckFrequency["ON_APP_START"] = "ON_APP_START";
+    CheckFrequency["ON_APP_RESUME"] = "ON_APP_RESUME";
+    CheckFrequency["MANUAL"] = "MANUAL";
+})(CheckFrequency || (CheckFrequency = {}));
+export var InstallMode;
+(function (InstallMode) {
+    InstallMode["IMMEDIATE"] = "IMMEDIATE";
+    InstallMode["ON_NEXT_RESTART"] = "ON_NEXT_RESTART";
+})(InstallMode || (InstallMode = {}));

package/lib/typescript/hoc.d.ts

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

package/lib/typescript/hoc.js

@@ -0,0 +1,64 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withCustomOTA = withCustomOTA;
+const react_1 = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const manager_1 = require("./manager");
+const types_1 = require("./types");
+function withCustomOTA(options) {
+    return function (WrappedComponent) {
+        return function CustomOTAWrapper(props) {
+            (0, react_1.useEffect)(() => {
+                // 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);
+                }
+                // Nếu bật kiểm tra khi App Resume từ background
+                if (options.checkFrequency === types_1.CheckFrequency.ON_APP_RESUME) {
+                    const subscription = react_native_1.AppState.addEventListener("change", (nextAppState) => {
+                        if (nextAppState === "active") {
+                            manager_1.CustomOTAManager.sync(options);
+                        }
+                    });
+                    return () => {
+                        subscription.remove();
+                    };
+                }
+            }, []);
+            return react_1.default.createElement(WrappedComponent, { ...props });
+        };
+    };
+}

package/lib/typescript/index.d.ts

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

package/lib/typescript/index.js

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const manager_1 = require("./manager");
+const hoc_1 = require("./hoc");
+__exportStar(require("./types"), exports);
+__exportStar(require("./manager"), exports);
+__exportStar(require("./hoc"), exports);
+__exportStar(require("./storage"), exports);
+const CustomOTA = {
+    sync: manager_1.CustomOTAManager.sync.bind(manager_1.CustomOTAManager),
+    checkForUpdate: manager_1.CustomOTAManager.checkForUpdate.bind(manager_1.CustomOTAManager),
+    downloadAndInstall: manager_1.CustomOTAManager.downloadAndInstall.bind(manager_1.CustomOTAManager),
+    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
+};
+exports.default = CustomOTA;

package/lib/typescript/manager.d.ts

@@ -0,0 +1,35 @@
+import { InstallMode, LocalPackage, RemotePackage, SyncOptions, SyncStatus } from "./types";
+export declare class CustomOTAManager {
+    private static defaultDialog;
+    /**
+     * Đá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 markReady(): Promise<void>;
+    /**
+     * Khởi động lại ứng dụng để nạp ngay bản OTA mới.
+     */
+    static restartApp(): Promise<void>;
+    /**
+     * Lấy thông tin phiên bản OTA hiện hành trên máy.
+     */
+    static getUpdateMetadata(): Promise<LocalPackage>;
+    /**
+     * Kiểm tra xem server có bản cập nhật mới hay không.
+     */
+    static checkForUpdate(options: {
+        serverUrl: string;
+        appId?: string;
+        apiKey?: string;
+        nativeVersion?: string;
+        channel?: string;
+    }): Promise<RemotePackage | null>;
+    /**
+     * Tải và cài đặt bản cập nhật.
+     */
+    static downloadAndInstall(update: RemotePackage, onProgress?: (progress: 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>;
+}

package/lib/typescript/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/typescript/native.d.ts

@@ -0,0 +1,8 @@
+interface OTAUpdaterInterface {
+    unzip(zipPath: string, targetDir: string): Promise<void>;
+    markReady(): Promise<void>;
+    getCurrentVersion(): Promise<string>;
+    restart(): Promise<void>;
+}
+export declare const OTAUpdater: OTAUpdaterInterface;
+export {};

package/lib/typescript/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/typescript/src/hoc.d.ts

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

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,15 @@
+import { CustomOTAManager } from "./manager";
+import { withCustomOTA } from "./hoc";
+export * from "./types";
+export * from "./manager";
+export * from "./hoc";
+declare const CustomOTA: {
+    sync: typeof CustomOTAManager.sync;
+    checkForUpdate: typeof CustomOTAManager.checkForUpdate;
+    downloadAndInstall: typeof CustomOTAManager.downloadAndInstall;
+    restartApp: typeof CustomOTAManager.restartApp;
+    getUpdateMetadata: typeof CustomOTAManager.getUpdateMetadata;
+    markReady: typeof CustomOTAManager.markReady;
+    wrap: typeof withCustomOTA;
+};
+export default CustomOTA;

package/lib/typescript/src/manager.d.ts

@@ -0,0 +1,33 @@
+import { LocalPackage, RemotePackage, SyncOptions, SyncStatus } from "./types";
+export declare class CustomOTAManager {
+    private static defaultDialog;
+    /**
+     * Đá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 markReady(): Promise<void>;
+    /**
+     * Khởi động lại ứng dụng để nạp ngay bản OTA mới.
+     */
+    static restartApp(): Promise<void>;
+    /**
+     * Lấy thông tin phiên bản OTA hiện hành trên máy.
+     */
+    static getUpdateMetadata(): Promise<LocalPackage>;
+    /**
+     * Kiểm tra xem server có bản cập nhật mới hay không.
+     */
+    static checkForUpdate(options: {
+        serverUrl: string;
+        nativeVersion?: string;
+        channel?: string;
+    }): Promise<RemotePackage>;
+    /**
+     * Tải và cài đặt bản cập nhật.
+     */
+    static downloadAndInstall(update: RemotePackage, onProgress?: (progress: number) => void): Promise<void>;
+    /**
+     * 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>;
+}

package/lib/typescript/src/native.d.ts

@@ -0,0 +1,8 @@
+interface OTAUpdaterInterface {
+    unzip(zipPath: string, targetDir: string): Promise<void>;
+    markReady(): Promise<void>;
+    getCurrentVersion(): Promise<string>;
+    restart(): Promise<void>;
+}
+export declare const OTAUpdater: OTAUpdaterInterface;
+export {};

package/lib/typescript/src/storage.d.ts

@@ -0,0 +1,8 @@
+import { LocalPackage } from "./types";
+export declare const OTA_ROOT: string;
+export declare const CURRENT_DIR: string;
+export declare const BACKUP_DIR: string;
+export declare const TEMP_DIR: string;
+export declare function ensureOTADirs(): Promise<void>;
+export declare function readState(): Promise<LocalPackage>;
+export declare function writeState(state: LocalPackage): Promise<void>;

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,54 @@
+export declare enum SyncStatus {
+    UP_TO_DATE = 0,
+    UPDATE_AVAILABLE = 1,
+    DOWNLOADING_PACKAGE = 2,
+    INSTALLING_UPDATE = 3,
+    UPDATE_INSTALLED = 4,
+    ERROR = -1
+}
+export declare enum CheckFrequency {
+    ON_APP_START = "ON_APP_START",
+    ON_APP_RESUME = "ON_APP_RESUME",
+    MANUAL = "MANUAL"
+}
+export declare enum InstallMode {
+    IMMEDIATE = "IMMEDIATE",
+    ON_NEXT_RESTART = "ON_NEXT_RESTART"
+}
+export interface UpdateDialogOptions {
+    title?: string;
+    optionalUpdateMessage?: string;
+    mandatoryUpdateMessage?: string;
+    optionalInstallButtonLabel?: string;
+    optionalIgnoreButtonLabel?: string;
+}
+export interface SyncOptions {
+    serverUrl: string;
+    nativeVersion?: string;
+    channel?: string;
+    installMode?: InstallMode;
+    updateDialog?: boolean | UpdateDialogOptions;
+    checkFrequency?: CheckFrequency;
+}
+export interface RemotePackage {
+    updateAvailable: boolean;
+    appId?: string;
+    platform?: string;
+    otaVersion?: string;
+    bundle?: string;
+    sha256?: string;
+    channel?: string;
+    minNativeVersion?: string;
+    mandatory?: boolean;
+    releaseNotes?: string;
+    downloadUrl?: string;
+    size?: number;
+    reason?: string;
+}
+export interface LocalPackage {
+    currentVersion: string;
+    previousVersion: string | null;
+    pending: boolean;
+    ready: boolean;
+    failedVersions: string[];
+}

package/lib/typescript/storage.d.ts

@@ -0,0 +1,8 @@
+import { LocalPackage } from "./types";
+export declare const OTA_ROOT: string;
+export declare const CURRENT_DIR: string;
+export declare const BACKUP_DIR: string;
+export declare const TEMP_DIR: string;
+export declare function ensureOTADirs(): Promise<void>;
+export declare function readState(): Promise<LocalPackage>;
+export declare function writeState(state: LocalPackage): Promise<void>;