@forthtilliath/expo-release-updates-ui 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Forthtilliath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# @forthtilliath/expo-release-updates-ui
+
+React Native UI for self-updating a sideloaded Android Expo app: release notes rendering, a dismissible "update available" banner, and a hook to check for updates once per mount. No opinion on your app's theme. Pairs with [`@forthtilliath/expo-release-updates`](../expo-release-updates#readme) (the framework-agnostic logic — checking GitHub releases, comparing versions, downloading the APK), kept in a separate package so that logic stays usable without pulling in React/React Native.
+
+## Install
+
+```bash
+npm install @forthtilliath/expo-release-updates-ui @forthtilliath/expo-release-updates react react-native
+```
+
+Or, from within this monorepo, as a workspace dependency:
+
+```json
+{
+  "dependencies": {
+    "@forthtilliath/expo-release-updates-ui": "workspace:*"
+  }
+}
+```
+
+`react` and `react-native` are peer dependencies — install them in the consuming app if not already present.
+
+## Usage
+
+Each export is its own module — import the file you need directly, or use the barrel to pull everything from a single import:
+
+```ts
+import { ChangelogNotes } from "@forthtilliath/expo-release-updates-ui/ChangelogNotes";
+import { UpdateAvailableBanner } from "@forthtilliath/expo-release-updates-ui/UpdateAvailableBanner";
+import { useUpdateCheck } from "@forthtilliath/expo-release-updates-ui/useUpdateCheck";
+
+// Or, everything at once:
+import {
+  ChangelogNotes,
+  UpdateAvailableBanner,
+  useUpdateCheck,
+} from "@forthtilliath/expo-release-updates-ui";
+```
+
+### `useUpdateCheck(options)`
+
+Checks once per mount (e.g. app launch) whether a newer release is available, throttled to at most one real check per `minIntervalMs` (default 12h) and silent for a release the user already dismissed. Has no opinion on where "when did we last check" / "which version did the user dismiss" are persisted — both are read/written entirely through the options you pass in.
+
+```tsx
+import { useUpdateCheck } from "@forthtilliath/expo-release-updates-ui";
+import {
+  compareVersions,
+  fetchLatestRelease,
+} from "@forthtilliath/expo-release-updates";
+
+const update = useUpdateCheck({
+  currentVersion: Constants.expoConfig?.version ?? "0.0.0",
+  checkForUpdate: fetchLatestRelease,
+  compareVersions,
+  getLastCheck: () => ({
+    lastCheckedAt: settings?.lastUpdateCheckAt ?? null,
+    dismissedVersion: settings?.dismissedUpdateVersion ?? null,
+  }),
+  onChecked: (lastCheckedAt) =>
+    updateSettings({ lastUpdateCheckAt: lastCheckedAt }),
+});
+
+if (update.status === "available") {
+  // update.release.version / .notes / .apkUrl
+}
+```
+
+### `<ChangelogNotes notes={...} styles={...} />`
+
+Renders GitHub-style release notes — as produced by `@forthtilliath/expo-release-updates`'s `parseChangelogNotes` — as headings, bulleted items, and bold-aware text, instead of showing the raw Markdown syntax in a plain `Text`.
+
+```tsx
+<ChangelogNotes notes={release.notes} />
+```
+
+It understands the small subset of Markdown GitHub release notes actually use:
+
+| `notes` input                             | Rendered as                                                                 |
+| ----------------------------------------- | --------------------------------------------------------------------------- |
+| `### Added`                               | a heading `Text` — `"Added"`                                                |
+| `- Export history to CSV.`                | a row (`View`) with a `•` bullet `Text` and an item `Text`                  |
+| `**Auto-backup**: saves every 5 minutes.` | a plain `Text`, with the bold segment split into its own bold-styled `Text` |
+
+A full example, mixing all three:
+
+```tsx
+<ChangelogNotes
+  notes={`### Added\n- **Auto-backup**: saves every 5 minutes.\n- Export history to CSV.\n\nSee the full changelog for details.`}
+/>
+```
+
+The component ships with neutral default styles and no opinion on your app's theme. Override any subset via the `styles` prop to match your colors/dark mode:
+
+```tsx
+<ChangelogNotes
+  notes={release.notes}
+  styles={{
+    heading: { color: colors.text, fontWeight: "700" },
+    itemRow: { gap: 8 },
+    bullet: { color: colors.primary },
+    itemText: { color: colors.textMuted },
+    text: { color: colors.textMuted },
+    bold: { color: colors.text, fontWeight: "700" },
+  }}
+/>
+```
+
+Every field of `styles` is optional — pass only the ones you want to override; the rest fall back to the defaults (`ChangelogNotesStyles` in `ChangelogNotes.tsx`).
+
+### `<UpdateAvailableBanner version notes onPress onDismiss />`
+
+Dismissible banner announcing an available update: version, release notes (rendered via `ChangelogNotes`), an action button and a dismiss button. Has no opinion on what the action does (e.g. navigate to an update screen) or on how/whether dismissal is persisted.
+
+```tsx
+import { UpdateAvailableBanner } from "@forthtilliath/expo-release-updates-ui";
+
+{
+  update.status === "available" && (
+    <UpdateAvailableBanner
+      version={update.release.version}
+      notes={update.release.notes}
+      onPress={() => router.push("/settings/update")}
+      onDismiss={() => {
+        dismissUpdateVersion(update.release.version);
+        update.dismiss();
+      }}
+    />
+  );
+}
+```
+
+## Scripts
+
+```bash
+pnpm run dev            # tsc --watch -> dist/
+pnpm run build          # tsc -> dist/
+pnpm run check-types    # tsc --noEmit
+pnpm run lint           # eslint
+pnpm run test           # vitest run
+pnpm run test:watch     # vitest
+```
+
+Built to `dist/` (see the `exports` field in `package.json`), so run `pnpm run build` (or `dev`) after source changes for consumers to see them.

package/dist/ChangelogNotes.d.ts

@@ -0,0 +1,22 @@
+import type { StyleProp, TextStyle, ViewStyle } from "react-native";
+export interface ChangelogNotesStyles {
+    heading?: StyleProp<TextStyle>;
+    itemRow?: StyleProp<ViewStyle>;
+    bullet?: StyleProp<TextStyle>;
+    itemText?: StyleProp<TextStyle>;
+    text?: StyleProp<TextStyle>;
+    bold?: StyleProp<TextStyle>;
+}
+export interface ChangelogNotesProps {
+    /** Raw release notes, e.g. straight from a GitHub release body. */
+    notes: string;
+    /** Override any of the default styles to match your app's theme. */
+    styles?: ChangelogNotesStyles;
+}
+/**
+ * Renders GitHub-style release notes (parsed by `parseChangelogNotes`) as
+ * headings, bulleted items and bold-aware text, instead of showing the raw
+ * Markdown syntax in a plain `<Text>`.
+ */
+export declare function ChangelogNotes({ notes, styles }: ChangelogNotesProps): import("react").JSX.Element;
+//# sourceMappingURL=ChangelogNotes.d.ts.map

package/dist/ChangelogNotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangelogNotes.d.ts","sourceRoot":"","sources":["../src/ChangelogNotes.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAMpE,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AA0BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,mBAAmB,+BA+CpE"}

package/dist/ChangelogNotes.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Text, View } from "react-native";
+import { parseChangelogNotes } from "@forthtilliath/expo-release-updates/parseChangelogNotes";
+// Reasonable, neutral defaults so the component works with zero
+// configuration — most consumers will still want to pass `styles` to match
+// their own theme (colors, dark mode, ...), which this package has no
+// opinion on.
+const defaultStyles = {
+    heading: { fontSize: 13, fontWeight: "700", color: "#111827", marginTop: 8 },
+    itemRow: { flexDirection: "row", gap: 6, marginTop: 4 },
+    bullet: { fontSize: 13, color: "#6b7280" },
+    itemText: { flex: 1, fontSize: 13, color: "#6b7280" },
+    text: { fontSize: 13, color: "#6b7280" },
+    bold: { fontWeight: "700", color: "#111827" },
+};
+function renderSegments(segments, boldStyle) {
+    return segments.map((segment) => (_jsx(Text, { style: segment.bold ? boldStyle : undefined, children: segment.text }, segment.text)));
+}
+/**
+ * Renders GitHub-style release notes (parsed by `parseChangelogNotes`) as
+ * headings, bulleted items and bold-aware text, instead of showing the raw
+ * Markdown syntax in a plain `<Text>`.
+ */
+export function ChangelogNotes({ notes, styles }) {
+    // Each field is merged as a style array (default, then override) rather
+    // than the override replacing the whole default outright — so passing e.g.
+    // `styles={{ heading: { color: "red" } }}` only changes the color instead
+    // of silently dropping the default's fontSize/fontWeight/marginTop too.
+    const merged = {
+        heading: [defaultStyles.heading, styles?.heading],
+        itemRow: [defaultStyles.itemRow, styles?.itemRow],
+        bullet: [defaultStyles.bullet, styles?.bullet],
+        itemText: [defaultStyles.itemText, styles?.itemText],
+        text: [defaultStyles.text, styles?.text],
+        bold: [defaultStyles.bold, styles?.bold],
+    };
+    const blocks = parseChangelogNotes(notes);
+    return (_jsx(_Fragment, { children: blocks.map((block, index) => {
+            // Blocks have no stable identity of their own (plain parsed lines),
+            // so the index is the only reasonable key — the list is never
+            // reordered or filtered after the initial parse.
+            const key = `${block.type}-${String(index)}`;
+            if (block.type === "heading") {
+                return (_jsx(Text, { style: merged.heading, children: block.text }, key));
+            }
+            if (block.type === "item") {
+                return (_jsxs(View, { style: merged.itemRow, children: [_jsx(Text, { style: merged.bullet, children: "\u2022" }), _jsx(Text, { style: merged.itemText, children: renderSegments(block.segments, merged.bold) })] }, key));
+            }
+            return (_jsx(Text, { style: merged.text, children: renderSegments(block.segments, merged.bold) }, key));
+        }) }));
+}

package/dist/UpdateAvailableBanner.d.ts

@@ -0,0 +1,29 @@
+import type { StyleProp, TextStyle, ViewStyle } from "react-native";
+import type { ChangelogNotesStyles } from "./ChangelogNotes.js";
+export interface UpdateAvailableBannerStyles {
+    container?: StyleProp<ViewStyle>;
+    header?: StyleProp<ViewStyle>;
+    title?: StyleProp<TextStyle>;
+    notes?: ChangelogNotesStyles;
+    actionButton?: StyleProp<ViewStyle>;
+    actionButtonText?: StyleProp<TextStyle>;
+    dismissButton?: StyleProp<ViewStyle>;
+    dismissButtonText?: StyleProp<TextStyle>;
+}
+export interface UpdateAvailableBannerLabels {
+    title?: (version: string) => string;
+    action?: string;
+    dismiss?: string;
+    dismissAccessibilityLabel?: string;
+}
+export interface UpdateAvailableBannerProps {
+    version: string;
+    /** Raw release notes, passed straight to `ChangelogNotes`. */
+    notes: string;
+    onPress: () => void;
+    onDismiss: () => void;
+    labels?: UpdateAvailableBannerLabels;
+    styles?: UpdateAvailableBannerStyles;
+}
+export declare function UpdateAvailableBanner({ version, notes, onPress, onDismiss, labels, styles, }: UpdateAvailableBannerProps): import("react").JSX.Element;
+//# sourceMappingURL=UpdateAvailableBanner.d.ts.map

package/dist/UpdateAvailableBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateAvailableBanner.d.ts","sourceRoot":"","sources":["../src/UpdateAvailableBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,iBAAiB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC;AAwCD,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,MAAM,GACP,EAAE,0BAA0B,+BA+C5B"}

package/dist/UpdateAvailableBanner.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Pressable, Text, View } from "react-native";
+import { ChangelogNotes } from "./ChangelogNotes.js";
+const defaultStyles = {
+    container: {
+        backgroundColor: "#ffffff",
+        borderWidth: 1,
+        borderColor: "#e5e7eb",
+        borderRadius: 10,
+        padding: 14,
+        gap: 8,
+    },
+    header: {
+        flexDirection: "row",
+        justifyContent: "space-between",
+        alignItems: "center",
+    },
+    title: { fontSize: 15, fontWeight: "700", color: "#111827" },
+    notes: {},
+    actionButton: {
+        backgroundColor: "#2563eb",
+        borderRadius: 10,
+        paddingVertical: 10,
+        alignItems: "center",
+    },
+    actionButtonText: { color: "#ffffff", fontSize: 14, fontWeight: "700" },
+    dismissButton: { padding: 4 },
+    dismissButtonText: { fontSize: 13, color: "#6b7280" },
+};
+const defaultLabels = {
+    title: (version) => `Version ${version} disponible`,
+    action: "Voir",
+    dismiss: "Fermer",
+    dismissAccessibilityLabel: "Fermer la notification de mise à jour",
+};
+// Dismissible banner announcing an available update: version, release notes
+// (via `ChangelogNotes`), and an action + dismiss button. Has no opinion on
+// what "action" does (e.g. navigate to an update screen) or on how/whether
+// dismissal is persisted — both are left entirely to the caller.
+export function UpdateAvailableBanner({ version, notes, onPress, onDismiss, labels, styles, }) {
+    // Style fields are merged as arrays (default, then override) so a partial
+    // override only changes the properties it specifies instead of replacing
+    // the whole default style object. `notes` is forwarded as-is to
+    // ChangelogNotes, which does its own equivalent merge against its defaults.
+    const merged = {
+        container: [defaultStyles.container, styles?.container],
+        header: [defaultStyles.header, styles?.header],
+        title: [defaultStyles.title, styles?.title],
+        notes: styles?.notes ?? defaultStyles.notes,
+        actionButton: [defaultStyles.actionButton, styles?.actionButton],
+        actionButtonText: [
+            defaultStyles.actionButtonText,
+            styles?.actionButtonText,
+        ],
+        dismissButton: [defaultStyles.dismissButton, styles?.dismissButton],
+        dismissButtonText: [
+            defaultStyles.dismissButtonText,
+            styles?.dismissButtonText,
+        ],
+    };
+    const t = { ...defaultLabels, ...labels };
+    return (_jsxs(View, { style: merged.container, children: [_jsxs(View, { style: merged.header, children: [_jsx(Text, { style: merged.title, children: t.title(version) }), _jsx(Pressable, { style: merged.dismissButton, onPress: onDismiss, accessibilityRole: "button", accessibilityLabel: t.dismissAccessibilityLabel, children: _jsx(Text, { style: merged.dismissButtonText, children: t.dismiss }) })] }), notes ? _jsx(ChangelogNotes, { notes: notes, styles: merged.notes }) : null, _jsx(Pressable, { style: merged.actionButton, onPress: onPress, accessibilityRole: "button", accessibilityLabel: t.action, children: _jsx(Text, { style: merged.actionButtonText, children: t.action }) })] }));
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./ChangelogNotes.js";
+export * from "./UpdateAvailableBanner.js";
+export * from "./useUpdateCheck.js";
+//# 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,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./ChangelogNotes.js";
+export * from "./UpdateAvailableBanner.js";
+export * from "./useUpdateCheck.js";

package/dist/useUpdateCheck.d.ts

@@ -0,0 +1,35 @@
+export interface UpdateCheckRelease {
+    version: string;
+    notes: string;
+    apkUrl: string;
+}
+export type UpdateCheckState = {
+    status: "idle";
+} | {
+    status: "available";
+    release: UpdateCheckRelease;
+} | {
+    status: "error";
+};
+export interface UseUpdateCheckOptions {
+    /** The app's currently installed version, e.g. from its own version string. */
+    currentVersion: string;
+    /** Fetches the latest available release, or `null` if there is none. */
+    checkForUpdate: () => Promise<UpdateCheckRelease | null>;
+    /** Positive when `a` is newer than `b`, e.g. semver comparison. */
+    compareVersions: (a: string, b: string) => number;
+    /** Read once on mount: when the last check ran, and which version (if any) the user already dismissed. */
+    getLastCheck: () => {
+        lastCheckedAt: number | null;
+        dismissedVersion: string | null;
+    };
+    /** Called after each completed check (success or failure) so the caller can persist the timestamp. */
+    onChecked: (lastCheckedAt: number) => void;
+    /** Minimum delay between two checks. Defaults to 12h. */
+    minIntervalMs?: number;
+    now?: () => number;
+}
+export declare function useUpdateCheck({ currentVersion, checkForUpdate, compareVersions, getLastCheck, onChecked, minIntervalMs, now, }: UseUpdateCheckOptions): UpdateCheckState & {
+    dismiss: () => void;
+};
+//# sourceMappingURL=useUpdateCheck.d.ts.map

package/dist/useUpdateCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateCheck.d.ts","sourceRoot":"","sources":["../src/useUpdateCheck.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACzD,mEAAmE;IACnE,eAAe,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,0GAA0G;IAC1G,YAAY,EAAE,MAAM;QAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;IACF,sGAAsG;IACtG,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAUD,wBAAgB,cAAc,CAAC,EAC7B,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,aAAuC,EACvC,GAAc,GACf,EAAE,qBAAqB,GAAG,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAyCpE"}

package/dist/useUpdateCheck.js

@@ -0,0 +1,47 @@
+import { useEffect, useState } from "react";
+const DEFAULT_MIN_INTERVAL_MS = 12 * 60 * 60 * 1000;
+// Checks once per mount (e.g. app launch) whether a newer release is
+// available, throttled to at most one real network check per `minIntervalMs`
+// and silent for a release the user already dismissed. Persistence of
+// "when did we last check" / "which version did the user dismiss" is left
+// entirely to the caller (`getLastCheck`/`onChecked`, plus its own dismiss
+// handler) — this hook has no opinion on where that lives.
+export function useUpdateCheck({ currentVersion, checkForUpdate, compareVersions, getLastCheck, onChecked, minIntervalMs = DEFAULT_MIN_INTERVAL_MS, now = Date.now, }) {
+    const [state, setState] = useState({ status: "idle" });
+    useEffect(() => {
+        const { lastCheckedAt, dismissedVersion } = getLastCheck();
+        if (lastCheckedAt != null && now() - lastCheckedAt < minIntervalMs)
+            return;
+        let cancelled = false;
+        checkForUpdate()
+            .then((release) => {
+            if (cancelled)
+                return;
+            onChecked(now());
+            if (release &&
+                compareVersions(release.version, currentVersion) > 0 &&
+                release.version !== dismissedVersion) {
+                setState({ status: "available", release });
+            }
+            else {
+                setState({ status: "idle" });
+            }
+        })
+            .catch(() => {
+            if (cancelled)
+                return;
+            onChecked(now());
+            setState({ status: "error" });
+        });
+        return () => {
+            cancelled = true;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps, @eslint-react/exhaustive-deps -- runs once per mount by design (e.g. once per app launch); options are expected to be stable for the caller's lifetime.
+    }, []);
+    return {
+        ...state,
+        dismiss: () => {
+            setState({ status: "idle" });
+        },
+    };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@forthtilliath/expo-release-updates-ui",
+  "version": "0.2.0",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Forthtilliath/forthtilliath-packages.git",
+    "directory": "packages/expo-release-updates-ui"
+  },
+  "homepage": "https://github.com/Forthtilliath/forthtilliath-packages/tree/main/packages/expo-release-updates-ui#readme",
+  "bugs": "https://github.com/Forthtilliath/forthtilliath-packages/issues",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./dist/*.js"
+  },
+  "dependencies": {
+    "@forthtilliath/expo-release-updates": "0.3.0"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-native": ">=0.81"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.18",
+    "@types/react-test-renderer": "^19.1.0",
+    "eslint": "10.7.0",
+    "react": "^19.2.8",
+    "react-native": "0.86.0",
+    "react-test-renderer": "19.2.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "@forthtilliath/eslint-config": "0.4.2",
+    "@forthtilliath/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "lint": "eslint . --max-warnings 0",
+    "check-types": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch -p tsconfig.build.json",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}