@appsonair.ir/react-native 1.0.1 → 1.0.3

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 import { configure, getConfig } from './config';
 import { configureFromProject, getDeploymentKey, isOtaConfigured, resolveUpdaterConfig } from './projectConfig';
-import { sync, restartApp, installApk, resumePendingApkInstall, clearUpdate, getInstalledBundlePath, notifyAppReady, isSyncInProgress } from './sync';
+import { sync, restartApp, installApk, resumePendingApkInstall, clearUpdate, getInstalledBundlePath, notifyAppReady } from './sync';
 import { UpdateCheckResult } from './types';
 export { configure, getConfig, getServerUrl } from './config';
 export { DEFAULT_SERVER_URL } from './constants';
@@ -8,7 +8,7 @@ export { configureFromProject, getDeploymentKey, isOtaConfigured, resolveUpdater
 export type { ProjectOtaConfig } from './types';
 export declare function getCurrentLabel(): Promise<string | null>;
 export declare function checkUpdate(): Promise<UpdateCheckResult>;
-export { sync, restartApp, installApk, resumePendingApkInstall, clearUpdate, getInstalledBundlePath, notifyAppReady, isSyncInProgress };
+export { sync, restartApp, installApk, resumePendingApkInstall, clearUpdate, getInstalledBundlePath, notifyAppReady, isSyncInProgress, respondToUpdatePrompt, } from './sync';
 export { OTAUpdateModal } from './ui/OTAUpdateModal';
 export { OTAUpdateProvider } from './ui/OTAUpdateProvider';
 export declare const OTAUpdater: {

package/lib/index.js

@@ -17,7 +17,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OTAUpdater = exports.OTAUpdateProvider = exports.OTAUpdateModal = exports.isSyncInProgress = exports.notifyAppReady = exports.getInstalledBundlePath = exports.clearUpdate = exports.resumePendingApkInstall = exports.installApk = exports.restartApp = exports.sync = exports.resolveUpdaterConfig = exports.isOtaConfigured = exports.getDeploymentKey = exports.configureFromProject = exports.DEFAULT_SERVER_URL = exports.getServerUrl = exports.getConfig = exports.configure = void 0;
+exports.OTAUpdater = exports.OTAUpdateProvider = exports.OTAUpdateModal = exports.respondToUpdatePrompt = exports.isSyncInProgress = exports.notifyAppReady = exports.getInstalledBundlePath = exports.clearUpdate = exports.resumePendingApkInstall = exports.installApk = exports.restartApp = exports.sync = exports.resolveUpdaterConfig = exports.isOtaConfigured = exports.getDeploymentKey = exports.configureFromProject = exports.DEFAULT_SERVER_URL = exports.getServerUrl = exports.getConfig = exports.configure = void 0;
 exports.getCurrentLabel = getCurrentLabel;
 exports.checkUpdate = checkUpdate;
 const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
@@ -29,14 +29,6 @@ Object.defineProperty(exports, "getDeploymentKey", { enumerable: true, get: func
 Object.defineProperty(exports, "isOtaConfigured", { enumerable: true, get: function () { return projectConfig_1.isOtaConfigured; } });
 Object.defineProperty(exports, "resolveUpdaterConfig", { enumerable: true, get: function () { return projectConfig_1.resolveUpdaterConfig; } });
 const sync_1 = require("./sync");
-Object.defineProperty(exports, "sync", { enumerable: true, get: function () { return sync_1.sync; } });
-Object.defineProperty(exports, "restartApp", { enumerable: true, get: function () { return sync_1.restartApp; } });
-Object.defineProperty(exports, "installApk", { enumerable: true, get: function () { return sync_1.installApk; } });
-Object.defineProperty(exports, "resumePendingApkInstall", { enumerable: true, get: function () { return sync_1.resumePendingApkInstall; } });
-Object.defineProperty(exports, "clearUpdate", { enumerable: true, get: function () { return sync_1.clearUpdate; } });
-Object.defineProperty(exports, "getInstalledBundlePath", { enumerable: true, get: function () { return sync_1.getInstalledBundlePath; } });
-Object.defineProperty(exports, "notifyAppReady", { enumerable: true, get: function () { return sync_1.notifyAppReady; } });
-Object.defineProperty(exports, "isSyncInProgress", { enumerable: true, get: function () { return sync_1.isSyncInProgress; } });
 var config_2 = require("./config");
 Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return config_2.configure; } });
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_2.getConfig; } });
@@ -58,6 +50,16 @@ async function checkUpdate() {
     const deviceAbi = react_native_1.Platform.OS === 'android' ? await (0, sync_1.getDeviceAbi)() : undefined;
     return (0, sync_1.checkForUpdate)((0, config_1.getServerUrl)(config), config.deploymentKey, appVersion, meta?.label, meta?.packageHash, clientUniqueId, react_native_1.Platform.OS === 'android' ? react_native_device_info_1.default.getBuildNumber() : undefined, deviceAbi);
 }
+var sync_2 = require("./sync");
+Object.defineProperty(exports, "sync", { enumerable: true, get: function () { return sync_2.sync; } });
+Object.defineProperty(exports, "restartApp", { enumerable: true, get: function () { return sync_2.restartApp; } });
+Object.defineProperty(exports, "installApk", { enumerable: true, get: function () { return sync_2.installApk; } });
+Object.defineProperty(exports, "resumePendingApkInstall", { enumerable: true, get: function () { return sync_2.resumePendingApkInstall; } });
+Object.defineProperty(exports, "clearUpdate", { enumerable: true, get: function () { return sync_2.clearUpdate; } });
+Object.defineProperty(exports, "getInstalledBundlePath", { enumerable: true, get: function () { return sync_2.getInstalledBundlePath; } });
+Object.defineProperty(exports, "notifyAppReady", { enumerable: true, get: function () { return sync_2.notifyAppReady; } });
+Object.defineProperty(exports, "isSyncInProgress", { enumerable: true, get: function () { return sync_2.isSyncInProgress; } });
+Object.defineProperty(exports, "respondToUpdatePrompt", { enumerable: true, get: function () { return sync_2.respondToUpdatePrompt; } });
 var OTAUpdateModal_1 = require("./ui/OTAUpdateModal");
 Object.defineProperty(exports, "OTAUpdateModal", { enumerable: true, get: function () { return OTAUpdateModal_1.OTAUpdateModal; } });
 var OTAUpdateProvider_1 = require("./ui/OTAUpdateProvider");

