@rific/updater 0.3.2 → 0.4.0

package/README.md

@@ -55,6 +55,16 @@ const { check, checking } = useUpdater({
 })
 ```
 
+### With custom info alerts
+
+```tsx
+const { check, checking } = useUpdater({
+  onInfo: (title, message) => myInfoDialog(title, message),
+})
+```
+
+Covers `check()`'s three purely-informational cases — dev-mode disabled, web unsupported, and "you're already up to date" — none of which need a confirm/cancel choice, just something to acknowledge. Defaults to `Alert.alert` like `onError`.
+
 ### Disable automatic mount/foreground checks entirely
 
 ```tsx
@@ -83,6 +93,7 @@ interface UseUpdaterOptions {
   autoPrompt?: boolean                                   // default: true
   onConfirm?: (manifest: UpdateManifest) => Promise<boolean>
   onError?: (message: string) => void
+  onInfo?: (title: string, message: string) => void
 }
 
 interface UseUpdaterReturn {
@@ -96,8 +107,9 @@ interface UseUpdaterReturn {
 |--------|---------|-------------|
 | `autoCheck` | `true` | Fetches available updates once on mount and again via an `AppState` listener whenever the app comes to the foreground. Disable for apps that want full manual control. |
 | `autoPrompt` | `true` | When a mount or foreground `autoCheck` fetch finds an update, run the confirmation dialog (and reload on confirm) immediately. Set `false` to fall back to the old behavior — silently stage it for a manual `check()` or the next cold launch instead. Ignored if `autoCheck` is `false`. A manual `check()` call and an auto-prompt won't run concurrently — whichever is in flight blocks the other. |
-| `onConfirm` | — | Custom confirmation dialog. Receives the update manifest, must return `Promise<boolean>` — `true` to reload, `false` to cancel. Defaults to a native `Alert` showing the release date and metadata message. |
+| `onConfirm` | — | Custom confirmation dialog. Receives the update manifest, must return `Promise<boolean>` — `true` to reload, `false` to cancel. Defaults to a native `Alert` showing the release date. |
 | `onError` | — | Called with an error message string if `check()` throws. Defaults to `Alert.alert`. |
+| `onInfo` | — | Called with `(title, message)` for `check()`'s purely-informational cases (dev-mode disabled, web unsupported, no update found) — no confirm/cancel choice, just an acknowledgeable message. Defaults to `Alert.alert`. |
 
 | Return | Description |
 |--------|-------------|
@@ -158,6 +170,7 @@ The path argument defaults to `src/constants/release.ts` if omitted.
 - `autoPrompt`'s foreground flow shares that same `checkingRef` guard with `check()`, so a manual check and an auto-prompt can't both be mid-confirm at once
 - `updateReady` and the staged manifest ref are cleared in `finally` so they reset on both confirm and cancel
 - `onConfirm` replaces the default `Alert` entirely — useful in apps that have their own dialog primitive (e.g. a `select()` utility or bottom sheet)
+- `onInfo` is the same idea for `check()`'s three non-choice messages (dev-mode disabled, web unsupported, no update found) — separate from `onConfirm` because there's nothing to confirm, just something to show
 - No Provider or context required — the hook is self-contained
 
 ---

package/dist/index.d.mts

@@ -1,6 +1,5 @@
 interface UpdateManifest {
     createdAt: string;
-    metadata?: Record<string, string | undefined>;
 }
 
 interface UseUpdaterOptions {
@@ -8,6 +7,7 @@ interface UseUpdaterOptions {
     autoPrompt?: boolean;
     onConfirm?: (manifest: UpdateManifest) => Promise<boolean>;
     onError?: (message: string) => void;
+    onInfo?: (title: string, message: string) => void;
 }
 interface UseUpdaterReturn {
     check: () => Promise<void>;

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 interface UpdateManifest {
     createdAt: string;
-    metadata?: Record<string, string | undefined>;
 }
 
 interface UseUpdaterOptions {
@@ -8,6 +7,7 @@ interface UseUpdaterOptions {
     autoPrompt?: boolean;
     onConfirm?: (manifest: UpdateManifest) => Promise<boolean>;
     onError?: (message: string) => void;
+    onInfo?: (title: string, message: string) => void;
 }
 interface UseUpdaterReturn {
     check: () => Promise<void>;

package/dist/index.js

@@ -42,11 +42,9 @@ var checkForUpdate = async () => {
 var import_react_native = require("react-native");
 var getUpdateConfirmation = (manifest) => {
   const date = new Date(manifest.createdAt);
-  let info = `A new update was released on ${date.toLocaleDateString()} at ${date.toLocaleTimeString()}.`;
-  if (manifest.metadata?.message) info += `
+  const info = `A new update was released on ${date.toLocaleDateString()} at ${date.toLocaleTimeString()}.
 
-Message: ${manifest.metadata.message}.`;
-  info += "\n\nRestart app to update.";
+Restart app to update.`;
   return new Promise((resolve) => {
     import_react_native.Alert.alert("Update available", info, [
       { text: "Cancel", style: "cancel", onPress: () => resolve(false) },
@@ -58,19 +56,24 @@ Message: ${manifest.metadata.message}.`;
 // src/useUpdater.ts
 var isUnsupported = () => __DEV__ || import_react_native2.Platform.OS === "web";
 var useUpdater = (options = {}) => {
-  const { autoCheck = true, autoPrompt = true, onConfirm, onError } = options;
+  const { autoCheck = true, autoPrompt = true, onConfirm, onError, onInfo } = options;
   const [checking, setChecking] = (0, import_react.useState)(false);
   const [updateReady, setUpdateReady] = (0, import_react.useState)(false);
   const checkingRef = (0, import_react.useRef)(false);
+  const autoCheckPendingRef = (0, import_react.useRef)(false);
   const appState = (0, import_react.useRef)(import_react_native2.AppState.currentState);
   const stagedManifest = (0, import_react.useRef)(null);
   const onConfirmRef = (0, import_react.useRef)(onConfirm);
   const onErrorRef = (0, import_react.useRef)(onError);
-  onConfirmRef.current = onConfirm;
-  onErrorRef.current = onError;
+  (0, import_react.useEffect)(() => {
+    onConfirmRef.current = onConfirm;
+    onErrorRef.current = onError;
+  });
   (0, import_react.useEffect)(() => {
     if (!autoCheck || isUnsupported()) return;
     const runAutoCheck = () => {
+      if (autoCheckPendingRef.current) return;
+      autoCheckPendingRef.current = true;
       checkForUpdate().then(async (manifest) => {
         if (!manifest) return;
         stagedManifest.current = manifest;
@@ -93,6 +96,8 @@ var useUpdater = (options = {}) => {
           setChecking(false);
         }
       }).catch(() => {
+      }).finally(() => {
+        autoCheckPendingRef.current = false;
       });
     };
     runAutoCheck();
@@ -106,11 +111,15 @@ var useUpdater = (options = {}) => {
   }, [autoCheck, autoPrompt]);
   const check = async () => {
     if (__DEV__) {
-      import_react_native2.Alert.alert("Updates unavailable", "Update checks are disabled in development mode.");
+      const message = "Update checks are disabled in development mode.";
+      if (onInfo) onInfo("Updates unavailable", message);
+      else import_react_native2.Alert.alert("Updates unavailable", message);
       return;
     }
     if (import_react_native2.Platform.OS === "web") {
-      import_react_native2.Alert.alert("Updates unavailable", "Update checks are not supported on web.");
+      const message = "Update checks are not supported on web.";
+      if (onInfo) onInfo("Updates unavailable", message);
+      else import_react_native2.Alert.alert("Updates unavailable", message);
       return;
     }
     if (checkingRef.current) return;
@@ -119,7 +128,9 @@ var useUpdater = (options = {}) => {
     try {
       const manifest = stagedManifest.current ?? await checkForUpdate();
       if (!manifest) {
-        import_react_native2.Alert.alert("No update", "You are on the most recent version.");
+        const message = "You are on the most recent version.";
+        if (onInfo) onInfo("No update", message);
+        else import_react_native2.Alert.alert("No update", message);
         return;
       }
       const confirmFn = onConfirm ?? getUpdateConfirmation;

package/dist/index.mjs

@@ -16,11 +16,9 @@ var checkForUpdate = async () => {
 import { Alert } from "react-native";
 var getUpdateConfirmation = (manifest) => {
   const date = new Date(manifest.createdAt);
-  let info = `A new update was released on ${date.toLocaleDateString()} at ${date.toLocaleTimeString()}.`;
-  if (manifest.metadata?.message) info += `
+  const info = `A new update was released on ${date.toLocaleDateString()} at ${date.toLocaleTimeString()}.
 
-Message: ${manifest.metadata.message}.`;
-  info += "\n\nRestart app to update.";
+Restart app to update.`;
   return new Promise((resolve) => {
     Alert.alert("Update available", info, [
       { text: "Cancel", style: "cancel", onPress: () => resolve(false) },
@@ -32,19 +30,24 @@ Message: ${manifest.metadata.message}.`;
 // src/useUpdater.ts
 var isUnsupported = () => __DEV__ || Platform.OS === "web";
 var useUpdater = (options = {}) => {
-  const { autoCheck = true, autoPrompt = true, onConfirm, onError } = options;
+  const { autoCheck = true, autoPrompt = true, onConfirm, onError, onInfo } = options;
   const [checking, setChecking] = useState(false);
   const [updateReady, setUpdateReady] = useState(false);
   const checkingRef = useRef(false);
+  const autoCheckPendingRef = useRef(false);
   const appState = useRef(AppState.currentState);
   const stagedManifest = useRef(null);
   const onConfirmRef = useRef(onConfirm);
   const onErrorRef = useRef(onError);
-  onConfirmRef.current = onConfirm;
-  onErrorRef.current = onError;
+  useEffect(() => {
+    onConfirmRef.current = onConfirm;
+    onErrorRef.current = onError;
+  });
   useEffect(() => {
     if (!autoCheck || isUnsupported()) return;
     const runAutoCheck = () => {
+      if (autoCheckPendingRef.current) return;
+      autoCheckPendingRef.current = true;
       checkForUpdate().then(async (manifest) => {
         if (!manifest) return;
         stagedManifest.current = manifest;
@@ -67,6 +70,8 @@ var useUpdater = (options = {}) => {
           setChecking(false);
         }
       }).catch(() => {
+      }).finally(() => {
+        autoCheckPendingRef.current = false;
       });
     };
     runAutoCheck();
@@ -80,11 +85,15 @@ var useUpdater = (options = {}) => {
   }, [autoCheck, autoPrompt]);
   const check = async () => {
     if (__DEV__) {
-      Alert2.alert("Updates unavailable", "Update checks are disabled in development mode.");
+      const message = "Update checks are disabled in development mode.";
+      if (onInfo) onInfo("Updates unavailable", message);
+      else Alert2.alert("Updates unavailable", message);
       return;
     }
     if (Platform.OS === "web") {
-      Alert2.alert("Updates unavailable", "Update checks are not supported on web.");
+      const message = "Update checks are not supported on web.";
+      if (onInfo) onInfo("Updates unavailable", message);
+      else Alert2.alert("Updates unavailable", message);
       return;
     }
     if (checkingRef.current) return;
@@ -93,7 +102,9 @@ var useUpdater = (options = {}) => {
     try {
       const manifest = stagedManifest.current ?? await checkForUpdate();
       if (!manifest) {
-        Alert2.alert("No update", "You are on the most recent version.");
+        const message = "You are on the most recent version.";
+        if (onInfo) onInfo("No update", message);
+        else Alert2.alert("No update", message);
         return;
       }
       const confirmFn = onConfirm ?? getUpdateConfirmation;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rific/updater",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "OTA update hook for Expo apps. Silent background fetch on foreground, manual check with confirmation dialog",
   "keywords": [
     "expo",
@@ -67,6 +67,7 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-package-json": "^1.0.0",
     "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-native": "^5.0.0",
     "eslint-plugin-simple-import-sort": "^13.0.0",
     "expo-updates": ">=0.25.0",

package/src/getUpdateConfirmation.ts

@@ -4,9 +4,7 @@ import { UpdateManifest } from './types'
 
 export const getUpdateConfirmation = (manifest: UpdateManifest): Promise<boolean> => {
   const date = new Date(manifest.createdAt)
-  let info = `A new update was released on ${date.toLocaleDateString()} at ${date.toLocaleTimeString()}.`
-  if (manifest.metadata?.message) info += `\n\nMessage: ${manifest.metadata.message}.`
-  info += '\n\nRestart app to update.'
+  const info = `A new update was released on ${date.toLocaleDateString()} at ${date.toLocaleTimeString()}.\n\nRestart app to update.`
 
   return new Promise((resolve) => {
     Alert.alert('Update available', info, [

package/src/types.ts

@@ -1,4 +1,3 @@
 export interface UpdateManifest {
   createdAt: string
-  metadata?: Record<string, string | undefined>
 }

package/src/useUpdater.ts

@@ -11,6 +11,11 @@ export interface UseUpdaterOptions {
   autoPrompt?: boolean
   onConfirm?: (manifest: UpdateManifest) => Promise<boolean>
   onError?: (message: string) => void
+  // Purely informational — no confirm/cancel choice, just something to acknowledge. Covers the
+  // three plain Alert.alert calls inside check() below (dev-mode disabled, web unsupported, and
+  // "you're already up to date") — none of them go through onConfirm, since there's no decision
+  // to make.
+  onInfo?: (title: string, message: string) => void
 }
 
 export interface UseUpdaterReturn {
@@ -22,23 +27,33 @@ export interface UseUpdaterReturn {
 const isUnsupported = () => __DEV__ || Platform.OS === 'web'
 
 export const useUpdater = (options: UseUpdaterOptions = {}): UseUpdaterReturn => {
-  const { autoCheck = true, autoPrompt = true, onConfirm, onError } = options
+  const { autoCheck = true, autoPrompt = true, onConfirm, onError, onInfo } = options
   const [checking, setChecking] = useState(false)
   const [updateReady, setUpdateReady] = useState(false)
   const checkingRef = useRef(false)
+  const autoCheckPendingRef = useRef(false)
   const appState = useRef(AppState.currentState)
   const stagedManifest = useRef<UpdateManifest | null>(null)
   // Read via refs inside the AppState listener so onConfirm/onError identity changes (e.g. an
   // inline arrow function) don't tear down and re-subscribe the listener on every render.
   const onConfirmRef = useRef(onConfirm)
   const onErrorRef = useRef(onError)
-  onConfirmRef.current = onConfirm
-  onErrorRef.current = onError
+
+  useEffect(() => {
+    onConfirmRef.current = onConfirm
+    onErrorRef.current = onError
+  })
 
   useEffect(() => {
     if (!autoCheck || isUnsupported()) return
 
     const runAutoCheck = () => {
+      // Guards against overlapping fetches if AppState fires again (e.g. rapid app-switcher
+      // transitions) before a prior auto-check has resolved. Independent of checkingRef, which
+      // only guards the confirmation prompt and covers manual check() calls too.
+      if (autoCheckPendingRef.current) return
+      autoCheckPendingRef.current = true
+
       checkForUpdate()
         .then(async (manifest) => {
           if (!manifest) return
@@ -64,6 +79,9 @@ export const useUpdater = (options: UseUpdaterOptions = {}): UseUpdaterReturn =>
           }
         })
         .catch(() => {})
+        .finally(() => {
+          autoCheckPendingRef.current = false
+        })
     }
 
     // Cold launch: run the same check+prompt flow as a foreground resume so update
@@ -82,11 +100,15 @@ export const useUpdater = (options: UseUpdaterOptions = {}): UseUpdaterReturn =>
 
   const check = async (): Promise<void> => {
     if (__DEV__) {
-      Alert.alert('Updates unavailable', 'Update checks are disabled in development mode.')
+      const message = 'Update checks are disabled in development mode.'
+      if (onInfo) onInfo('Updates unavailable', message)
+      else Alert.alert('Updates unavailable', message)
       return
     }
     if (Platform.OS === 'web') {
-      Alert.alert('Updates unavailable', 'Update checks are not supported on web.')
+      const message = 'Update checks are not supported on web.'
+      if (onInfo) onInfo('Updates unavailable', message)
+      else Alert.alert('Updates unavailable', message)
       return
     }
     if (checkingRef.current) return
@@ -95,7 +117,9 @@ export const useUpdater = (options: UseUpdaterOptions = {}): UseUpdaterReturn =>
     try {
       const manifest = stagedManifest.current ?? (await checkForUpdate())
       if (!manifest) {
-        Alert.alert('No update', 'You are on the most recent version.')
+        const message = 'You are on the most recent version.'
+        if (onInfo) onInfo('No update', message)
+        else Alert.alert('No update', message)
         return
       }
       const confirmFn = onConfirm ?? getUpdateConfirmation