relay-ota-react-native 0.1.0

package/README.md

@@ -0,0 +1,376 @@
+# relay-ota-react-native
+
+**Over-the-air updates for React Native — ship JS bundle changes instantly, without App Store review.**
+
+Open-source drop-in replacement for the retired Microsoft CodePush and a self-hosted alternative to Expo EAS Updates.
+
+[![npm version](https://img.shields.io/npm/v/relay-ota-react-native.svg?style=flat-square)](https://www.npmjs.com/package/relay-ota-react-native)
+[![npm downloads](https://img.shields.io/npm/dm/relay-ota-react-native.svg?style=flat-square)](https://www.npmjs.com/package/relay-ota-react-native)
+[![license](https://img.shields.io/npm/l/relay-ota-react-native.svg?style=flat-square)](https://github.com/aglaonematech/relay-ota-react-native/blob/main/LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/aglaonematech/relay-ota-react-native?style=flat-square)](https://github.com/aglaonematech/relay-ota-react-native)
+
+**Website:** [relayota.com](https://relayota.com) · **Docs:** [relayota.com/docs](https://relayota.com/docs) · **GitHub:** [aglaonematech/relay-ota-react-native](https://github.com/aglaonematech/relay-ota-react-native)
+
+---
+
+## What is Relay OTA?
+
+Relay OTA lets you push JavaScript bundle updates directly to your users' devices — no App Store or Play Store review needed. It's a fully open-source, self-hosted platform: you own the server, you own the data, and you pay nothing.
+
+- **Zero review wait** — critical fixes reach users in seconds
+- **One-click rollback** — bad update? revert instantly from the dashboard
+- **Channels** — separate `production` and `staging` environments
+- **Staged rollouts** — release to a percentage of users before going 100%
+- **Mandatory updates** — auto-apply security patches without user interaction
+- **Analytics** — track check, download, and apply rates per release
+
+Works with **Expo managed workflow** and **bare React Native** (0.72+).
+
+---
+
+## Installation
+
+```sh
+npm install relay-ota-react-native @react-native-async-storage/async-storage
+```
+
+### Expo projects
+
+```sh
+npx expo install expo-file-system
+```
+
+### Bare React Native projects
+
+```sh
+npm install react-native-fs
+cd ios && pod install
+```
+
+---
+
+## Quick start — Expo
+
+```tsx
+import { OtaProvider, useOtaUpdate, createExpoFileSystemAdapter } from 'relay-ota-react-native';
+
+const fs = createExpoFileSystemAdapter();
+
+export default function App() {
+  return (
+    <OtaProvider
+      fileSystem={fs}
+      config={{
+        serverUrl: 'https://ota.yourcompany.com',  // your self-hosted server
+        appId: 'YOUR_APP_ID',
+        channel: 'production',
+        platform: 'IOS',           // or 'ANDROID'
+        currentVersion: '1.0.0',
+        runtimeVersion: '1.0.0',
+      }}
+    >
+      <YourNavigator />
+    </OtaProvider>
+  );
+}
+```
+
+Show an update prompt anywhere in your app:
+
+```tsx
+import { useOtaUpdate } from 'relay-ota-react-native';
+import { View, Text, Button } from 'react-native';
+
+export function UpdateBanner() {
+  const { hasUpdate, isReady, isLoading, progress, downloadUpdate, applyUpdate } = useOtaUpdate();
+
+  if (hasUpdate) return (
+    <View>
+      <Text>New version available</Text>
+      <Button title="Download" onPress={downloadUpdate} />
+    </View>
+  );
+
+  if (isLoading) return <Text>Downloading… {Math.round(progress * 100)}%</Text>;
+
+  if (isReady) return (
+    <View>
+      <Text>Update ready</Text>
+      <Button title="Restart now" onPress={applyUpdate} />
+    </View>
+  );
+
+  return null;
+}
+```
+
+---
+
+## Quick start — Bare React Native
+
+```tsx
+import { OtaProvider, createRNFSFileSystemAdapter } from 'relay-ota-react-native';
+
+const fs = createRNFSFileSystemAdapter();
+
+export default function App() {
+  return (
+    <OtaProvider
+      fileSystem={fs}
+      config={{
+        serverUrl: 'https://ota.yourcompany.com',
+        appId: 'YOUR_APP_ID',
+        channel: 'production',
+        platform: 'ANDROID',
+        currentVersion: '1.0.0',
+        runtimeVersion: '1.0.0',
+      }}
+    >
+      <YourNavigator />
+    </OtaProvider>
+  );
+}
+```
+
+Bare React Native requires the `OtaBundleUpdater` native module — see [Native module setup](#native-module-setup) below.
+
+---
+
+## Self-hosting the server
+
+This SDK connects to a **Relay OTA server** you run yourself. Getting the server up takes about 5 minutes:
+
+```sh
+git clone https://github.com/aglaonematech/relay-ota.git
+cd relay-ota
+docker compose up -d          # starts Postgres, Redis, MinIO
+npm install
+npm run dev
+```
+
+Full setup guide → [relayota.com/docs](https://relayota.com/docs)
+
+---
+
+## OtaProvider config
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| `serverUrl` | `string` | ✅ | Base URL of your OTA server |
+| `appId` | `string` | ✅ | App ID from the OTA dashboard |
+| `channel` | `string` | ✅ | Release channel — e.g. `'production'`, `'staging'` |
+| `platform` | `'IOS' \| 'ANDROID'` | ✅ | Target platform |
+| `currentVersion` | `string` | ✅ | Current JS bundle version |
+| `runtimeVersion` | `string` | ✅ | Native runtime version — must match the release |
+| `checkOnForeground` | `boolean` | — | Auto-check when app returns to foreground (default: `true`) |
+| `onUpdate` | `(release) => void` | — | Called when a new update is found |
+| `onError` | `(error: Error) => void` | — | Called on check/download errors |
+
+---
+
+## Hooks
+
+### `useOtaUpdate`
+
+Full update state and actions:
+
+```tsx
+const {
+  status,          // UpdateStatus
+  progress,        // number 0–100 during download
+  release,         // release metadata or null
+  error,           // Error | null
+  localBundlePath, // path to downloaded bundle or null
+
+  isLoading,       // checking or downloading
+  hasUpdate,       // status === 'update_available'
+  isReady,         // status === 'ready'
+
+  checkForUpdates, // () => Promise<void>
+  downloadUpdate,  // () => Promise<void>
+  applyUpdate,     // () => Promise<void> — reloads the app
+  rollback,        // () => Promise<void> — removes staged bundle, reloads
+} = useOtaUpdate();
+```
+
+**`UpdateStatus` values**
+
+| Status | Meaning |
+|--------|---------|
+| `idle` | No check has run yet |
+| `checking` | Checking for an update |
+| `up_to_date` | No update available |
+| `update_available` | Update found, not downloaded |
+| `downloading` | Download in progress |
+| `ready` | Downloaded, waiting for `applyUpdate()` |
+| `error` | Last operation failed — see `error` |
+
+---
+
+### `useAutoUpdate`
+
+Automatically downloads mandatory updates. Optionally applies on next foreground.
+
+```tsx
+import { useAutoUpdate } from 'relay-ota-react-native';
+
+const { isReady, applyUpdate } = useAutoUpdate({ applyImmediately: false });
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `applyImmediately` | `boolean` | `false` | Auto-call `applyUpdate()` when bundle is ready |
+
+---
+
+## Rollback
+
+```tsx
+const { rollback } = useOtaUpdate();
+
+// Clears staged bundle and reloads — app falls back to bundled JS
+<Button title="Rollback" onPress={rollback} />
+```
+
+---
+
+## Channels
+
+```tsx
+// Staging builds
+config={{ ..., channel: 'staging' }}
+
+// Production builds
+config={{ ..., channel: 'production' }}
+```
+
+Releases are scoped per-channel on the server — staging users never receive production releases.
+
+---
+
+## Push a release (CLI)
+
+```sh
+# Build the JS bundle
+npx react-native bundle \
+  --platform ios \
+  --dev false \
+  --bundle-output ./main.jsbundle
+
+# Push to your OTA server
+ota release push \
+  --channel production \
+  --bundle ./main.jsbundle
+```
+
+---
+
+## Native module setup (bare React Native only)
+
+> **Expo managed workflow**: skip — the Expo filesystem adapter handles everything.
+
+### iOS
+
+1. Copy `OtaBundleUpdater.h` and `OtaBundleUpdater.m` from `node_modules/relay-ota-react-native/src/native/` into your Xcode project
+2. Run `pod install`
+
+### Android
+
+1. Copy `OtaBundleUpdaterModule.kt` and `OtaBundleUpdaterPackage.kt` into `android/app/src/main/java/<your-package>/`
+2. Register in `MainApplication.kt`:
+
+```kotlin
+override fun getPackages(): List<ReactPackage> =
+  PackageList(this).packages.apply {
+    add(OtaBundleUpdaterPackage())
+  }
+```
+
+---
+
+## TypeScript types
+
+```ts
+import type {
+  OtaConfig,
+  UpdateStatus,
+  UpdateState,
+  IFileSystemAdapter,
+  INativeBundleUpdater,
+  Platform,
+} from 'relay-ota-react-native';
+```
+
+### `OtaConfig`
+
+```ts
+interface OtaConfig {
+  serverUrl: string;
+  appId: string;
+  channel: string;
+  platform: 'IOS' | 'ANDROID';
+  currentVersion: string;
+  runtimeVersion: string;
+  checkOnForeground?: boolean;
+  onUpdate?: (release: Release) => void;
+  onError?: (error: Error) => void;
+}
+```
+
+### `IFileSystemAdapter`
+
+Implement this to bring your own filesystem layer:
+
+```ts
+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>;
+}
+```
+
+---
+
+## Low-level API
+
+```ts
+import {
+  checkForUpdate,  // (serverUrl, request) => Promise<OtaCheckResponse>
+  downloadBundle,  // (release, fs, onProgress) => Promise<string>
+  OtaUpdater,      // Class — manages the full state machine
+} from 'relay-ota-react-native';
+```
+
+---
+
+## Migrating from CodePush
+
+Microsoft retired CodePush in 2025. Relay OTA uses the same update model and a compatible SDK surface. Key differences:
+
+| | CodePush | Relay OTA |
+|---|---|---|
+| Hosting | Vendor (shut down) | Self-hosted, you own it |
+| Source | Closed | Open source (MIT) |
+| Cost | Was paid | Free forever |
+| Rollback | Yes | Yes |
+| Analytics | Basic | Built-in, detailed |
+| Staged rollouts | Yes | Yes |
+
+---
+
+## Links
+
+- **Website:** [relayota.com](https://relayota.com)
+- **Docs:** [relayota.com/docs](https://relayota.com/docs)
+- **GitHub:** [github.com/aglaonematech/relay-ota-react-native](https://github.com/aglaonematech/relay-ota-react-native)
+- **npm:** [relay-ota-react-native](https://www.npmjs.com/package/relay-ota-react-native)
+- **Issues:** [github.com/aglaonematech/relay-ota-react-native/issues](https://github.com/aglaonematech/relay-ota-react-native/issues)
+
+---
+
+## License
+
+MIT — see [LICENSE](https://github.com/aglaonematech/relay-ota-react-native/blob/main/LICENSE)

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import type { OtaCheckRequest, OtaCheckResponse } from './types';
+export declare function checkForUpdate(serverUrl: string, request: OtaCheckRequest): Promise<OtaCheckResponse>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjE,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAa3B"}

package/dist/client.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUpdate = checkForUpdate;
+async function checkForUpdate(serverUrl, request) {
+    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();
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;AAEA,wCAgBC;AAhBM,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,OAAwB;IAExB,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAA+B,CAAC;AACtD,CAAC"}

package/dist/downloader.d.ts

@@ -0,0 +1,6 @@
+import type { IFileSystemAdapter } from './types';
+import type { OtaCheckResponse } from './types';
+type Release = NonNullable<OtaCheckResponse['release']>;
+export declare function downloadBundle(release: Release, fs: IFileSystemAdapter, onProgress?: (progress: number) => void): Promise<string>;
+export {};
+//# sourceMappingURL=downloader.d.ts.map

package/dist/downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../src/downloader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,KAAK,OAAO,GAAG,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;AAExD,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,kBAAkB,EACtB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/downloader.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadBundle = downloadBundle;
+async function downloadBundle(release, fs, onProgress) {
+    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 = [];
+        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) {
+    const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+function uint8ArrayToBase64(bytes) {
+    let binary = '';
+    const len = bytes.byteLength;
+    for (let i = 0; i < len; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+//# sourceMappingURL=downloader.js.map

package/dist/downloader.js.map

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

package/dist/filesystem.d.ts

@@ -0,0 +1,4 @@
+import type { IFileSystemAdapter } from './types';
+export declare function createExpoFileSystemAdapter(): IFileSystemAdapter;
+export declare function createRNFSFileSystemAdapter(): IFileSystemAdapter;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,wBAAgB,2BAA2B,IAAI,kBAAkB,CA8BhE;AAGD,wBAAgB,2BAA2B,IAAI,kBAAkB,CAyBhE"}

package/dist/filesystem.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExpoFileSystemAdapter = createExpoFileSystemAdapter;
+exports.createRNFSFileSystemAdapter = createRNFSFileSystemAdapter;
+// Expo adapter — requires expo-file-system
+function createExpoFileSystemAdapter() {
+    // Lazily require so non-Expo projects don't fail at import time
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const ExpoFS = require('expo-file-system');
+    return {
+        getDocumentDirectory() {
+            return ExpoFS.documentDirectory ?? '';
+        },
+        async exists(path) {
+            const info = await ExpoFS.getInfoAsync(path);
+            return info.exists;
+        },
+        async readAsString(path, encoding) {
+            return ExpoFS.readAsStringAsync(path, {
+                encoding: encoding === 'base64' ? ExpoFS.EncodingType.Base64 : ExpoFS.EncodingType.UTF8,
+            });
+        },
+        async writeAsString(path, content, encoding) {
+            await ExpoFS.writeAsStringAsync(path, content, {
+                encoding: encoding === 'base64' ? ExpoFS.EncodingType.Base64 : ExpoFS.EncodingType.UTF8,
+            });
+        },
+        async deleteFile(path) {
+            await ExpoFS.deleteAsync(path, { idempotent: true });
+        },
+        async makeDirectory(path) {
+            await ExpoFS.makeDirectoryAsync(path, { intermediates: true });
+        },
+    };
+}
+// Bare React Native adapter — requires react-native-fs
+function createRNFSFileSystemAdapter() {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const RNFS = require('react-native-fs');
+    return {
+        getDocumentDirectory() {
+            return `${RNFS.DocumentDirectoryPath}/`;
+        },
+        async exists(path) {
+            return RNFS.exists(path);
+        },
+        async readAsString(path, encoding) {
+            return RNFS.readFile(path, encoding);
+        },
+        async writeAsString(path, content, encoding) {
+            await RNFS.writeFile(path, content, encoding);
+        },
+        async deleteFile(path) {
+            const exists = await RNFS.exists(path);
+            if (exists)
+                await RNFS.unlink(path);
+        },
+        async makeDirectory(path) {
+            await RNFS.mkdir(path);
+        },
+    };
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":";;AAGA,kEA8BC;AAGD,kEAyBC;AA3DD,2CAA2C;AAC3C,SAAgB,2BAA2B;IACzC,gEAAgE;IAChE,8DAA8D;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAQ,CAAC;IAElD,OAAO;QACL,oBAAoB;YAClB,OAAO,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ;YAC/B,OAAO,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;gBACpC,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI;aACxF,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ;YACzC,MAAM,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE;gBAC7C,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI;aACxF,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,IAAI;YACnB,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,IAAI;YACtB,MAAM,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,SAAgB,2BAA2B;IACzC,8DAA8D;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAQ,CAAC;IAE/C,OAAO;QACL,oBAAoB;YAClB,OAAO,GAAG,IAAI,CAAC,qBAAqB,GAAG,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ;YAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ;YACzC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,IAAI;YACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,MAAM;gBAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,IAAI;YACtB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,15 @@
+import type { UpdateState } from './types';
+export interface UseOtaUpdateReturn extends UpdateState {
+    checkForUpdates: () => Promise<void>;
+    downloadUpdate: () => Promise<void>;
+    applyUpdate: () => Promise<void>;
+    rollback: () => Promise<void>;
+    isLoading: boolean;
+    hasUpdate: boolean;
+    isReady: boolean;
+}
+export declare function useOtaUpdate(): UseOtaUpdateReturn;
+export declare function useAutoUpdate(options?: {
+    applyImmediately?: boolean;
+}): UseOtaUpdateReturn;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,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;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,YAAY,IAAI,kBAAkB,CAajD;AAGD,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,sBAerE"}

package/dist/hooks.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOtaUpdate = useOtaUpdate;
+exports.useAutoUpdate = useAutoUpdate;
+const react_1 = require("react");
+const provider_1 = require("./provider");
+function useOtaUpdate() {
+    const { state, checkForUpdates, downloadUpdate, applyUpdate, rollback } = (0, provider_1.useOtaContext)();
+    return {
+        ...state,
+        checkForUpdates: (0, react_1.useCallback)(checkForUpdates, [checkForUpdates]),
+        downloadUpdate: (0, react_1.useCallback)(downloadUpdate, [downloadUpdate]),
+        applyUpdate: (0, react_1.useCallback)(applyUpdate, [applyUpdate]),
+        rollback: (0, react_1.useCallback)(rollback, [rollback]),
+        isLoading: state.status === 'checking' || state.status === 'downloading',
+        hasUpdate: state.status === 'update_available',
+        isReady: state.status === 'ready',
+    };
+}
+// Hook that auto-downloads and applies mandatory updates
+function useAutoUpdate(options) {
+    const ota = useOtaUpdate();
+    const applyImmediately = options?.applyImmediately ?? false;
+    // Auto-download when update is detected
+    if (ota.hasUpdate && ota.release?.isMandatory) {
+        ota.downloadUpdate();
+    }
+    // Auto-apply when ready and applyImmediately is set
+    if (ota.isReady && applyImmediately) {
+        ota.applyUpdate();
+    }
+    return ota;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":";;AAcA,oCAaC;AAGD,sCAeC;AA7CD,iCAAoC;AACpC,yCAA2C;AAa3C,SAAgB,YAAY;IAC1B,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,IAAA,wBAAa,GAAE,CAAC;IAE1F,OAAO;QACL,GAAG,KAAK;QACR,eAAe,EAAE,IAAA,mBAAW,EAAC,eAAe,EAAE,CAAC,eAAe,CAAC,CAAC;QAChE,cAAc,EAAE,IAAA,mBAAW,EAAC,cAAc,EAAE,CAAC,cAAc,CAAC,CAAC;QAC7D,WAAW,EAAE,IAAA,mBAAW,EAAC,WAAW,EAAE,CAAC,WAAW,CAAC,CAAC;QACpD,QAAQ,EAAE,IAAA,mBAAW,EAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC3C,SAAS,EAAE,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa;QACxE,SAAS,EAAE,KAAK,CAAC,MAAM,KAAK,kBAAkB;QAC9C,OAAO,EAAE,KAAK,CAAC,MAAM,KAAK,OAAO;KAClC,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,SAAgB,aAAa,CAAC,OAAwC;IACpE,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,KAAK,CAAC;IAE5D,wCAAwC;IACxC,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAC9C,GAAG,CAAC,cAAc,EAAE,CAAC;IACvB,CAAC;IAED,oDAAoD;IACpD,IAAI,GAAG,CAAC,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACpC,GAAG,CAAC,WAAW,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { OtaProvider, useOtaContext } from './provider';
+export { useOtaUpdate, useAutoUpdate } from './hooks';
+export { OtaUpdater } from './updater';
+export { checkForUpdate } from './client';
+export { downloadBundle } from './downloader';
+export { createExpoFileSystemAdapter, createRNFSFileSystemAdapter } from './filesystem';
+export { isNativeModuleAvailable, setStagedBundlePath, getStagedBundlePath, clearStagedBundlePath, reload, } from './installer';
+export type { OtaConfig, UpdateStatus, UpdateState, IFileSystemAdapter, INativeBundleUpdater, Platform, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,GACT,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reload = exports.clearStagedBundlePath = exports.getStagedBundlePath = exports.setStagedBundlePath = exports.isNativeModuleAvailable = exports.createRNFSFileSystemAdapter = exports.createExpoFileSystemAdapter = exports.downloadBundle = exports.checkForUpdate = exports.OtaUpdater = exports.useAutoUpdate = exports.useOtaUpdate = exports.useOtaContext = exports.OtaProvider = void 0;
+var provider_1 = require("./provider");
+Object.defineProperty(exports, "OtaProvider", { enumerable: true, get: function () { return provider_1.OtaProvider; } });
+Object.defineProperty(exports, "useOtaContext", { enumerable: true, get: function () { return provider_1.useOtaContext; } });
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "useOtaUpdate", { enumerable: true, get: function () { return hooks_1.useOtaUpdate; } });
+Object.defineProperty(exports, "useAutoUpdate", { enumerable: true, get: function () { return hooks_1.useAutoUpdate; } });
+var updater_1 = require("./updater");
+Object.defineProperty(exports, "OtaUpdater", { enumerable: true, get: function () { return updater_1.OtaUpdater; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "checkForUpdate", { enumerable: true, get: function () { return client_1.checkForUpdate; } });
+var downloader_1 = require("./downloader");
+Object.defineProperty(exports, "downloadBundle", { enumerable: true, get: function () { return downloader_1.downloadBundle; } });
+var filesystem_1 = require("./filesystem");
+Object.defineProperty(exports, "createExpoFileSystemAdapter", { enumerable: true, get: function () { return filesystem_1.createExpoFileSystemAdapter; } });
+Object.defineProperty(exports, "createRNFSFileSystemAdapter", { enumerable: true, get: function () { return filesystem_1.createRNFSFileSystemAdapter; } });
+var installer_1 = require("./installer");
+Object.defineProperty(exports, "isNativeModuleAvailable", { enumerable: true, get: function () { return installer_1.isNativeModuleAvailable; } });
+Object.defineProperty(exports, "setStagedBundlePath", { enumerable: true, get: function () { return installer_1.setStagedBundlePath; } });
+Object.defineProperty(exports, "getStagedBundlePath", { enumerable: true, get: function () { return installer_1.getStagedBundlePath; } });
+Object.defineProperty(exports, "clearStagedBundlePath", { enumerable: true, get: function () { return installer_1.clearStagedBundlePath; } });
+Object.defineProperty(exports, "reload", { enumerable: true, get: function () { return installer_1.reload; } });
+//# sourceMappingURL=index.js.map