package/lib/sync.d.ts

@@ -1,11 +1,17 @@
-import { OTAProgressMessages, StoredBundleMeta, SyncOptions, SyncResult, SyncStatus, UpdateCheckResult } from './types';
+import { InstallMode, OTAProgressMessages, StoredBundleMeta, SyncOptions, SyncResult, SyncStatus, UpdateCheckResult } from './types';
 export interface OTAProgressState {
     visible: boolean;
     status: SyncStatus;
     progress: number;
     message: string;
     label?: string;
+    /** Release changelog / notes */
     description?: string;
+    isMandatory?: boolean;
+    installMode?: InstallMode;
+    /** Show Update / Skip actions (UPDATE_AVAILABLE or deferred done / error dismiss) */
+    showActions?: boolean;
+    canSkip?: boolean;
     error?: string;
 }
 type ProgressListener = (state: OTAProgressState) => void;
@@ -19,11 +25,22 @@ export declare const defaultMessages: {
     installing: string;
     restarting: string;
     error: string;
+    downloadInterrupted: string;
     upToDate: string;
+    updateAvailable: string;
+    changelogTitle: string;
+    updateNow: string;
+    skip: string;
+    dismiss: string;
+    appliedNextLaunch: string;
+    mandatoryHint: string;
 };
 export declare function getMessageForStatus(status: SyncStatus, messages?: Partial<typeof defaultMessages>): string;
 export declare function getModalTitle(messages?: Partial<typeof defaultMessages>): string;
 export declare function delay(ms: number): Promise<void>;
+type UpdatePromptAction = 'update' | 'skip' | 'dismiss';
+/** Resolve the Update / Skip / Dismiss prompt shown by OTAUpdateModal. */
+export declare function respondToUpdatePrompt(action: UpdatePromptAction): void;
 export declare function getStoredBundleMeta(): Promise<StoredBundleMeta | null>;
 export declare function setStoredBundleMeta(meta: StoredBundleMeta): Promise<void>;
 export declare function getClientUniqueId(): Promise<string>;

package/lib/sync.js

@@ -10,6 +10,7 @@ exports.hideProgress = hideProgress;
 exports.getMessageForStatus = getMessageForStatus;
 exports.getModalTitle = getModalTitle;
 exports.delay = delay;
+exports.respondToUpdatePrompt = respondToUpdatePrompt;
 exports.getStoredBundleMeta = getStoredBundleMeta;
 exports.setStoredBundleMeta = setStoredBundleMeta;
 exports.getClientUniqueId = getClientUniqueId;
