@appsonair.ir/react-native 1.0.0

package/lib/types.d.ts

@@ -0,0 +1,97 @@
+import type { ReactNode } from 'react';
+export interface ProjectOtaConfig {
+    serverUrl: string;
+    entryFile?: string;
+    installMode?: OTAUpdaterConfig['installMode'];
+    deployments: {
+        staging: string;
+        production: string;
+    };
+}
+export interface OTAUpdaterConfig {
+    /** Base URL of your OTA server, e.g. https://ota.example.com */
+    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';
+    /** Check interval in milliseconds when using auto-check (default: disabled) */
+    checkFrequency?: number;
+    /** Show built-in progress popup during sync (default: false, enabled by OTAUpdateProvider) */
+    showProgressUI?: boolean;
+    /** Check for and offer native APK updates on Android (default: true) */
+    enableApkUpdates?: boolean;
+}
+export interface OTAProgressMessages {
+    title?: string;
+    checking?: string;
+    downloading?: string;
+    installing?: string;
+    restarting?: string;
+    error?: string;
+    upToDate?: string;
+}
+export interface OTAUpdateProviderProps {
+    children: ReactNode;
+    /** Project config from ota-updater.config.ts — auto-configures the SDK on mount */
+    projectConfig?: ProjectOtaConfig;
+    /** Automatically check and install updates on mount (default: true) */
+    autoSync?: boolean;
+    /** Skip auto sync in dev mode (default: true) */
+    skipInDev?: boolean;
+    /** Custom status messages */
+    messages?: OTAProgressMessages;
+    /** Modal title font (must be linked in the host app, e.g. Shabnam-FD) */
+    fontFamily?: string;
+    /** Passed to sync() */
+    syncOptions?: SyncOptions;
+}
+export interface UpdateCheckResult {
+    updateAvailable: boolean;
+    updateType?: 'bundle' | 'apk';
+    reason?: 'NATIVE_VERSION_MISMATCH' | 'ALREADY_INSTALLED' | 'ROLLOUT';
+    clientAppVersion?: string;
+    targetAppVersion?: string;
+    downloadUrl?: string;
+    label?: string;
+    description?: string;
+    isMandatory?: boolean;
+    appVersion?: string;
+    packageHash?: string;
+    buildNumber?: number;
+    deviceAbi?: string;
+    packageFormat?: 'bundle' | 'zip';
+    size?: number;
+}
+export interface SyncOptions {
+    /** When to apply the update (default: immediate, or value from configure()) */
+    installMode?: 'immediate' | 'on-next-restart' | 'on-next-resume';
+    /** Minimum background duration before checking on resume (ms) */
+    minimumBackgroundDuration?: number;
+    /** Show built-in progress popup (default: from configure() or false) */
+    showProgressUI?: boolean;
+    /** Check for native APK updates on Android (default: from configure() or true) */
+    enableApkUpdates?: boolean;
+}
+export declare enum SyncStatus {
+    UP_TO_DATE = "UP_TO_DATE",
+    UPDATE_INSTALLED = "UPDATE_INSTALLED",
+    UPDATE_IGNORED = "UPDATE_IGNORED",
+    APK_INSTALL_PENDING = "APK_INSTALL_PENDING",
+    ERROR = "ERROR",
+    CHECKING = "CHECKING",
+    DOWNLOADING = "DOWNLOADING",
+    INSTALLING = "INSTALLING",
+    RESTARTING = "RESTARTING"
+}
+export interface SyncResult {
+    status: SyncStatus;
+    label?: string;
+    description?: string;
+    error?: Error;
+}
+export interface StoredBundleMeta {
+    label: string;
+    packageHash: string;
+    installedAt: string;
+}

package/lib/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncStatus = void 0;
+var SyncStatus;
+(function (SyncStatus) {
+    SyncStatus["UP_TO_DATE"] = "UP_TO_DATE";
+    SyncStatus["UPDATE_INSTALLED"] = "UPDATE_INSTALLED";
+    SyncStatus["UPDATE_IGNORED"] = "UPDATE_IGNORED";
+    SyncStatus["APK_INSTALL_PENDING"] = "APK_INSTALL_PENDING";
+    SyncStatus["ERROR"] = "ERROR";
+    SyncStatus["CHECKING"] = "CHECKING";
+    SyncStatus["DOWNLOADING"] = "DOWNLOADING";
+    SyncStatus["INSTALLING"] = "INSTALLING";
+    SyncStatus["RESTARTING"] = "RESTARTING";
+})(SyncStatus || (exports.SyncStatus = SyncStatus = {}));

