@rovq/react-native 0.1.0 → 0.2.0

package/src/update-flow.ts

@@ -0,0 +1,91 @@
+import { RovqError } from './errors';
+import { checkForUpdate, downloadUpdate, installUpdate, restartApp } from './api';
+import type { UpdateInfo } from './api';
+
+/**
+ * - `background`: downloads without showing anything. The update loads on the next start.
+ * - `foreground`: shows progress, then restarts the app as soon as the update is ready.
+ * - `auto`: foreground for a release published with `--mandatory`, background otherwise.
+ */
+export type UpdateMode = 'background' | 'foreground' | 'auto';
+
+export type UpdatePhase =
+  | 'idle'
+  | 'checking'
+  | 'upToDate'
+  | 'downloading'
+  | 'installing'
+  /** Installed in the background. It loads on the next start. */
+  | 'ready'
+  /** About to restart, in the foreground. */
+  | 'restarting'
+  | 'error';
+
+export interface UpdateState {
+  phase: UpdatePhase;
+  /** From 0 to 1 while downloading, otherwise null. */
+  progress: number | null;
+  update: UpdateInfo | null;
+  /** True once an update was found that this mode handles in the foreground. */
+  foreground: boolean;
+  error: RovqError | null;
+}
+
+export const INITIAL_STATE: UpdateState = {
+  phase: 'idle',
+  progress: null,
+  update: null,
+  foreground: false,
+  error: null,
+};
+
+/**
+ * Checks, downloads, and installs, reporting each step. It never throws: a failure ends in the
+ * `error` phase, and the app keeps running what it has.
+ */
+export async function runUpdateFlow(
+  mode: UpdateMode,
+  report: (state: UpdateState) => void,
+): Promise<UpdateState> {
+  let state: UpdateState = { ...INITIAL_STATE, phase: 'checking' };
+  const set = (change: Partial<UpdateState>) => {
+    state = { ...state, ...change };
+    report(state);
+    return state;
+  };
+  report(state);
+
+  try {
+    const check = await checkForUpdate();
+    if (check.status === 'ROLLED_BACK') {
+      // The server stopped this release. In the foreground, go back right away.
+      if (mode === 'foreground') {
+        set({ phase: 'restarting', foreground: true });
+        restartApp();
+        return state;
+      }
+      return set({ phase: 'ready' });
+    }
+    if (check.status === 'UP_TO_DATE') return set({ phase: 'upToDate' });
+
+    const foreground = mode === 'foreground' || (mode === 'auto' && check.update.mandatory);
+    set({ phase: 'downloading', update: check.update, foreground, progress: 0 });
+    await downloadUpdate({
+      onProgress: ({ receivedBytes, totalBytes }) =>
+        set({ progress: totalBytes > 0 ? receivedBytes / totalBytes : 0 }),
+    });
+    set({ phase: 'installing', progress: 1 });
+    await installUpdate();
+
+    if (!foreground) return set({ phase: 'ready', progress: null });
+    set({ phase: 'restarting' });
+    restartApp();
+    return state;
+  } catch (error) {
+    const rovqError =
+      error instanceof RovqError
+        ? error
+        : new RovqError('UNKNOWN', error instanceof Error ? error.message : String(error));
+    return set({ phase: 'error', error: rovqError, progress: null });
+  }
+}