@@ -61,8 +62,10 @@ function hideProgress() {
     progressListeners.forEach((listener) => listener(progressState));
 }
 function shouldShowModalForStatus(status) {
-    return (status === types_1.SyncStatus.DOWNLOADING ||
+    return (status === types_1.SyncStatus.UPDATE_AVAILABLE ||
+        status === types_1.SyncStatus.DOWNLOADING ||
         status === types_1.SyncStatus.RESTARTING ||
+        status === types_1.SyncStatus.UPDATE_INSTALLED ||
         status === types_1.SyncStatus.ERROR);
 }
 exports.defaultMessages = {
@@ -72,19 +75,31 @@ exports.defaultMessages = {
     installing: 'در حال نصب به\u200cروزرسانی...',
     restarting: 'در حال راه\u200cاندازی مجدد...',
     error: 'خطا در به\u200cروزرسانی',
+    downloadInterrupted: 'دانلود قطع شد. لطفاً دوباره تلاش کنید',
     upToDate: 'برنامه به\u200cروز است',
+    updateAvailable: 'نسخه جدیدی در دسترس است',
+    changelogTitle: 'تغییرات این نسخه',
+    updateNow: 'به\u200cروزرسانی',
+    skip: 'فعلاً نه',
+    dismiss: 'باشه',
+    appliedNextLaunch: 'به\u200cروزرسانی نصب شد و در اجرای بعدی برنامه اعمال می\u200cشود',
+    mandatoryHint: 'این به\u200cروزرسانی الزامی است',
 };
 function getMessageForStatus(status, messages = {}) {
     const m = { ...exports.defaultMessages, ...messages };
     switch (status) {
         case types_1.SyncStatus.CHECKING:
             return m.checking;
+        case types_1.SyncStatus.UPDATE_AVAILABLE:
+            return m.updateAvailable;
         case types_1.SyncStatus.DOWNLOADING:
             return m.downloading;
         case types_1.SyncStatus.INSTALLING:
             return m.installing;
         case types_1.SyncStatus.RESTARTING:
             return m.restarting;
+        case types_1.SyncStatus.UPDATE_INSTALLED:
+            return m.appliedNextLaunch;
         case types_1.SyncStatus.ERROR:
             return m.error;
         default:
@@ -124,7 +139,41 @@ const CLIENT_ID_KEY = '@appsonair.ir/client-id';
 const NATIVE_VERSION_KEY = '@appsonair.ir/native-version';
 const NATIVE_BUILD_KEY = '@appsonair.ir/native-build';
 const RESTART_COOLDOWN_KEY = '@appsonair.ir/last-restart';
+const SKIPPED_UPDATE_KEY = '@appsonair.ir/skipped-update';
 const RESTART_COOLDOWN_MS = 15000;
+let pendingPrompt = null;
+/** Resolve the Update / Skip / Dismiss prompt shown by OTAUpdateModal. */
+function respondToUpdatePrompt(action) {
+    if (!pendingPrompt)
+        return;
+    const { resolve } = pendingPrompt;
+    pendingPrompt = null;
+    resolve(action);
+}
+function waitForUpdatePrompt() {
+    return new Promise((resolve) => {
+        pendingPrompt = { resolve };
+    });
+}
+function resolveInstallMode(mode) {
+    if (mode === 'next-launch' || mode === 'on-next-restart' || mode === 'on-next-resume') {
+        return 'next-launch';
+    }
+    return 'immediate';
+}
+function getUpdateChangelog(update) {
+    const text = update.changelog ?? update.description;
+    return text?.trim() ? text.trim() : undefined;
+}
+async function getSkippedUpdateLabel() {
+    return async_storage_1.default.getItem(SKIPPED_UPDATE_KEY);
+}
+async function markUpdateSkipped(label) {
+    await async_storage_1.default.setItem(SKIPPED_UPDATE_KEY, label);
+}
+async function clearSkippedUpdate() {
+    await async_storage_1.default.removeItem(SKIPPED_UPDATE_KEY);
+}
 async function getStoredBundleMeta() {
     const raw = await async_storage_1.default.getItem(STORAGE_KEY);
     if (!raw)
@@ -365,6 +414,31 @@ async function ensureBundleDirectory() {
         await ReactNativeBlobUtil.fs.mkdir(dir);
     }
 }
+/** Keep only the active OTA package so leftover extracts don't fill disk / slow IO. */
+async function cleanupOldUpdates(keepLabel) {
+    try {
+        const ReactNativeBlobUtil = require('react-native-blob-util').default;
+        const dir = getBundleDirectory();
+        const exists = await ReactNativeBlobUtil.fs.exists(dir);
+        if (!exists)
+            return;
+        const keep = new Set([
+            keepLabel,
+            `${keepLabel}.zip`,
+            `${keepLabel}.bundle`,
+        ]);
+        const entries = await ReactNativeBlobUtil.fs.ls(dir);
+        await Promise.all(entries.map(async (entry) => {
+            if (keep.has(entry) || entry.endsWith('.apk')) {
+                return;
+            }
+            await removePathRecursive(`${dir}/${entry}`);
+        }));
+    }
+    catch {
+        // Best-effort cleanup; a leftover folder must not fail install.
+    }
+}
 async function resolveDownloadSize(downloadUrl, deploymentKey, expectedSize, deviceAbi) {
     if (expectedSize && expectedSize > 0) {
         return expectedSize;
@@ -401,6 +475,80 @@ async function resolveDownloadSize(downloadUrl, deploymentKey, expectedSize, dev
     }
     return expectedSize ?? 0;
 }
+const DOWNLOAD_MAX_ATTEMPTS = 3;
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return String(error);
+}
+function isRetryableDownloadError(error) {
+    const message = getErrorMessage(error).toLowerCase();
+    return (message.includes('download interrupted') ||
+        message.includes('network') ||
+        message.includes('timeout') ||
+        message.includes('timed out') ||
+        message.includes('connection') ||
+        message.includes('socket') ||
+        message.includes('econnreset') ||
+        message.includes('failed to connect') ||
+        message.includes('software caused connection abort'));
+}
+function toUserFacingDownloadError(error) {
+    if (isRetryableDownloadError(error)) {
+        return new Error(exports.defaultMessages.downloadInterrupted);
+    }
+    return error instanceof Error ? error : new Error(getErrorMessage(error));
+}
+async function cleanupPartialDownload(path) {
+    try {
+        const ReactNativeBlobUtil = require('react-native-blob-util').default;
+        const exists = await ReactNativeBlobUtil.fs.exists(path);
+        if (exists) {
+            await ReactNativeBlobUtil.fs.unlink(path);
+        }
+    }
+    catch {
+        // Ignore cleanup errors.
+    }
+}
+/**
+ * react-native-blob-util rejects with "Download interrupted." whenever
+ * bytesWritten !== Content-Length — including when Content-Length is wrong
+ * but the full file actually landed. Recover those cases via size/hash checks.
+ */
+async function tryRecoverCompletedDownload(destPath, extension, totalBytes, expectedHash, packageFormat, label) {
+    try {
+        const ReactNativeBlobUtil = require('react-native-blob-util').default;
+        const exists = await ReactNativeBlobUtil.fs.exists(destPath);
+        if (!exists)
+            return null;
+        const stat = await ReactNativeBlobUtil.fs.stat(destPath);
+        const minSize = extension === 'apk' ? 1024 * 100 : 1024;
+        if (!stat || stat.size < minSize)
+            return null;
+        const sizeLooksComplete = totalBytes <= 0 || Math.abs(stat.size - totalBytes) <= 1;
+        if (expectedHash) {
+            const valid = await verifyBundleHash(destPath, expectedHash);
+            if (!valid)
+                return null;
+        }
+        else if (!sizeLooksComplete) {
+            return null;
+        }
+        if (extension === 'bundle' && (await shouldExtractZipPackage(destPath, packageFormat))) {
+            return extractBundleUpdate(label, destPath);
+        }
+        return destPath;
+    }
+    catch {
+        return null;
+    }
+}
 async function downloadBundle(downloadUrl, deploymentKey, label, expectedSize, onProgress, extension = 'bundle', deviceAbi, packageFormat = 'bundle', expectedHash) {
     const ReactNativeBlobUtil = require('react-native-blob-util').default;
     const isZipBundle = extension === 'bundle' && packageFormat === 'zip';
@@ -414,76 +562,95 @@ async function downloadBundle(downloadUrl, deploymentKey, label, expectedSize, o
     if (isZipBundle) {
         await removePathRecursive(getBundleReleaseDir(label));
     }
-    const destExists = await ReactNativeBlobUtil.fs.exists(destPath);
-    if (destExists) {
-        await ReactNativeBlobUtil.fs.unlink(destPath);
-    }
-    const task = ReactNativeBlobUtil.config({
-        path: destPath,
-        fileCache: false,
-        overwrite: true,
-    }).fetch('GET', downloadUrl, {
-        'X-Deployment-Key': deploymentKey,
-        ...(deviceAbi ? { 'X-Device-Abi': deviceAbi } : {}),
-    });
-    const reportDownloadProgress = (received, total) => {
-        if (!onProgress)
-            return;
-        const resolvedTotal = total > 0 ? total : totalBytes;
-        if (resolvedTotal <= 0)
-            return;
-        onProgress(Math.min(Math.max(received / resolvedTotal, 0), 0.99));
-    };
-    let pollTimer = null;
-    if (onProgress && totalBytes > 0) {
-        pollTimer = setInterval(async () => {
-            try {
-                const exists = await ReactNativeBlobUtil.fs.exists(destPath);
-                if (!exists)
-                    return;
-                const stat = await ReactNativeBlobUtil.fs.stat(destPath);
-                reportDownloadProgress(stat.size, totalBytes);
-            }
-            catch {
-                // Ignore polling errors while the file is being written.
-            }
-        }, 150);
-    }
-    if (onProgress) {
-        task.progress({ interval: 100, count: 10 }, (received, total) => {
-            reportDownloadProgress(received, total);
+    let lastError;
+    for (let attempt = 1; attempt <= DOWNLOAD_MAX_ATTEMPTS; attempt++) {
+        await cleanupPartialDownload(destPath);
+        const task = ReactNativeBlobUtil.config({
+            path: destPath,
+            fileCache: false,
+            overwrite: true,
+            timeout: 10 * 60 * 1000,
+        }).fetch('GET', downloadUrl, {
+            'X-Deployment-Key': deploymentKey,
+            ...(deviceAbi ? { 'X-Device-Abi': deviceAbi } : {}),
         });
-    }
-    try {
-        const response = await task;
-        if (onProgress) {
-            onProgress(1);
-        }
-        const downloadedPath = String(response.path()).replace(/^file:\/\//, '');
-        if (downloadedPath !== destPath) {
-            await ReactNativeBlobUtil.fs.cp(downloadedPath, destPath);
+        const reportDownloadProgress = (received, total) => {
+            if (!onProgress)
+                return;
+            const resolvedTotal = total > 0 ? total : totalBytes;
+            if (resolvedTotal <= 0)
+                return;
+            onProgress(Math.min(Math.max(received / resolvedTotal, 0), 0.99));
+        };
+        let pollTimer = null;
+        if (onProgress && totalBytes > 0) {
+            pollTimer = setInterval(async () => {
+                try {
+                    const exists = await ReactNativeBlobUtil.fs.exists(destPath);
+                    if (!exists)
+                        return;
+                    const stat = await ReactNativeBlobUtil.fs.stat(destPath);
+                    reportDownloadProgress(stat.size, totalBytes);
+                }
+                catch {
+                    // Ignore polling errors while the file is being written.
+                }
+            }, 150);
         }
-        const stat = await ReactNativeBlobUtil.fs.stat(destPath);
-        const minSize = extension === 'apk' ? 1024 * 100 : 1024;
-        if (!stat || stat.size < minSize) {
-            throw new Error(`Downloaded file is too small (${stat?.size ?? 0} bytes)`);
+        if (onProgress) {
+            task.progress({ interval: 100, count: 10 }, (received, total) => {
+                reportDownloadProgress(received, total);
+            });
         }
-        if (expectedHash) {
-            const valid = await verifyBundleHash(destPath, expectedHash);
-            if (!valid) {
-                throw new Error('Package hash verification failed');
+        try {
+            const response = await task;
+            if (onProgress) {
+                onProgress(1);
+            }
+            const downloadedPath = String(response.path()).replace(/^file:\/\//, '');
+            if (downloadedPath !== destPath) {
+                await ReactNativeBlobUtil.fs.cp(downloadedPath, destPath);
             }
+            const stat = await ReactNativeBlobUtil.fs.stat(destPath);
+            const minSize = extension === 'apk' ? 1024 * 100 : 1024;
+            if (!stat || stat.size < minSize) {
+                throw new Error(`Downloaded file is too small (${stat?.size ?? 0} bytes)`);
+            }
+            if (expectedHash) {
+                const valid = await verifyBundleHash(destPath, expectedHash);
+                if (!valid) {
+                    throw new Error('Package hash verification failed');
+                }
+            }
+            if (extension === 'bundle' && (await shouldExtractZipPackage(destPath, packageFormat))) {
+                return extractBundleUpdate(label, destPath);
+            }
+            return destPath;
         }
-        if (extension === 'bundle' && (await shouldExtractZipPackage(destPath, packageFormat))) {
-            return extractBundleUpdate(label, destPath);
+        catch (error) {
+            lastError = error;
+            if (isRetryableDownloadError(error)) {
+                const recovered = await tryRecoverCompletedDownload(destPath, extension, totalBytes, expectedHash, packageFormat, label);
+                if (recovered) {
+                    if (onProgress)
+                        onProgress(1);
+                    return recovered;
+                }
+            }
+            await cleanupPartialDownload(destPath);
+            if (attempt < DOWNLOAD_MAX_ATTEMPTS && isRetryableDownloadError(error)) {
+                await delay(attempt * 750);
+                continue;
+            }
+            throw toUserFacingDownloadError(error);
         }
-        return destPath;
-    }
-    finally {
-        if (pollTimer) {
-            clearInterval(pollTimer);
+        finally {
+            if (pollTimer) {
+                clearInterval(pollTimer);
+            }
         }
     }
+    throw toUserFacingDownloadError(lastError);
 }
 async function verifyBundleHash(filePath, expectedHash) {
     const ReactNativeBlobUtil = require('react-native-blob-util').default;
@@ -503,24 +670,51 @@ function reportProgress(showUI, messages, onProgress, status, progress = 0, extr
     onProgress?.(status, progress);
     if (!showUI)
         return;
-    // Silent phases — never show modal for check / install / up-to-date.
+    // Silent phases — never show modal for check / install / ignored / up-to-date.
     if (status === types_1.SyncStatus.CHECKING ||
         status === types_1.SyncStatus.UP_TO_DATE ||
         status === types_1.SyncStatus.UPDATE_IGNORED ||
-        status === types_1.SyncStatus.INSTALLING) {
+        status === types_1.SyncStatus.INSTALLING ||
+        status === types_1.SyncStatus.APK_INSTALL_PENDING) {
         return;
     }
     if (status === types_1.SyncStatus.ERROR) {
         showProgress(status, progress, extra?.error ?? getMessageForStatus(status, messages), {
             error: extra?.error,
+            showActions: true,
+            canSkip: false,
             ...extra,
         });
         return;
     }
     if (shouldShowModalForStatus(status)) {
-        showProgress(status, progress, getMessageForStatus(status, messages), extra);
+        showProgress(status, progress, extra?.message ?? getMessageForStatus(status, messages), {
+            showActions: false,
+            canSkip: false,
+            ...extra,
+        });
     }
 }
+async function promptForUpdate(showUI, messages, onProgress, update, installMode) {
+    const changelog = getUpdateChangelog(update);
+    const isMandatory = update.isMandatory === true;
+    if (!showUI) {
+        return 'update';
+    }
+    reportProgress(showUI, messages, onProgress, types_1.SyncStatus.UPDATE_AVAILABLE, 0, {
+        label: update.label,
+        description: changelog,
+        isMandatory,
+        installMode,
+        showActions: true,
+        canSkip: !isMandatory,
+    });
+    const action = await waitForUpdatePrompt();
+    if (action === 'skip' && !isMandatory) {
+        return 'skip';
+    }
+    return 'update';
+}
 async function restartApp() {
     if (OTAUpdaterNative?.restartApp) {
         await OTAUpdaterNative.restartApp();
@@ -590,16 +784,51 @@ async function performSync(options = {}, onProgress, messages) {
             onProgress?.(types_1.SyncStatus.UP_TO_DATE, 1);
             return { status: types_1.SyncStatus.UP_TO_DATE };
         }
+        const installMode = resolveInstallMode(options.installMode ?? config.installMode ?? 'immediate');
+        const changelog = getUpdateChangelog(update);
+        if (!update.isMandatory) {
+            const skipped = await getSkippedUpdateLabel();
+            if (skipped && skipped === update.label) {
+                if (showUI)
+                    hideProgress();
+                onProgress?.(types_1.SyncStatus.UPDATE_IGNORED, 1);
+                return {
+                    status: types_1.SyncStatus.UPDATE_IGNORED,
+                    label: update.label,
+                    description: changelog,
+                };
+            }
+        }
+        else {
+            await clearSkippedUpdate();
+        }
+        const decision = await promptForUpdate(showUI, messages, onProgress, update, installMode);
+        if (decision === 'skip') {
+            await markUpdateSkipped(update.label);
+            if (showUI)
+                hideProgress();
+            onProgress?.(types_1.SyncStatus.UPDATE_IGNORED, 1);
+            return {
+                status: types_1.SyncStatus.UPDATE_IGNORED,
+                label: update.label,
+                description: changelog,
+            };
+        }
+        await clearSkippedUpdate();
         if (update.updateType === 'apk') {
-            return performApkSync(update, showUI, messages, onProgress);
+            return performApkSync(update, showUI, messages, onProgress, changelog);
         }
         reportProgress(showUI, messages, onProgress, types_1.SyncStatus.DOWNLOADING, 0, {
             label: update.label,
-            description: update.description,
+            description: changelog,
+            isMandatory: update.isMandatory,
+            installMode,
         });
         const bundlePath = await downloadBundle(update.downloadUrl, config.deploymentKey, update.label, update.size, (p) => reportProgress(showUI, messages, onProgress, types_1.SyncStatus.DOWNLOADING, p, {
             label: update.label,
-            description: update.description,
+            description: changelog,
+            isMandatory: update.isMandatory,
+            installMode,
         }), 'bundle', undefined, update.packageFormat ?? 'bundle', update.packageHash);
         onProgress?.(types_1.SyncStatus.INSTALLING, 1);
         const ReactNativeBlobUtil = require('react-native-blob-util').default;
@@ -615,12 +844,14 @@ async function performSync(options = {}, onProgress, messages) {
             packageHash: update.packageHash,
             installedAt: new Date().toISOString(),
         });
-        const installMode = options.installMode ?? config.installMode ?? 'immediate';
+        await cleanupOldUpdates(update.label);
         const shouldRestartNow = installMode === 'immediate' || update.isMandatory === true;
         if (shouldRestartNow) {
             reportProgress(showUI, messages, onProgress, types_1.SyncStatus.RESTARTING, 1, {
                 label: update.label,
-                description: update.description,
+                description: changelog,
+                isMandatory: update.isMandatory,
+                installMode,
             });
             await markRestartPending();
             await delay(300);
@@ -628,46 +859,62 @@ async function performSync(options = {}, onProgress, messages) {
             return {
                 status: types_1.SyncStatus.UPDATE_INSTALLED,
                 label: update.label,
-                description: update.description,
+                description: changelog,
             };
         }
-        if (showUI)
+        if (showUI) {
+            reportProgress(showUI, messages, onProgress, types_1.SyncStatus.UPDATE_INSTALLED, 1, {
+                label: update.label,
+                description: changelog,
+                isMandatory: update.isMandatory,
+                installMode,
+                showActions: true,
+                canSkip: false,
+                message: getMessageForStatus(types_1.SyncStatus.UPDATE_INSTALLED, messages),
+            });
+            await waitForUpdatePrompt();
             hideProgress();
+        }
         return {
             status: types_1.SyncStatus.UPDATE_INSTALLED,
             label: update.label,
-            description: update.description,
+            description: changelog,
         };
     }
     catch (error) {
         const err = error instanceof Error ? error : new Error(String(error));
         reportProgress(showUI, messages, onProgress, types_1.SyncStatus.ERROR, 0, {
             error: err.message,
+            showActions: true,
+            canSkip: false,
         });
+        if (showUI) {
+            await waitForUpdatePrompt();
+            hideProgress();
+        }
         return {
             status: types_1.SyncStatus.ERROR,
             error: err,
         };
     }
 }
-async function performApkSync(update, showUI, messages, onProgress) {
+async function performApkSync(update, showUI, messages, onProgress, changelog) {
     if (!update.downloadUrl || !update.label || !update.packageHash) {
         return { status: types_1.SyncStatus.UP_TO_DATE };
     }
+    const notes = changelog ?? getUpdateChangelog(update);
     try {
         reportProgress(showUI, messages, onProgress, types_1.SyncStatus.DOWNLOADING, 0, {
             label: update.label,
-            description: update.description,
+            description: notes,
+            isMandatory: update.isMandatory,
         });
         const apkPath = await downloadBundle(update.downloadUrl, (0, config_1.getConfig)().deploymentKey, update.label, update.size, (p) => reportProgress(showUI, messages, onProgress, types_1.SyncStatus.DOWNLOADING, p, {
             label: update.label,
-            description: update.description,
-        }), 'apk', update.deviceAbi);
+            description: notes,
+            isMandatory: update.isMandatory,
+        }), 'apk', update.deviceAbi, 'bundle', update.packageHash);
         onProgress?.(types_1.SyncStatus.INSTALLING, 1);
-        const valid = await verifyBundleHash(apkPath, update.packageHash);
-        if (!valid) {
-            throw new Error('APK hash verification failed');
-        }
         // Drop the OTA JS path before opening the installer so the new APK does not
         // keep loading the previous bundle on first launch after install.
         await clearUpdate();
@@ -675,12 +922,13 @@ async function performApkSync(update, showUI, messages, onProgress) {
         if (installResult === 'permission_required') {
             reportProgress(showUI, messages, onProgress, types_1.SyncStatus.INSTALLING, 1, {
                 label: update.label,
-                description: update.description,
+                description: notes,
+                isMandatory: update.isMandatory,
             });
             return {
                 status: types_1.SyncStatus.APK_INSTALL_PENDING,
                 label: update.label,
-                description: update.description,
+                description: notes,
             };
         }
         if (showUI)
@@ -689,14 +937,20 @@ async function performApkSync(update, showUI, messages, onProgress) {
         return {
             status: types_1.SyncStatus.APK_INSTALL_PENDING,
             label: update.label,
-            description: update.description,
+            description: notes,
         };
     }
     catch (error) {
         const err = error instanceof Error ? error : new Error(String(error));
         reportProgress(showUI, messages, onProgress, types_1.SyncStatus.ERROR, 0, {
             error: err.message,
+            showActions: true,
+            canSkip: false,
         });
+        if (showUI) {
+            await waitForUpdatePrompt();
+            hideProgress();
+        }
         return {
             status: types_1.SyncStatus.ERROR,
             error: err,
@@ -717,10 +971,16 @@ async function getInstalledBundlePath() {
     return null;
 }
 async function clearUpdate() {
+    const meta = await getStoredBundleMeta();
     await clearStoredBundleMeta();
     if (OTAUpdaterNative?.clearBundlePath) {
         await OTAUpdaterNative.clearBundlePath();
     }
+    if (meta?.label) {
+        await removePathRecursive(getBundleReleaseDir(meta.label));
+        await cleanupPartialDownload(getBundleZipPath(meta.label));
+        await cleanupPartialDownload(getLegacyBundleFilePath(meta.label));
+    }
 }
 async function notifyAppReady() {
     const meta = await getStoredBundleMeta();

package/lib/types.d.ts

@@ -1,9 +1,15 @@
 import type { ReactNode } from 'react';
+/** When to apply a downloaded JS bundle update. */
+export type InstallMode = 'immediate' | 'next-launch'
+/** @deprecated use `next-launch` */
+ | 'on-next-restart'
+/** @deprecated use `next-launch` */
+ | 'on-next-resume';
 export interface ProjectOtaConfig {
     /** Optional — defaults to https://appsonair.ir */
     serverUrl?: string;
     entryFile?: string;
-    installMode?: OTAUpdaterConfig['installMode'];
+    installMode?: InstallMode;
     deployments: {
         staging: string;
         production: string;
@@ -14,8 +20,12 @@ export interface OTAUpdaterConfig {
     serverUrl?: string;
     /** Deployment key from the OTA server (Staging or Production) */
     deploymentKey: string;
-    /** When to apply downloaded updates (default: immediate) */
-    installMode?: 'immediate' | 'on-next-restart' | 'on-next-resume';
+    /**
+     * When to apply downloaded JS updates (default: immediate).
+     * - immediate: restart right after install
+     * - next-launch: install now, take effect on next app start
+     */
+    installMode?: InstallMode;
     /** Check interval in milliseconds when using auto-check (default: disabled) */
     checkFrequency?: number;
     /** Show built-in progress popup during sync (default: false, enabled by OTAUpdateProvider) */
@@ -31,6 +41,14 @@ export interface OTAProgressMessages {
     restarting?: string;
     error?: string;
     upToDate?: string;
+    /** Prompt when an update is available */
+    updateAvailable?: string;
+    changelogTitle?: string;
+    updateNow?: string;
+    skip?: string;
+    dismiss?: string;
+    appliedNextLaunch?: string;
+    mandatoryHint?: string;
 }
 export interface OTAUpdateProviderProps {
     children: ReactNode;
@@ -55,6 +73,8 @@ export interface UpdateCheckResult {
     targetAppVersion?: string;
     downloadUrl?: string;
     label?: string;
+    /** Release notes / changelog (alias of description) */
+    changelog?: string;
     description?: string;
     isMandatory?: boolean;
     appVersion?: string;
@@ -66,7 +86,7 @@ export interface UpdateCheckResult {
 }
 export interface SyncOptions {
     /** When to apply the update (default: immediate, or value from configure()) */
-    installMode?: 'immediate' | 'on-next-restart' | 'on-next-resume';
+    installMode?: InstallMode;
     /** Minimum background duration before checking on resume (ms) */
     minimumBackgroundDuration?: number;
     /** Show built-in progress popup (default: from configure() or false) */
@@ -76,6 +96,7 @@ export interface SyncOptions {
 }
 export declare enum SyncStatus {
     UP_TO_DATE = "UP_TO_DATE",
+    UPDATE_AVAILABLE = "UPDATE_AVAILABLE",
     UPDATE_INSTALLED = "UPDATE_INSTALLED",
     UPDATE_IGNORED = "UPDATE_IGNORED",
     APK_INSTALL_PENDING = "APK_INSTALL_PENDING",

package/lib/types.js

@@ -4,6 +4,7 @@ exports.SyncStatus = void 0;
 var SyncStatus;
 (function (SyncStatus) {
     SyncStatus["UP_TO_DATE"] = "UP_TO_DATE";
+    SyncStatus["UPDATE_AVAILABLE"] = "UPDATE_AVAILABLE";
     SyncStatus["UPDATE_INSTALLED"] = "UPDATE_INSTALLED";
     SyncStatus["UPDATE_IGNORED"] = "UPDATE_IGNORED";
     SyncStatus["APK_INSTALL_PENDING"] = "APK_INSTALL_PENDING";

package/lib/ui/OTAUpdateModal.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
-import { OTAProgressState } from '../progress';
+import { defaultMessages, OTAProgressState } from '../sync';
 interface OTAUpdateModalProps extends OTAProgressState {
     title?: string;
     fontFamily?: string;
+    messages?: Partial<typeof defaultMessages>;
 }
-export declare function OTAUpdateModal({ visible, status, progress, message, description, error, title, fontFamily, }: OTAUpdateModalProps): React.JSX.Element;
+export declare function OTAUpdateModal({ visible, status, progress, message, description, isMandatory, error, showActions, canSkip, title, fontFamily, messages, }: OTAUpdateModalProps): React.JSX.Element;
 export {};

package/lib/ui/OTAUpdateModal.js

@@ -36,9 +36,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OTAUpdateModal = OTAUpdateModal;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
-const progress_1 = require("../progress");
+const sync_1 = require("../sync");
 const types_1 = require("../types");
-function OTAUpdateModal({ visible, status, progress, message, description, error, title = progress_1.defaultMessages.title, fontFamily, }) {
+function OTAUpdateModal({ visible, status, progress, message, description, isMandatory, error, showActions, canSkip, title = sync_1.defaultMessages.title, fontFamily, messages, }) {
+    const copy = (0, react_1.useMemo)(() => ({ ...sync_1.defaultMessages, ...messages }), [messages]);
     const customFontStyle = (0, react_1.useMemo)(() => fontFamily
         ? {
             fontFamily,
@@ -52,23 +53,74 @@ function OTAUpdateModal({ visible, status, progress, message, description, error
     if (!visible)
         return null;
     const progressPercent = Math.round(Math.min(Math.max(progress, 0), 1) * 100);
+    const isPrompt = status === types_1.SyncStatus.UPDATE_AVAILABLE;
+    const isDeferredDone = status === types_1.SyncStatus.UPDATE_INSTALLED;
+    const isError = status === types_1.SyncStatus.ERROR;
     const showProgressBar = status === types_1.SyncStatus.DOWNLOADING;
-    return (<react_native_1.Modal visible transparent animationType="fade" statusBarTranslucent>
+    const showSpinner = status === types_1.SyncStatus.RESTARTING ||
+        status === types_1.SyncStatus.INSTALLING ||
+        (!showProgressBar && !isPrompt && !isDeferredDone && !isError);
+    return (<react_native_1.Modal visible transparent animationType="fade" statusBarTranslucent onRequestClose={() => {
+            if (canSkip)
+                (0, sync_1.respondToUpdatePrompt)('skip');
+            else if (showActions && (isDeferredDone || isError)) {
+                (0, sync_1.respondToUpdatePrompt)('dismiss');
+            }
+        }}>
       <react_native_1.View style={styles.overlay}>
         <react_native_1.View style={styles.card}>
           <react_native_1.Text style={[styles.title, !fontFamily && styles.titleBold, textStyle]}>
             {title}
           </react_native_1.Text>
+
           <react_native_1.Text style={[styles.message, textStyle]}>{error ?? message}</react_native_1.Text>
-          {description && !error ? (<react_native_1.Text style={[styles.description, textStyle]}>{description}</react_native_1.Text>) : null}
 
-          {showProgressBar ? (<react_native_1.View style={styles.progressTrack}>
-              <react_native_1.View style={[styles.progressFill, { width: `${progressPercent}%` }]}/>
-            </react_native_1.View>) : (<react_native_1.ActivityIndicator size="large" color="#2563eb" style={styles.spinner}/>)}
+          {isMandatory && isPrompt ? (<react_native_1.Text style={[styles.mandatory, textStyle]}>{copy.mandatoryHint}</react_native_1.Text>) : null}
+
+          {description && !error ? (<react_native_1.View style={styles.changelogBox}>
+              <react_native_1.Text style={[styles.changelogTitle, !fontFamily && styles.titleBold, textStyle]}>
+                {copy.changelogTitle}
+              </react_native_1.Text>
+              <react_native_1.ScrollView style={styles.changelogScroll} contentContainerStyle={styles.changelogContent} nestedScrollEnabled>
+                <react_native_1.Text style={[styles.description, textStyle]}>{description}</react_native_1.Text>
+              </react_native_1.ScrollView>
+            </react_native_1.View>) : null}
+
+          {showProgressBar ? (<>
+              <react_native_1.View style={styles.progressTrack}>
+                <react_native_1.View style={[styles.progressFill, { width: `${progressPercent}%` }]}/>
+              </react_native_1.View>
+              <react_native_1.Text style={[styles.percent, !fontFamily && styles.percentBold, textStyle]}>
+                {progressPercent}٪
+              </react_native_1.Text>
+            </>) : null}
+
+          {showSpinner ? (<react_native_1.ActivityIndicator size="large" color="#2563eb" style={styles.spinner}/>) : null}
 
-          {showProgressBar ? (<react_native_1.Text style={[styles.percent, !fontFamily && styles.percentBold, textStyle]}>
-              {progressPercent}٪
-            </react_native_1.Text>) : null}
+          {showActions ? (<react_native_1.View style={styles.actions}>
+              {isPrompt ? (<>
+                  <react_native_1.Pressable style={[styles.button, styles.buttonPrimary]} onPress={() => (0, sync_1.respondToUpdatePrompt)('update')}>
+                    <react_native_1.Text style={[
+                    styles.buttonPrimaryText,
+                    !fontFamily && styles.titleBold,
+                    textStyle,
+                ]}>
+                      {copy.updateNow}
+                    </react_native_1.Text>
+                  </react_native_1.Pressable>
+                  {canSkip ? (<react_native_1.Pressable style={[styles.button, styles.buttonGhost]} onPress={() => (0, sync_1.respondToUpdatePrompt)('skip')}>
+                      <react_native_1.Text style={[styles.buttonGhostText, textStyle]}>{copy.skip}</react_native_1.Text>
+                    </react_native_1.Pressable>) : null}
+                </>) : (<react_native_1.Pressable style={[styles.button, styles.buttonPrimary]} onPress={() => (0, sync_1.respondToUpdatePrompt)('dismiss')}>
+                  <react_native_1.Text style={[
+                    styles.buttonPrimaryText,
+                    !fontFamily && styles.titleBold,
+                    textStyle,
+                ]}>
+                    {copy.dismiss}
+                  </react_native_1.Text>
+                </react_native_1.Pressable>)}
+            </react_native_1.View>) : null}
         </react_native_1.View>
       </react_native_1.View>
     </react_native_1.Modal>);
@@ -83,11 +135,11 @@ const styles = react_native_1.StyleSheet.create({
     },
     card: {
         width: '100%',
-        maxWidth: 320,
+        maxWidth: 340,
         backgroundColor: '#fff',
         borderRadius: 16,
         padding: 24,
-        alignItems: 'center',
+        alignItems: 'stretch',
     },
     title: {
         fontSize: 18,
@@ -104,11 +156,38 @@ const styles = react_native_1.StyleSheet.create({
         textAlign: 'center',
         marginBottom: 8,
     },
+    mandatory: {
+        fontSize: 13,
+        color: '#b45309',
+        textAlign: 'center',
+        marginBottom: 8,
+    },
+    changelogBox: {
+        width: '100%',
+        marginTop: 4,
+        marginBottom: 12,
+        backgroundColor: '#f9fafb',
+        borderRadius: 12,
+        padding: 12,
+        maxHeight: 180,
+    },
+    changelogTitle: {
+        fontSize: 13,
+        color: '#111827',
+        marginBottom: 6,
+        textAlign: 'center',
+    },
+    changelogScroll: {
+        maxHeight: 140,
+    },
+    changelogContent: {
+        paddingBottom: 4,
+    },
     description: {
         fontSize: 13,
-        color: '#6b7280',
+        color: '#4b5563',
         textAlign: 'center',
-        marginBottom: 16,
+        lineHeight: 20,
     },
     progressTrack: {
         width: '100%',
@@ -134,5 +213,30 @@ const styles = react_native_1.StyleSheet.create({
     },
     spinner: {
         marginTop: 12,
+        alignSelf: 'center',
+    },
+    actions: {
+        marginTop: 16,
+        gap: 8,
+    },
+    button: {
+        borderRadius: 10,
+        paddingVertical: 12,
+        paddingHorizontal: 16,
+        alignItems: 'center',
+    },
+    buttonPrimary: {
+        backgroundColor: '#2563eb',
+    },
+    buttonPrimaryText: {
+        color: '#fff',
+        fontSize: 15,
+    },
+    buttonGhost: {
+        backgroundColor: 'transparent',
+    },
+    buttonGhostText: {
+        color: '#6b7280',
+        fontSize: 14,
     },
 });

package/lib/ui/OTAUpdateProvider.js

@@ -97,6 +97,6 @@ function OTAUpdateProvider({ children, projectConfig, autoSync = true, skipInDev
     }, []);
     return (<>
       {children}
-      <OTAUpdateModal_1.OTAUpdateModal {...progress} title={modalTitle} fontFamily={fontFamily}/>
+      <OTAUpdateModal_1.OTAUpdateModal {...progress} title={modalTitle} fontFamily={fontFamily} messages={messages}/>
     </>);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsonair.ir/react-native",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "React Native client SDK for self-hosted OTA updates",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",