package/lib/ui/OTAUpdateModal.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { OTAProgressState } from '../progress';
+interface OTAUpdateModalProps extends OTAProgressState {
+    title?: string;
+    fontFamily?: string;
+}
+export declare function OTAUpdateModal({ visible, status, progress, message, description, error, title, fontFamily, }: OTAUpdateModalProps): React.JSX.Element;
+export {};

package/lib/ui/OTAUpdateModal.js

@@ -0,0 +1,138 @@
+"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.OTAUpdateModal = OTAUpdateModal;
+const react_1 = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const progress_1 = require("../progress");
+const types_1 = require("../types");
+function OTAUpdateModal({ visible, status, progress, message, description, error, title = progress_1.defaultMessages.title, fontFamily, }) {
+    const customFontStyle = (0, react_1.useMemo)(() => fontFamily
+        ? {
+            fontFamily,
+            fontWeight: 'normal',
+        }
+        : null, [fontFamily]);
+    const textStyle = (0, react_1.useMemo)(() => ({
+        ...(customFontStyle ?? null),
+        writingDirection: 'rtl',
+    }), [customFontStyle]);
+    if (!visible)
+        return null;
+    const progressPercent = Math.round(Math.min(Math.max(progress, 0), 1) * 100);
+    const showProgressBar = status === types_1.SyncStatus.DOWNLOADING;
+    return (<react_native_1.Modal visible transparent animationType="fade" statusBarTranslucent>
+      <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}/>)}
+
+          {showProgressBar ? (<react_native_1.Text style={[styles.percent, !fontFamily && styles.percentBold, textStyle]}>
+              {progressPercent}٪
+            </react_native_1.Text>) : null}
+        </react_native_1.View>
+      </react_native_1.View>
+    </react_native_1.Modal>);
+}
+const styles = react_native_1.StyleSheet.create({
+    overlay: {
+        flex: 1,
+        backgroundColor: 'rgba(0, 0, 0, 0.55)',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: 24,
+    },
+    card: {
+        width: '100%',
+        maxWidth: 320,
+        backgroundColor: '#fff',
+        borderRadius: 16,
+        padding: 24,
+        alignItems: 'center',
+    },
+    title: {
+        fontSize: 18,
+        color: '#111827',
+        marginBottom: 8,
+        textAlign: 'center',
+    },
+    titleBold: {
+        fontWeight: '700',
+    },
+    message: {
+        fontSize: 15,
+        color: '#374151',
+        textAlign: 'center',
+        marginBottom: 8,
+    },
+    description: {
+        fontSize: 13,
+        color: '#6b7280',
+        textAlign: 'center',
+        marginBottom: 16,
+    },
+    progressTrack: {
+        width: '100%',
+        height: 8,
+        backgroundColor: '#e5e7eb',
+        borderRadius: 999,
+        overflow: 'hidden',
+        marginTop: 8,
+    },
+    progressFill: {
+        height: '100%',
+        backgroundColor: '#2563eb',
+        borderRadius: 999,
+    },
+    percent: {
+        marginTop: 8,
+        fontSize: 13,
+        color: '#6b7280',
+        textAlign: 'center',
+    },
+    percentBold: {
+        fontWeight: '600',
+    },
+    spinner: {
+        marginTop: 12,
+    },
+});

package/lib/ui/OTAUpdateProvider.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { OTAUpdateProviderProps } from '../types';
+export declare function OTAUpdateProvider({ children, projectConfig, autoSync, skipInDev, messages, fontFamily, syncOptions, }: OTAUpdateProviderProps): React.JSX.Element;

package/lib/ui/OTAUpdateProvider.js

