@otaupdate/react-native 1.0.0

package/lib/types.d.ts

@@ -0,0 +1,112 @@
+/** When a downloaded update actually replaces the running JS bundle. */
+export declare enum InstallMode {
+    /** Swap in on the next natural app start. Safest; the default. */
+    ON_NEXT_RESTART = 0,
+    /** Swap in the next time the app returns from the background. */
+    ON_NEXT_RESUME = 1,
+    /** Reload the JS bundle right now. Interrupts the user — use for mandatory fixes. */
+    IMMEDIATE = 2
+}
+/** Progress of a `sync()` call, reported through `onSyncStatusChange`. */
+export declare enum SyncStatus {
+    UP_TO_DATE = 0,
+    UPDATE_INSTALLED = 1,
+    UPDATE_IGNORED = 2,
+    UNKNOWN_ERROR = 3,
+    SYNC_IN_PROGRESS = 4,
+    CHECKING_FOR_UPDATE = 5,
+    AWAITING_USER_ACTION = 6,
+    DOWNLOADING_PACKAGE = 7,
+    INSTALLING_UPDATE = 8
+}
+export interface DownloadProgress {
+    totalBytes: number;
+    receivedBytes: number;
+}
+/** Metadata about an update that exists on the server but not yet on device. */
+export interface RemotePackage {
+    label: string;
+    packageHash: string;
+    downloadUrl: string;
+    size: number;
+    isMandatory: boolean;
+    description: string | null;
+    targetBinaryVersion: string;
+    rollout: number;
+    isRollback: boolean;
+    deployment: string;
+    /** Fetches and verifies the bundle, returning the on-device package. */
+    download(onProgress?: (progress: DownloadProgress) => void): Promise<LocalPackage>;
+}
+/** An update that has been downloaded and verified onto the device. */
+export interface LocalPackage {
+    label: string;
+    packageHash: string;
+    isMandatory: boolean;
+    description: string | null;
+    bundlePath: string;
+    size: number;
+    /** Applies the update according to `mode`. */
+    install(mode?: InstallMode, minimumBackgroundDuration?: number): Promise<void>;
+}
+/** The bundle currently running, if it came from an OTA update. */
+export interface CurrentPackage {
+    label: string | null;
+    packageHash: string | null;
+    description: string | null;
+    isMandatory: boolean;
+    bundlePath: string | null;
+    appVersion: string;
+    /** True until `notifyAppReady()` confirms this update booted successfully. */
+    isPending: boolean;
+    /** True on the first run after this update was applied. */
+    isFirstRun: boolean;
+}
+export type NoUpdateReason = 'up_to_date' | 'not_in_rollout' | 'no_matching_binary_version' | 'update_app_version';
+export interface CheckResult {
+    update: RemotePackage | null;
+    reason?: NoUpdateReason;
+    /** Set when a newer *binary* is required — the fix is a store update, not OTA. */
+    updateAppVersion?: boolean;
+}
+export interface OtaConfiguration {
+    deploymentKey: string;
+    serverUrl: string;
+    appVersion: string;
+    clientUniqueId: string;
+    /** Hash/label of the bundle currently running, if it is an OTA package. */
+    packageHash: string | null;
+    label: string | null;
+    /**
+     * The app's real native bundle identifier (iOS `CFBundleIdentifier` /
+     * Android package name), read from the native runtime — not settable from
+     * JS. Sent on every update-check so the server can reject a deployment key
+     * used against an app it was not issued for.
+     */
+    bundleIdentifier: string;
+}
+export interface SyncOptions {
+    installMode?: InstallMode;
+    /** Install mode used when the release is flagged mandatory. */
+    mandatoryInstallMode?: InstallMode;
+    /** Seconds the app must stay backgrounded before an ON_NEXT_RESUME install applies. */
+    minimumBackgroundDuration?: number;
+    deploymentKey?: string;
+    onSyncStatusChange?: (status: SyncStatus) => void;
+    onDownloadProgress?: (progress: DownloadProgress) => void;
+    /**
+     * Return false to skip an update (e.g. after asking the user).
+     * Mandatory updates ignore the result.
+     */
+    shouldInstall?: (update: RemotePackage) => boolean | Promise<boolean>;
+}
+export interface OtaOptions {
+    /** Run a sync when the app starts. Default: true. */
+    checkOnAppStart?: boolean;
+    /** Run a sync each time the app returns to the foreground. Default: true. */
+    checkOnResume?: boolean;
+    /** Minimum seconds between automatic syncs. Default: 60. */
+    minimumSyncInterval?: number;
+    sync?: SyncOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/lib/types.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncStatus = exports.InstallMode = void 0;
+/** When a downloaded update actually replaces the running JS bundle. */
+var InstallMode;
+(function (InstallMode) {
+    /** Swap in on the next natural app start. Safest; the default. */
+    InstallMode[InstallMode["ON_NEXT_RESTART"] = 0] = "ON_NEXT_RESTART";
+    /** Swap in the next time the app returns from the background. */
+    InstallMode[InstallMode["ON_NEXT_RESUME"] = 1] = "ON_NEXT_RESUME";
+    /** Reload the JS bundle right now. Interrupts the user — use for mandatory fixes. */
+    InstallMode[InstallMode["IMMEDIATE"] = 2] = "IMMEDIATE";
+})(InstallMode || (exports.InstallMode = InstallMode = {}));
+/** Progress of a `sync()` call, reported through `onSyncStatusChange`. */
+var SyncStatus;
+(function (SyncStatus) {
+    SyncStatus[SyncStatus["UP_TO_DATE"] = 0] = "UP_TO_DATE";
+    SyncStatus[SyncStatus["UPDATE_INSTALLED"] = 1] = "UPDATE_INSTALLED";
+    SyncStatus[SyncStatus["UPDATE_IGNORED"] = 2] = "UPDATE_IGNORED";
+    SyncStatus[SyncStatus["UNKNOWN_ERROR"] = 3] = "UNKNOWN_ERROR";
+    SyncStatus[SyncStatus["SYNC_IN_PROGRESS"] = 4] = "SYNC_IN_PROGRESS";
+    SyncStatus[SyncStatus["CHECKING_FOR_UPDATE"] = 5] = "CHECKING_FOR_UPDATE";
+    SyncStatus[SyncStatus["AWAITING_USER_ACTION"] = 6] = "AWAITING_USER_ACTION";
+    SyncStatus[SyncStatus["DOWNLOADING_PACKAGE"] = 7] = "DOWNLOADING_PACKAGE";
+    SyncStatus[SyncStatus["INSTALLING_UPDATE"] = 8] = "INSTALLING_UPDATE";
+})(SyncStatus || (exports.SyncStatus = SyncStatus = {}));
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAAA,wEAAwE;AACxE,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,kEAAkE;IAClE,mEAAmB,CAAA;IACnB,iEAAiE;IACjE,iEAAkB,CAAA;IAClB,qFAAqF;IACrF,uDAAa,CAAA;AACf,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB;AAED,0EAA0E;AAC1E,IAAY,UAUX;AAVD,WAAY,UAAU;IACpB,uDAAc,CAAA;IACd,mEAAoB,CAAA;IACpB,+DAAkB,CAAA;IAClB,6DAAiB,CAAA;IACjB,mEAAoB,CAAA;IACpB,yEAAuB,CAAA;IACvB,2EAAwB,CAAA;IACxB,yEAAuB,CAAA;IACvB,qEAAqB,CAAA;AACvB,CAAC,EAVW,UAAU,0BAAV,UAAU,QAUrB"}

package/lib/useOtaUpdate.d.ts

@@ -0,0 +1,17 @@
+import { SyncStatus, type DownloadProgress, type RemotePackage, type SyncOptions } from './types';
+export interface UseOtaUpdateState {
+    status: SyncStatus;
+    progress: DownloadProgress | null;
+    /** Populated when a check found an update that has not been installed yet. */
+    available: RemotePackage | null;
+    error: Error | null;
+    isSyncing: boolean;
+    check(): Promise<void>;
+    update(options?: SyncOptions): Promise<SyncStatus>;
+}
+/**
+ * Hook for update UI — a "New version available" banner, a download progress
+ * bar, or a settings screen with a manual "Check for updates" button.
+ */
+export declare function useOtaUpdate(defaultOptions?: SyncOptions): UseOtaUpdateState;
+//# sourceMappingURL=useOtaUpdate.d.ts.map

package/lib/useOtaUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOtaUpdate.d.ts","sourceRoot":"","sources":["../src/useOtaUpdate.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,8EAA8E;IAC9E,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,cAAc,GAAE,WAAgB,GAAG,iBAAiB,CAsEhF"}

package/lib/useOtaUpdate.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOtaUpdate = useOtaUpdate;
+const react_1 = require("react");
+const OtaUpdate_1 = require("./OtaUpdate");
+const types_1 = require("./types");
+/**
+ * Hook for update UI — a "New version available" banner, a download progress
+ * bar, or a settings screen with a manual "Check for updates" button.
+ */
+function useOtaUpdate(defaultOptions = {}) {
+    const [status, setStatus] = (0, react_1.useState)(types_1.SyncStatus.UP_TO_DATE);
+    const [progress, setProgress] = (0, react_1.useState)(null);
+    const [available, setAvailable] = (0, react_1.useState)(null);
+    const [error, setError] = (0, react_1.useState)(null);
+    const mounted = (0, react_1.useRef)(true);
+    (0, react_1.useEffect)(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+        };
+    }, []);
+    const check = (0, react_1.useCallback)(async () => {
+        try {
+            setError(null);
+            setStatus(types_1.SyncStatus.CHECKING_FOR_UPDATE);
+            const result = await (0, OtaUpdate_1.checkForUpdate)(defaultOptions.deploymentKey);
+            if (!mounted.current)
+                return;
+            setAvailable(result.update);
+            setStatus(result.update ? types_1.SyncStatus.AWAITING_USER_ACTION : types_1.SyncStatus.UP_TO_DATE);
+        }
+        catch (err) {
+            if (!mounted.current)
+                return;
+            setError(err);
+            setStatus(types_1.SyncStatus.UNKNOWN_ERROR);
+        }
+        // defaultOptions is intentionally read fresh on each call rather than
+        // captured as a dependency — callers routinely pass an inline object.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [defaultOptions.deploymentKey]);
+    const update = (0, react_1.useCallback)(async (options = {}) => {
+        setError(null);
+        const result = await (0, OtaUpdate_1.sync)({
+            installMode: types_1.InstallMode.ON_NEXT_RESTART,
+            ...defaultOptions,
+            ...options,
+            onSyncStatusChange: (s) => {
+                if (mounted.current)
+                    setStatus(s);
+                defaultOptions.onSyncStatusChange?.(s);
+                options.onSyncStatusChange?.(s);
+            },
+            onDownloadProgress: (p) => {
+                if (mounted.current)
+                    setProgress(p);
+                defaultOptions.onDownloadProgress?.(p);
+                options.onDownloadProgress?.(p);
+            },
+        });
+        if (mounted.current && result === types_1.SyncStatus.UPDATE_INSTALLED)
+            setAvailable(null);
+        return result;
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []);
+    return {
+        status,
+        progress,
+        available,
+        error,
+        isSyncing: status === types_1.SyncStatus.CHECKING_FOR_UPDATE ||
+            status === types_1.SyncStatus.DOWNLOADING_PACKAGE ||
+            status === types_1.SyncStatus.INSTALLING_UPDATE ||
+            status === types_1.SyncStatus.SYNC_IN_PROGRESS,
+        check,
+        update,
+    };
+}
+//# sourceMappingURL=useOtaUpdate.js.map

package/lib/useOtaUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOtaUpdate.js","sourceRoot":"","sources":["../src/useOtaUpdate.ts"],"names":[],"mappings":"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"}

package/lib/withOtaUpdate.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { OtaOptions } from './types';
+/**
+ * Wraps the root component so updates are checked on start and on resume, and
+ * the running bundle is confirmed (rollback-protection) as soon as it mounts.
+ *
+ *   export default withOtaUpdate(App, { sync: { installMode: InstallMode.ON_NEXT_RESUME } })
+ */
+export declare function withOtaUpdate<P extends object>(Component: React.ComponentType<P>, options?: OtaOptions): React.ComponentType<P>;
+//# sourceMappingURL=withOtaUpdate.d.ts.map

package/lib/withOtaUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withOtaUpdate.d.ts","sourceRoot":"","sources":["../src/withOtaUpdate.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EACjC,OAAO,GAAE,UAAe,GACvB,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAQxB"}

package/lib/withOtaUpdate.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withOtaUpdate = withOtaUpdate;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const OtaUpdate_1 = require("./OtaUpdate");
+/**
+ * Wraps the root component so updates are checked on start and on resume, and
+ * the running bundle is confirmed (rollback-protection) as soon as it mounts.
+ *
+ *   export default withOtaUpdate(App, { sync: { installMode: InstallMode.ON_NEXT_RESUME } })
+ */
+function withOtaUpdate(Component, options = {}) {
+    const Wrapped = (props) => {
+        (0, react_1.useEffect)(() => (0, OtaUpdate_1.startAutoSync)(options), []);
+        return (0, jsx_runtime_1.jsx)(Component, { ...props });
+    };
+    Wrapped.displayName = `withOtaUpdate(${Component.displayName ?? Component.name ?? 'Component'})`;
+    return Wrapped;
+}
+//# sourceMappingURL=withOtaUpdate.js.map

package/lib/withOtaUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withOtaUpdate.js","sourceRoot":"","sources":["../src/withOtaUpdate.tsx"],"names":[],"mappings":";;AAUA,sCAWC;;AArBD,iCAAyC;AACzC,2CAA4C;AAG5C;;;;;GAKG;AACH,SAAgB,aAAa,CAC3B,SAAiC,EACjC,UAAsB,EAAE;IAExB,MAAM,OAAO,GAAgB,CAAC,KAAK,EAAE,EAAE;QACrC,IAAA,iBAAS,EAAC,GAAG,EAAE,CAAC,IAAA,yBAAa,EAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO,uBAAC,SAAS,OAAK,KAAK,GAAI,CAAC;IAClC,CAAC,CAAC;IAEF,OAAO,CAAC,WAAW,GAAG,iBAAiB,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IACjG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@otaupdate/react-native",
+  "version": "1.0.0",
+  "description": "Over-the-air JS bundle updates for React Native \u2014 bare and Expo",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "app.plugin.js": "app.plugin.js",
+  "files": [
+    "lib",
+    "src",
+    "android",
+    "ios",
+    "plugin/build",
+    "expo-module.config.json",
+    "react-native.config.js",
+    "app.plugin.js",
+    "react-native-ota-update.podspec",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p plugin/tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p plugin/tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react-native",
+    "ota",
+    "codepush",
+    "hot-update",
+    "expo"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.71.0"
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "^9.0.0",
+    "@types/react": "^18.3.18",
+    "react": "18.3.1",
+    "react-native": "0.76.6",
+    "typescript": "^5.7.3"
+  },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
+  }
+}

