@appsonair.ir/react-native 1.0.1 → 1.0.2

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;
@@ -20,10 +26,20 @@ export declare const defaultMessages: {
     restarting: string;
     error: 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 = {
@@ -73,18 +76,29 @@ exports.defaultMessages = {
     restarting: 'در حال راه\u200cاندازی مجدد...',
     error: 'خطا در به\u200cروزرسانی',
     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 +138,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)
@@ -503,23 +551,50 @@ 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) {
@@ -590,16 +665,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 +725,13 @@ async function performSync(options = {}, onProgress, messages) {
             packageHash: update.packageHash,
             installedAt: new Date().toISOString(),
         });
-        const installMode = options.installMode ?? config.installMode ?? 'immediate';
         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,40 +739,60 @@ 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,
+            description: notes,
+            isMandatory: update.isMandatory,
         }), 'apk', update.deviceAbi);
         onProgress?.(types_1.SyncStatus.INSTALLING, 1);
         const valid = await verifyBundleHash(apkPath, update.packageHash);
@@ -675,12 +806,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 +821,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,

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.2",
   "description": "React Native client SDK for self-hosted OTA updates",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",