@@ -0,0 +1,102 @@
+"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.OTAUpdateProvider = OTAUpdateProvider;
+const react_1 = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const projectConfig_1 = require("../projectConfig");
+const progress_1 = require("../progress");
+const sync_1 = require("../sync");
+const OTAUpdateModal_1 = require("./OTAUpdateModal");
+const SYNC_DELAY_MS = 2500;
+const FOREGROUND_SYNC_DEBOUNCE_MS = 30000;
+function OTAUpdateProvider({ children, projectConfig, autoSync = true, skipInDev = true, messages, fontFamily, syncOptions, }) {
+    const [progress, setProgress] = (0, react_1.useState)((0, progress_1.getProgressState)());
+    const lastSyncAtRef = (0, react_1.useRef)(0);
+    const foregroundTimerRef = (0, react_1.useRef)(null);
+    const hasMountedSyncRef = (0, react_1.useRef)(false);
+    const modalTitle = (0, progress_1.getModalTitle)(messages);
+    (0, react_1.useEffect)(() => {
+        if (projectConfig) {
+            (0, projectConfig_1.configureFromProject)(projectConfig);
+        }
+    }, [projectConfig]);
+    (0, react_1.useEffect)(() => (0, progress_1.subscribeProgress)(setProgress), []);
+    (0, react_1.useEffect)(() => {
+        if (!autoSync)
+            return;
+        if (skipInDev && __DEV__)
+            return;
+        const runSync = () => {
+            if ((0, sync_1.isSyncInProgress)())
+                return;
+            lastSyncAtRef.current = Date.now();
+            (0, sync_1.sync)({ ...syncOptions, showProgressUI: true }, undefined, messages);
+        };
+        const mountTimer = setTimeout(() => {
+            hasMountedSyncRef.current = true;
+            runSync();
+        }, SYNC_DELAY_MS);
+        const onAppStateChange = (nextState) => {
+            if (nextState !== 'active')
+                return;
+            if (!hasMountedSyncRef.current)
+                return;
+            (0, sync_1.resumePendingApkInstall)().catch(() => {
+                // Native module may be unavailable on iOS — ignore.
+            });
+            const elapsed = Date.now() - lastSyncAtRef.current;
+            if (elapsed < FOREGROUND_SYNC_DEBOUNCE_MS)
+                return;
+            if (foregroundTimerRef.current) {
+                clearTimeout(foregroundTimerRef.current);
+            }
+            foregroundTimerRef.current = setTimeout(runSync, SYNC_DELAY_MS);
+        };
+        const subscription = react_native_1.AppState.addEventListener('change', onAppStateChange);
+        return () => {
+            clearTimeout(mountTimer);
+            if (foregroundTimerRef.current) {
+                clearTimeout(foregroundTimerRef.current);
+            }
+            subscription.remove();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    return (<>
+      {children}
+      <OTAUpdateModal_1.OTAUpdateModal {...progress} title={modalTitle} fontFamily={fontFamily}/>
+    </>);
+}

package/lib/zipExtract.d.ts

@@ -0,0 +1 @@
+export declare function extractZipToDirectory(zipPath: string, destDir: string): Promise<void>;

package/lib/zipExtract.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractZipToDirectory = extractZipToDirectory;
+const react_native_1 = require("react-native");
+const fflate_1 = require("fflate");
+const { OTAUpdaterNative } = react_native_1.NativeModules;
+function normalizePath(path) {
+    return path.replace(/^file:\/\//, '');
+}
+function uint8ArrayToBase64(bytes) {
+    const ReactNativeBlobUtil = require('react-native-blob-util').default;
+    if (typeof ReactNativeBlobUtil.base64?.encode === 'function') {
+        let binary = '';
+        const chunkSize = 0x8000;
+        for (let i = 0; i < bytes.length; i += chunkSize) {
+            binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));
+        }
+        return ReactNativeBlobUtil.base64.encode(binary);
+    }
+    let binary = '';
+    const chunkSize = 0x8000;
+    for (let i = 0; i < bytes.length; i += chunkSize) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + chunkSize));
+    }
+    return globalThis.btoa(binary);
+}
+function base64ToUint8Array(base64) {
+    const ReactNativeBlobUtil = require('react-native-blob-util').default;
+    const binary = typeof ReactNativeBlobUtil.base64?.decode === 'function'
+        ? ReactNativeBlobUtil.base64.decode(base64)
+        : globalThis.atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+async function readFileAsBase64(path) {
+    const ReactNativeBlobUtil = require('react-native-blob-util').default;
+    const data = await ReactNativeBlobUtil.fs.readFile(path, 'base64');
+    if (typeof data === 'string') {
+        return data;
+    }
+    throw new Error(`readFile returned unexpected type: ${typeof data}`);
+}
+async function mkdirRecursive(dirPath) {
+    const ReactNativeBlobUtil = require('react-native-blob-util').default;
+    if (await ReactNativeBlobUtil.fs.exists(dirPath)) {
+        return;
+    }
+    const parent = dirPath.substring(0, dirPath.lastIndexOf('/'));
+    if (parent.length > 0) {
+        await mkdirRecursive(parent);
+    }
+    await ReactNativeBlobUtil.fs.mkdir(dirPath);
+}
+async function writeBinaryFile(outPath, content) {
+    const ReactNativeBlobUtil = require('react-native-blob-util').default;
+    const base64 = uint8ArrayToBase64(content);
+    const stream = await ReactNativeBlobUtil.fs.writeStream(outPath, 'base64', false);
+    await stream.write(base64);
+    await stream.close();
+}
+async function extractZipToDirectoryNative(zipPath, destDir) {
+    if (OTAUpdaterNative?.extractZipArchive) {
+        await OTAUpdaterNative.extractZipArchive(zipPath, destDir);
+        return true;
+    }
+    try {
+        const { unzip } = require('react-native-zip-archive');
+        if (typeof unzip === 'function') {
+            await unzip(zipPath, destDir);
+            return true;
+        }
+    }
+    catch {
+        // Optional peer dependency not installed.
+    }
+    return false;
+}
+async function extractZipToDirectoryJs(zipPath, destDir) {
+    const base64 = await readFileAsBase64(zipPath);
+    const entries = (0, fflate_1.unzipSync)(base64ToUint8Array(base64));
+    await mkdirRecursive(destDir);
+    for (const [relativePath, rawContent] of Object.entries(entries)) {
+        const normalized = relativePath.replace(/\\/g, '/');
+        if (normalized.endsWith('/')) {
+            await mkdirRecursive(`${destDir}/${normalized.slice(0, -1)}`);
+            continue;
+        }
+        const content = rawContent instanceof Uint8Array
+            ? rawContent
+            : new Uint8Array(rawContent);
+        const outPath = `${destDir}/${normalized}`;
+        const parent = outPath.substring(0, outPath.lastIndexOf('/'));
+        if (parent.length > 0) {
+            await mkdirRecursive(parent);
+        }
+        await writeBinaryFile(outPath, content);
+    }
+}
+async function extractZipToDirectory(zipPath, destDir) {
+    const normalizedZip = normalizePath(zipPath);
+    const normalizedDest = normalizePath(destDir);
+    const extractedNatively = await extractZipToDirectoryNative(normalizedZip, normalizedDest);
+    if (extractedNatively) {
+        return;
+    }
+    if (react_native_1.Platform.OS === 'android') {
+        throw new Error('OTA zip extraction requires rebuilding the Android app with the latest @appsonair.ir/react-native native module. Run: cd android && ./gradlew clean && cd .. && npx react-native run-android');
+    }
+    await extractZipToDirectoryJs(normalizedZip, normalizedDest);
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@appsonair.ir/react-native",
+  "version": "1.0.0",
+  "description": "React Native client SDK for self-hosted OTA updates",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "react-native": "lib/index.js",
+  "files": [
+    "lib",
+    "android",
+    "ios",
+    "react-native.config.js"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "yarn build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "fflate": "^0.8.2"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.17.0",
+    "react": ">=18.0.0",
+    "react-native": ">=0.71.0",
+    "react-native-blob-util": ">=0.19.0",
+    "react-native-device-info": ">=10.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-blob-util": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^2.1.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1",
+    "react-native": "^0.76.3",
+    "react-native-blob-util": "^0.21.2",
+    "react-native-device-info": "^14.0.1",
+    "typescript": "^5.7.2"
+  }
+}

package/react-native.config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        sourceDir: './android',
+        packageImportPath: 'import com.otaupdater.OTAUpdaterPackage;',
+        packageInstance: 'new OTAUpdaterPackage()',
+      },
+      ios: {},
+    },
+  },
+};