package/plugin/build/index.d.ts

@@ -0,0 +1,11 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+export interface OtaPluginOptions {
+    /** Server that serves updates, e.g. https://ota.example.com */
+    serverUrl: string;
+    /** Deployment key used on both platforms unless overridden below. */
+    deploymentKey?: string;
+    iosDeploymentKey?: string;
+    androidDeploymentKey?: string;
+}
+declare const _default: ConfigPlugin<OtaPluginOptions>;
+export default _default;

package/plugin/build/index.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+const PACKAGE_NAME = '@otaupdate/react-native';
+function keysFor(options) {
+    const ios = options.iosDeploymentKey ?? options.deploymentKey;
+    const android = options.androidDeploymentKey ?? options.deploymentKey;
+    if (!ios || !android) {
+        throw new Error(`[${PACKAGE_NAME}] Missing deployment key. Provide "deploymentKey", or both ` +
+            '"iosDeploymentKey" and "androidDeploymentKey", in the plugin options.\n\n' +
+            '  ["@otaupdate/react-native", { "serverUrl": "https://ota.example.com", ' +
+            '"iosDeploymentKey": "…", "androidDeploymentKey": "…" }]');
+    }
+    return { ios, android };
+}
+// --- iOS ---------------------------------------------------------------------
+const withOtaInfoPlist = (config, options) => (0, config_plugins_1.withInfoPlist)(config, (mod) => {
+    mod.modResults.OtaDeploymentKey = keysFor(options).ios;
+    mod.modResults.OtaServerUrl = options.serverUrl;
+    return mod;
+});
+/**
+ * Points React Native at the OTA bundle. Handles both AppDelegate flavours:
+ * Swift (Expo SDK 52+) and Objective-C++ (SDK 51 and earlier).
+ */
+const withOtaAppDelegate = (config) => (0, config_plugins_1.withAppDelegate)(config, (mod) => {
+    const { language } = mod.modResults;
+    let contents = mod.modResults.contents;
+    if (language === 'swift') {
+        if (!contents.includes('import OtaUpdate')) {
+            contents = contents.replace(/(import\s+React[^\n]*\n)/, `$1import OtaUpdate\n`);
+            if (!contents.includes('import OtaUpdate')) {
+                // Fall back to inserting after the first import of any kind.
+                contents = contents.replace(/^(import [^\n]+\n)/m, `$1import OtaUpdate\n`);
+            }
+        }
+        if (!contents.includes('OtaUpdate.bundleURL()')) {
+            const replaced = contents.replace(/Bundle\.main\.url\(forResource:\s*"main",\s*withExtension:\s*"jsbundle"\)/g, 'OtaUpdate.bundleURL()');
+            if (replaced === contents) {
+                throw new Error(`[${PACKAGE_NAME}] Could not patch AppDelegate.swift — the release bundle lookup ` +
+                    'was not found. Add `return OtaUpdate.bundleURL()` to bundleURL() manually.');
+            }
+            contents = replaced;
+        }
+    }
+    else {
+        if (!contents.includes('#import <OtaUpdate/OtaUpdate.h>')) {
+            contents = contents.replace(/(#import\s+"AppDelegate\.h"\n)/, `$1#import <OtaUpdate/OtaUpdate.h>\n`);
+            if (!contents.includes('#import <OtaUpdate/OtaUpdate.h>')) {
+                contents = `#import <OtaUpdate/OtaUpdate.h>\n${contents}`;
+            }
+        }
+        if (!contents.includes('[OtaUpdate bundleURL]')) {
+            const replaced = contents.replace(/\[\[NSBundle mainBundle\] URLForResource:@"main" withExtension:@"jsbundle"\]/g, '[OtaUpdate bundleURL]');
+            if (replaced === contents) {
+                throw new Error(`[${PACKAGE_NAME}] Could not patch AppDelegate.mm — the release bundle lookup ` +
+                    'was not found. Return `[OtaUpdate bundleURL]` from getBundleURL manually.');
+            }
+            contents = replaced;
+        }
+    }
+    mod.modResults.contents = contents;
+    return mod;
+});
+// --- Android -----------------------------------------------------------------
+const withOtaStrings = (config, options) => (0, config_plugins_1.withStringsXml)(config, (mod) => {
+    const { android } = keysFor(options);
+    mod.modResults = config_plugins_1.AndroidConfig.Strings.setStringItem([
+        // translatable=false keeps these out of localisation exports.
+        { $: { name: 'ota_deployment_key', translatable: 'false' }, _: android },
+        { $: { name: 'ota_server_url', translatable: 'false' }, _: options.serverUrl },
+    ], mod.modResults);
+    return mod;
+});
+// Note: there is deliberately no MainApplication patch on Android.
+//
+// Expo apps are bridgeless — MainApplication builds a ReactHost directly from
+// ExpoReactHostFactory and exposes no ReactNativeHost to override. The bundle
+// path is instead supplied by OtaUpdateExpoPackage, which registers a
+// ReactNativeHostHandler (Expo's own extension point, the same one
+// expo-updates uses) and is picked up by Expo autolinking.
+//
+// Rewriting Kotlin source here would break every time the RN/Expo template
+// changes — it already did, against the RN 0.86 template.
+// --- Entry point --------------------------------------------------------------
+const withOtaUpdate = (config, options) => {
+    if (!options?.serverUrl) {
+        throw new Error(`[${PACKAGE_NAME}] "serverUrl" is required.\n\n` +
+            '  ["@otaupdate/react-native", { "serverUrl": "https://ota.example.com", "deploymentKey": "…" }]');
+    }
+    keysFor(options); // fail fast at config time rather than at build time
+    config = withOtaInfoPlist(config, options);
+    config = withOtaAppDelegate(config);
+    config = withOtaStrings(config, options);
+    return config;
+};
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withOtaUpdate, PACKAGE_NAME, '1.0.0');

package/react-native-ota-update.podspec

@@ -0,0 +1,43 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-ota-update"
+  # module_name is what `import OtaUpdate` (Swift) and
+  # `#import <OtaUpdate/OtaUpdate.h>` (ObjC) resolve to in the host app.
+  s.module_name  = "OtaUpdate"
+  s.header_dir   = "OtaUpdate"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.license      = package["license"]
+  s.authors      = { "OTA Platform" => "noreply@example.com" }
+  s.homepage     = "https://github.com/your-org/ota-platform"
+  s.platforms    = { :ios => "13.4" }
+  s.source       = { :git => "https://github.com/your-org/ota-platform.git", :tag => "v#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}"
+  s.public_header_files = "ios/OtaUpdate.h"
+  s.requires_arc = true
+
+  # Required for `import OtaUpdate` from a Swift AppDelegate.
+  #
+  # React Native and Expo build pods as static libraries by default, and an
+  # Objective-C static library is NOT importable as a Swift module unless
+  # CocoaPods emits a module map for it. DEFINES_MODULE makes it do that,
+  # generating `module OtaUpdate` from `module_name` above. Without this the
+  # host app fails to compile with "no such module 'OtaUpdate'" — even though
+  # the pod links fine and the ObjC side is completely healthy.
+  s.pod_target_xcconfig = { "DEFINES_MODULE" => "YES" }
+
+  # Unzipping the release package. SSZipArchive is the same dependency
+  # react-native-code-push uses, so most projects already resolve it cleanly.
+  s.dependency "SSZipArchive", "~> 2.4"
+
+  if respond_to?(:install_modules_dependencies, true)
+    # RN >= 0.71 helper: wires up React-Core plus the new-architecture deps.
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+  end
+end

package/react-native.config.js

@@ -0,0 +1,21 @@
+// This package is linked by BOTH linkers, and needs to be:
+//
+//   - React Native autolinking registers `OtaUpdatePackage`, the ReactPackage
+//     that exposes the `OtaUpdate` native module to JS.
+//   - Expo autolinking registers `OtaUpdateExpoPackage`, which supplies the
+//     downloaded bundle path via `ReactNativeHostHandler`.
+//
+// Expo's resolver deliberately drops a package from React Native autolinking
+// when it is *also* an Expo module with its own Gradle file and no explicit
+// React Native config — the two would otherwise race to link the same Gradle
+// project. Declaring the config here opts out of that skip, so the native
+// module still reaches JS. Without this file, `NativeModules.OtaUpdate` is
+// undefined in Expo apps and every SDK call throws the linking error.
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {},
+      ios: {},
+    },
+  },
+};