relay-ota-react-native 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAAwD;AAA/C,uGAAA,WAAW,OAAA;AAAE,yGAAA,aAAa,OAAA;AACnC,iCAAsD;AAA7C,qGAAA,YAAY,OAAA;AAAE,sGAAA,aAAa,OAAA;AACpC,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AACnB,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AACvB,2CAAwF;AAA/E,yHAAA,2BAA2B,OAAA;AAAE,yHAAA,2BAA2B,OAAA;AACjE,yCAMqB;AALnB,oHAAA,uBAAuB,OAAA;AACvB,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,mGAAA,MAAM,OAAA"}

package/dist/installer.d.ts

@@ -0,0 +1,6 @@
+export declare function isNativeModuleAvailable(): boolean;
+export declare function setStagedBundlePath(path: string): Promise<void>;
+export declare function getStagedBundlePath(): Promise<string | null>;
+export declare function clearStagedBundlePath(): Promise<void>;
+export declare function reload(): void;
+//# sourceMappingURL=installer.d.ts.map

package/dist/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAUA,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrE;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIlE;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3D;AAED,wBAAgB,MAAM,IAAI,IAAI,CAS7B"}

package/dist/installer.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNativeModuleAvailable = isNativeModuleAvailable;
+exports.setStagedBundlePath = setStagedBundlePath;
+exports.getStagedBundlePath = getStagedBundlePath;
+exports.clearStagedBundlePath = clearStagedBundlePath;
+exports.reload = reload;
+const react_native_1 = require("react-native");
+// User must register their native module under this name
+const NATIVE_MODULE_NAME = 'OtaBundleUpdater';
+function getNativeModule() {
+    return react_native_1.NativeModules[NATIVE_MODULE_NAME] ?? null;
+}
+function isNativeModuleAvailable() {
+    return getNativeModule() !== null;
+}
+async function setStagedBundlePath(path) {
+    const mod = getNativeModule();
+    if (!mod)
+        throw new Error(`Native module '${NATIVE_MODULE_NAME}' not found. See SDK setup docs.`);
+    await mod.setBundlePath(path);
+}
+async function getStagedBundlePath() {
+    const mod = getNativeModule();
+    if (!mod)
+        return null;
+    return mod.getBundlePath();
+}
+async function clearStagedBundlePath() {
+    const mod = getNativeModule();
+    if (!mod)
+        return;
+    await mod.clearBundlePath();
+}
+function reload() {
+    const mod = getNativeModule();
+    if (mod) {
+        mod.reload();
+    }
+    else {
+        // Dev fallback
+        const devSettings = react_native_1.NativeModules['DevSettings'];
+        devSettings?.reload?.();
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":";;AAUA,0DAEC;AAED,kDAIC;AAED,kDAIC;AAED,sDAIC;AAED,wBASC;AAzCD,+CAA6C;AAG7C,yDAAyD;AACzD,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAE9C,SAAS,eAAe;IACtB,OAAQ,4BAAa,CAAC,kBAAkB,CAA0B,IAAI,IAAI,CAAC;AAC7E,CAAC;AAED,SAAgB,uBAAuB;IACrC,OAAO,eAAe,EAAE,KAAK,IAAI,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,kBAAkB,kCAAkC,CAAC,CAAC;IAClG,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAEM,KAAK,UAAU,mBAAmB;IACvC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,GAAG,CAAC,aAAa,EAAE,CAAC;AAC7B,CAAC;AAEM,KAAK,UAAU,qBAAqB;IACzC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;AAC9B,CAAC;AAED,SAAgB,MAAM;IACpB,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,GAAG,EAAE,CAAC;QACR,GAAG,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;SAAM,CAAC;QACN,eAAe;QACf,MAAM,WAAW,GAAG,4BAAa,CAAC,aAAa,CAAwC,CAAC;QACxF,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,18 @@
+import React, { type ReactNode } from 'react';
+import type { OtaConfig, UpdateState, IFileSystemAdapter } from './types';
+interface OtaContextValue {
+    state: UpdateState;
+    checkForUpdates: () => Promise<void>;
+    downloadUpdate: () => Promise<void>;
+    applyUpdate: () => Promise<void>;
+    rollback: () => Promise<void>;
+}
+interface OtaProviderProps {
+    config: OtaConfig;
+    fileSystem: IFileSystemAdapter;
+    children: ReactNode;
+}
+export declare function OtaProvider({ config, fileSystem, children }: OtaProviderProps): React.JSX.Element;
+export declare function useOtaContext(): OtaContextValue;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE1E,UAAU,eAAe;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAID,UAAU,gBAAgB;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,gBAAgB,qBA0C7E;AAED,wBAAgB,aAAa,IAAI,eAAe,CAI/C"}

package/dist/provider.js

@@ -0,0 +1,82 @@
+"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.OtaProvider = OtaProvider;
+exports.useOtaContext = useOtaContext;
+const react_1 = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const updater_1 = require("./updater");
+const OtaContext = (0, react_1.createContext)(null);
+function OtaProvider({ config, fileSystem, children }) {
+    const updaterRef = (0, react_1.useRef)(null);
+    if (!updaterRef.current) {
+        updaterRef.current = new updater_1.OtaUpdater(config, fileSystem);
+    }
+    const updater = updaterRef.current;
+    const [state, setState] = (0, react_1.useState)(updater.getState());
+    (0, react_1.useEffect)(() => {
+        const unsub = updater.subscribe(setState);
+        return unsub;
+    }, [updater]);
+    // Check on foreground (AppState active)
+    (0, react_1.useEffect)(() => {
+        if (config.checkOnForeground === false)
+            return;
+        const handler = (nextState) => {
+            if (nextState === 'active') {
+                updater.checkForUpdates();
+            }
+        };
+        const sub = react_native_1.AppState.addEventListener('change', handler);
+        // Initial check on mount
+        updater.checkForUpdates();
+        return () => sub.remove();
+    }, [updater, config.checkOnForeground]);
+    const value = {
+        state,
+        checkForUpdates: () => updater.checkForUpdates(),
+        downloadUpdate: () => updater.downloadUpdate(),
+        applyUpdate: () => updater.applyUpdate(),
+        rollback: () => updater.rollback(),
+    };
+    return <OtaContext.Provider value={value}>{children}</OtaContext.Provider>;
+}
+function useOtaContext() {
+    const ctx = (0, react_1.useContext)(OtaContext);
+    if (!ctx)
+        throw new Error('useOtaContext must be used inside <OtaProvider>');
+    return ctx;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,kCA0CC;AAED,sCAIC;AA5ED,+CAOe;AACf,+CAA6D;AAC7D,uCAAuC;AAWvC,MAAM,UAAU,GAAG,IAAA,qBAAa,EAAyB,IAAI,CAAC,CAAC;AAQ/D,SAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAoB;IAC5E,MAAM,UAAU,GAAG,IAAA,cAAM,EAAoB,IAAI,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,UAAU,CAAC,OAAO,GAAG,IAAI,oBAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACnC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAc,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEpE,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,wCAAwC;IACxC,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,MAAM,CAAC,iBAAiB,KAAK,KAAK;YAAE,OAAO;QAE/C,MAAM,OAAO,GAAG,CAAC,SAAyB,EAAE,EAAE;YAC5C,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,GAAG,GAAG,uBAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEzD,yBAAyB;QACzB,OAAO,CAAC,eAAe,EAAE,CAAC;QAE1B,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAExC,MAAM,KAAK,GAAoB;QAC7B,KAAK;QACL,eAAe,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE;QAChD,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE;QAC9C,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE;QACxC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE;KACnC,CAAC;IAEF,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,aAAa;IAC3B,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC7E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,12 @@
+import type { OtaCheckResponse } from './types';
+type StoredRelease = NonNullable<OtaCheckResponse['release']>;
+export declare function storePendingRelease(release: StoredRelease): Promise<void>;
+export declare function getPendingRelease(): Promise<StoredRelease | null>;
+export declare function clearPendingRelease(): Promise<void>;
+export declare function storeAppliedRelease(release: StoredRelease): Promise<void>;
+export declare function getAppliedRelease(): Promise<StoredRelease | null>;
+export declare function storeBundlePath(path: string): Promise<void>;
+export declare function getBundlePath(): Promise<string | null>;
+export declare function clearBundlePath(): Promise<void>;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMhD,KAAK,aAAa,GAAG,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;AAE9D,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAGvE;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAGvE;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE5D;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD"}

package/dist/storage.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storePendingRelease = storePendingRelease;
+exports.getPendingRelease = getPendingRelease;
+exports.clearPendingRelease = clearPendingRelease;
+exports.storeAppliedRelease = storeAppliedRelease;
+exports.getAppliedRelease = getAppliedRelease;
+exports.storeBundlePath = storeBundlePath;
+exports.getBundlePath = getBundlePath;
+exports.clearBundlePath = clearBundlePath;
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const KEY_PENDING_RELEASE = '@ota/pending_release';
+const KEY_APPLIED_RELEASE = '@ota/applied_release';
+const KEY_BUNDLE_PATH = '@ota/bundle_path';
+async function storePendingRelease(release) {
+    await async_storage_1.default.setItem(KEY_PENDING_RELEASE, JSON.stringify(release));
+}
+async function getPendingRelease() {
+    const raw = await async_storage_1.default.getItem(KEY_PENDING_RELEASE);
+    return raw ? JSON.parse(raw) : null;
+}
+async function clearPendingRelease() {
+    await async_storage_1.default.removeItem(KEY_PENDING_RELEASE);
+}
+async function storeAppliedRelease(release) {
+    await async_storage_1.default.setItem(KEY_APPLIED_RELEASE, JSON.stringify(release));
+}
+async function getAppliedRelease() {
+    const raw = await async_storage_1.default.getItem(KEY_APPLIED_RELEASE);
+    return raw ? JSON.parse(raw) : null;
+}
+async function storeBundlePath(path) {
+    await async_storage_1.default.setItem(KEY_BUNDLE_PATH, path);
+}
+async function getBundlePath() {
+    return async_storage_1.default.getItem(KEY_BUNDLE_PATH);
+}
+async function clearBundlePath() {
+    await async_storage_1.default.removeItem(KEY_BUNDLE_PATH);
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":";;;;;AASA,kDAEC;AAED,8CAGC;AAED,kDAEC;AAED,kDAEC;AAED,8CAGC;AAED,0CAEC;AAED,sCAEC;AAED,0CAEC;AAzCD,8FAAqE;AAGrE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAIpC,KAAK,UAAU,mBAAmB,CAAC,OAAsB;IAC9D,MAAM,uBAAY,CAAC,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC;AAEM,KAAK,UAAU,iBAAiB;IACrC,MAAM,GAAG,GAAG,MAAM,uBAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,OAAO,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAEM,KAAK,UAAU,mBAAmB;IACvC,MAAM,uBAAY,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACrD,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,OAAsB;IAC9D,MAAM,uBAAY,CAAC,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC;AAEM,KAAK,UAAU,iBAAiB;IACrC,MAAM,GAAG,GAAG,MAAM,uBAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D,OAAO,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAEM,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,uBAAY,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAEM,KAAK,UAAU,aAAa;IACjC,OAAO,uBAAY,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAC/C,CAAC;AAEM,KAAK,UAAU,eAAe;IACnC,MAAM,uBAAY,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACjD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export type Platform = 'IOS' | 'ANDROID';
+export interface OtaCheckRequest {
+    appId: string;
+    platform: Platform;
+    currentVersion: string;
+    runtimeVersion: string;
+    channel: string;
+}
+export interface OtaCheckResponse {
+    updateAvailable: boolean;
+    release?: {
+        id: string;
+        version: string;
+        downloadUrl: string;
+        checksum: string;
+        fileSize: number;
+        isMandatory: boolean;
+        releaseNotes?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface OtaConfig {
+    serverUrl: string;
+    appId: string;
+    channel: string;
+    platform: Platform;
+    currentVersion: string;
+    runtimeVersion: string;
+    checkOnForeground?: boolean;
+    onUpdate?: (release: NonNullable<OtaCheckResponse['release']>) => void;
+    onError?: (error: Error) => void;
+}
+export type UpdateStatus = 'idle' | 'checking' | 'up_to_date' | 'update_available' | 'downloading' | 'ready' | 'error';
+export interface UpdateState {
+    status: UpdateStatus;
+    progress: number;
+    release: NonNullable<OtaCheckResponse['release']> | null;
+    error: Error | null;
+    localBundlePath: string | null;
+}
+export interface IFileSystemAdapter {
+    getDocumentDirectory(): string;
+    exists(path: string): Promise<boolean>;
+    readAsString(path: string, encoding: 'utf8' | 'base64'): Promise<string>;
+    writeAsString(path: string, content: string, encoding: 'utf8' | 'base64'): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    makeDirectory(path: string): Promise<void>;
+}
+export interface INativeBundleUpdater {
+    setBundlePath(path: string): Promise<void>;
+    getBundlePath(): Promise<string | null>;
+    clearBundlePath(): Promise<void>;
+    reload(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,KAAK,IAAI,CAAC;IACvE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,aAAa,GACb,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;IACzD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,oBAAoB,IAAI,MAAM,CAAC;IAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,IAAI,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/updater.d.ts

@@ -0,0 +1,17 @@
+import type { OtaConfig, UpdateState, IFileSystemAdapter } from './types';
+export type StateListener = (state: UpdateState) => void;
+export declare class OtaUpdater {
+    private state;
+    private listeners;
+    private config;
+    private fs;
+    constructor(config: OtaConfig, fs: IFileSystemAdapter);
+    getState(): UpdateState;
+    subscribe(listener: StateListener): () => void;
+    private emit;
+    checkForUpdates(): Promise<void>;
+    downloadUpdate(): Promise<void>;
+    applyUpdate(): Promise<void>;
+    rollback(): Promise<void>;
+}
+//# sourceMappingURL=updater.d.ts.map

package/dist/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../src/updater.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAUzD,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,EAAE,CAAqB;gBAEnB,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,kBAAkB;IAKrD,QAAQ,IAAI,WAAW;IAIvB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAK9C,OAAO,CAAC,IAAI;IAKN,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BhC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB/B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}

package/dist/updater.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtaUpdater = void 0;
+const client_1 = require("./client");
+const downloader_1 = require("./downloader");
+const installer_1 = require("./installer");
+const storage_1 = require("./storage");
+const initialState = {
+    status: 'idle',
+    progress: 0,
+    release: null,
+    error: null,
+    localBundlePath: null,
+};
+class OtaUpdater {
+    state = { ...initialState };
+    listeners = new Set();
+    config;
+    fs;
+    constructor(config, fs) {
+        this.config = config;
+        this.fs = fs;
+    }
+    getState() {
+        return this.state;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(patch) {
+        this.state = { ...this.state, ...patch };
+        this.listeners.forEach((l) => l(this.state));
+    }
+    async checkForUpdates() {
+        if (this.state.status === 'checking' || this.state.status === 'downloading')
+            return;
+        this.emit({ status: 'checking', error: null });
+        try {
+            const applied = await (0, storage_1.getAppliedRelease)();
+            const currentVersion = applied?.version ?? this.config.currentVersion;
+            const result = await (0, client_1.checkForUpdate)(this.config.serverUrl, {
+                appId: this.config.appId,
+                channel: this.config.channel,
+                platform: this.config.platform,
+                currentVersion,
+                runtimeVersion: this.config.runtimeVersion,
+            });
+            if (!result.updateAvailable || !result.release) {
+                this.emit({ status: 'up_to_date', release: null });
+                return;
+            }
+            this.emit({ status: 'update_available', release: result.release });
+            await (0, storage_1.storePendingRelease)(result.release);
+            this.config.onUpdate?.(result.release);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit({ status: 'error', error });
+            this.config.onError?.(error);
+        }
+    }
+    async downloadUpdate() {
+        if (!this.state.release || this.state.status !== 'update_available')
+            return;
+        const release = this.state.release;
+        this.emit({ status: 'downloading', progress: 0 });
+        try {
+            const bundlePath = await (0, downloader_1.downloadBundle)(release, this.fs, (progress) => {
+                this.emit({ progress });
+            });
+            await (0, installer_1.setStagedBundlePath)(bundlePath);
+            await (0, storage_1.storeBundlePath)(bundlePath);
+            this.emit({ status: 'ready', localBundlePath: bundlePath, progress: 100 });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit({ status: 'error', error });
+            this.config.onError?.(error);
+        }
+    }
+    async applyUpdate() {
+        if (this.state.status !== 'ready' || !this.state.release)
+            return;
+        await (0, storage_1.storeAppliedRelease)(this.state.release);
+        await (0, storage_1.clearPendingRelease)();
+        (0, installer_1.reload)();
+    }
+    async rollback() {
+        await (0, installer_1.clearStagedBundlePath)();
+        await (0, storage_1.clearBundlePath)();
+        await (0, storage_1.clearPendingRelease)();
+        this.emit({ ...initialState, status: 'idle' });
+        (0, installer_1.reload)();
+    }
+}
+exports.OtaUpdater = OtaUpdater;
+//# sourceMappingURL=updater.js.map

package/dist/updater.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "relay-ota-react-native",
+  "version": "0.1.0",
+  "description": "Relay OTA SDK for React Native — ship updates without app store review",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react-native",
+    "ota",
+    "over-the-air",
+    "codepush",
+    "expo",
+    "update",
+    "sdk"
+  ],
+  "license": "MIT",
+  "homepage": "https://relayota.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aglaonematech/relay-ota-react-native.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aglaonematech/relay-ota-react-native/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.72.0",
+    "@react-native-async-storage/async-storage": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-async-storage/async-storage": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^2.1.2",
+    "@types/react": "^18.3.1",
+    "@types/react-native": "^0.73.0",
+    "typescript": "^5.7.3"
+  }
+}

package/src/client.ts

@@ -0,0 +1,19 @@
+import type { OtaCheckRequest, OtaCheckResponse } from './types';
+
+export async function checkForUpdate(
+  serverUrl: string,
+  request: OtaCheckRequest,
+): Promise<OtaCheckResponse> {
+  const url = `${serverUrl.replace(/\/$/, '')}/api/v1/ota/check`;
+  const response = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(request),
+  });
+
+  if (!response.ok) {
+    throw new Error(`OTA check failed: HTTP ${response.status}`);
+  }
+
+  return response.json() as Promise<OtaCheckResponse>;
+}

package/src/downloader.ts

@@ -0,0 +1,79 @@
+import type { IFileSystemAdapter } from './types';
+import type { OtaCheckResponse } from './types';
+
+type Release = NonNullable<OtaCheckResponse['release']>;
+
+export async function downloadBundle(
+  release: Release,
+  fs: IFileSystemAdapter,
+  onProgress?: (progress: number) => void,
+): Promise<string> {
+  const bundleDir = `${fs.getDocumentDirectory()}ota-bundles/${release.id}`;
+  const bundlePath = `${bundleDir}/bundle.js`;
+
+  await fs.makeDirectory(bundleDir);
+
+  const response = await fetch(release.downloadUrl);
+  if (!response.ok) {
+    throw new Error(`Download failed: HTTP ${response.status}`);
+  }
+
+  const contentLength = parseInt(response.headers.get('content-length') ?? '0', 10);
+  const reader = response.body?.getReader();
+
+  if (!reader) {
+    // Fallback: read entire body at once (no streaming progress)
+    const buffer = await response.arrayBuffer();
+    const bytes = new Uint8Array(buffer);
+    const b64 = uint8ArrayToBase64(bytes);
+    await fs.writeAsString(bundlePath, b64, 'base64');
+    onProgress?.(100);
+  } else {
+    const chunks: Uint8Array[] = [];
+    let received = 0;
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      chunks.push(value);
+      received += value.length;
+      if (contentLength > 0) {
+        onProgress?.(Math.round((received / contentLength) * 100));
+      }
+    }
+
+    const total = chunks.reduce((acc, c) => acc + c.length, 0);
+    const merged = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+      merged.set(chunk, offset);
+      offset += chunk.length;
+    }
+
+    const checksum = await sha256Hex(merged);
+    if (checksum !== release.checksum) {
+      throw new Error(`Checksum mismatch: expected ${release.checksum}, got ${checksum}`);
+    }
+
+    const b64 = uint8ArrayToBase64(merged);
+    await fs.writeAsString(bundlePath, b64, 'base64');
+    onProgress?.(100);
+  }
+
+  return bundlePath;
+}
+
+async function sha256Hex(data: Uint8Array): Promise<string> {
+  const hashBuffer = await crypto.subtle.digest('SHA-256', data as unknown as ArrayBuffer);
+  const hashArray = Array.from(new Uint8Array(hashBuffer));
+  return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+
+function uint8ArrayToBase64(bytes: Uint8Array): string {
+  let binary = '';
+  const len = bytes.byteLength;
+  for (let i = 0; i < len; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary);
+}