@peers-app/peers-ui 0.19.0 → 0.19.6

package/dist/screens/packages/package-list.js

@@ -11,56 +11,119 @@ const tooltip_1 = require("../../components/tooltip");
 const globals_1 = require("../../globals");
 const hooks_1 = require("../../hooks");
 const ui_loader_1 = require("../../ui-router/ui-loader");
-const PackageVersionBadge = ({ activePackageVersionId, packageId, followVersionTags, }) => {
-    const data = (0, hooks_1.usePromise)(async () => {
-        if (!activePackageVersionId)
+const package_helpers_1 = require("./package-helpers");
+function tagBadgeClass(tag) {
+    if (tag === "dev")
+        return "text-bg-danger";
+    if (tag.startsWith("beta"))
+        return "text-bg-warning";
+    return "text-bg-success";
+}
+function updateBadgeClass(level) {
+    if (level === "major")
+        return "text-bg-danger";
+    if (level === "minor")
+        return "text-bg-warning";
+    return "text-bg-info";
+}
+const PackageRow = ({ pkg, onUpdated }) => {
+    const [updating, setUpdating] = (0, react_1.useState)(false);
+    const [devicePrefs] = (0, hooks_1.useObservable)((0, peers_sdk_1.packagePrefsVar)(pkg.packageId));
+    const effective = (0, peers_sdk_1.getEffectivePackagePrefs)(pkg, devicePrefs);
+    const status = (0, hooks_1.usePromise)(async () => {
+        if (!effective.activePackageVersionId)
             return null;
-        const all = await (0, peers_sdk_1.PackageVersions)().list({ packageId });
-        const active = all.find((v) => v.packageVersionId === activePackageVersionId);
-        if (!active)
+        const s = await (0, package_helpers_1.checkVersionStatus)(pkg.packageId, effective.activePackageVersionId, effective.followTags);
+        if (!s)
             return null;
-        let newerLevel = null;
-        if (active.version) {
-            const parse = (v) => v.split(".").map(Number);
-            const [aMaj, aMin, aPat] = parse(active.version);
-            for (const v of all) {
-                if (!v.version || v.packageVersionId === activePackageVersionId)
-                    continue;
-                if (!(0, peers_sdk_1.doesTagMatch)(active.versionTag, v.versionTag, followVersionTags, undefined))
-                    continue;
-                const [maj, min, pat] = parse(v.version);
-                if (maj > aMaj) {
-                    newerLevel = "major";
-                    break;
-                }
-                if (maj === aMaj && min > aMin) {
-                    newerLevel = "minor";
-                    continue;
-                }
-                if (maj === aMaj && min === aMin && pat > aPat && !newerLevel) {
-                    newerLevel = "patch";
+        let groupReleasePv = null;
+        if (s.activePv.versionTag === "dev" &&
+            pkg.activePackageVersionId &&
+            pkg.activePackageVersionId !== effective.activePackageVersionId) {
+            try {
+                const gpv = await (0, peers_sdk_1.PackageVersions)().get(pkg.activePackageVersionId);
+                if (gpv && gpv.versionTag !== "dev")
+                    groupReleasePv = gpv;
+            }
+            catch { }
+        }
+        let latestDevPv = null;
+        if (s.activePv.versionTag !== "dev") {
+            const allVersions = await (0, peers_sdk_1.PackageVersions)().list({ packageId: pkg.packageId });
+            for (const v of allVersions) {
+                if (v.versionTag !== "dev")
                     continue;
-                }
-                if (maj === aMaj &&
-                    min === aMin &&
-                    pat === aPat &&
-                    (v.createdAt || "") > (active.createdAt || "") &&
-                    !newerLevel) {
-                    newerLevel = "patch";
+                if (!latestDevPv || (v.createdAt || "") > (latestDevPv.createdAt || "")) {
+                    latestDevPv = v;
                 }
             }
         }
-        return { pv: active, newerLevel };
-    }, undefined, [activePackageVersionId, packageId, followVersionTags]);
-    if (!data)
-        return null;
-    const { pv, newerLevel } = data;
-    return ((0, jsx_runtime_1.jsxs)("span", { className: "ms-2", children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["v", pv.version] }), pv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ms-1 ${pv.versionTag === "dev" ? "text-bg-danger" : pv.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-success"}`, style: { fontSize: "0.65em" }, children: pv.versionTag })), newerLevel ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge ms-1 text-bg-${newerLevel === "major" ? "danger" : newerLevel === "minor" ? "warning" : "info"}`, style: { fontSize: "0.65em" }, children: [newerLevel, " update"] })) : ((0, jsx_runtime_1.jsx)("span", { className: "badge ms-1 text-bg-success", style: { fontSize: "0.65em" }, children: "up to date" }))] }));
+        return { ...s, groupReleasePv, latestDevPv };
+    }, undefined, [
+        effective.activePackageVersionId,
+        pkg.packageId,
+        effective.followTags,
+        pkg.activePackageVersionId,
+    ]);
+    const isOnDev = status?.activePv.versionTag === "dev";
+    const hasGroupRelease = !!status?.groupReleasePv;
+    const hasUpdate = !isOnDev && !!status?.newerLevel && !!status?.newestPv;
+    const hasDevVersion = !isOnDev && !!status?.latestDevPv;
+    const isDeviceOverridden = !!effective.activePackageVersionId &&
+        !!pkg.activePackageVersionId &&
+        effective.activePackageVersionId !== pkg.activePackageVersionId;
+    async function handleUpdate() {
+        if (!status?.newestPv)
+            return;
+        setUpdating(true);
+        try {
+            await (0, package_helpers_1.activatePackageVersion)(pkg.packageId, status.newestPv);
+            onUpdated();
+        }
+        catch (err) {
+            alert(`Failed to update: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            setUpdating(false);
+        }
+    }
+    async function handleUseRelease() {
+        setUpdating(true);
+        try {
+            await (0, peers_sdk_1.updatePackagePrefs)(pkg.packageId, { activePackageVersionId: undefined });
+            onUpdated();
+        }
+        catch (err) {
+            alert(`Failed to switch: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            setUpdating(false);
+        }
+    }
+    async function handleUseDev() {
+        if (!status?.latestDevPv)
+            return;
+        setUpdating(true);
+        try {
+            await (0, peers_sdk_1.updatePackagePrefs)(pkg.packageId, {
+                activePackageVersionId: status.latestDevPv.packageVersionId,
+            });
+            onUpdated();
+        }
+        catch (err) {
+            alert(`Failed to switch: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            setUpdating(false);
+        }
+    }
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid pb-4 d-flex align-items-center", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex-grow-1", style: { minWidth: 0 }, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-fill" }), "\u00A0\u00A0", (0, jsx_runtime_1.jsx)("a", { href: `#packages/${pkg.packageId}`, children: pkg.name }), isDeviceOverridden && ((0, jsx_runtime_1.jsx)("span", { className: "text-warning ms-1", title: "This device is using a different version than the group", children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-pc-display" }) })), status && ((0, jsx_runtime_1.jsxs)("span", { className: "ms-2", children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["v", status.activePv.version] }), status.activePv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ms-1 ${tagBadgeClass(status.activePv.versionTag)}`, style: { fontSize: "0.65em" }, children: status.activePv.versionTag })), hasUpdate ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge ms-1 ${updateBadgeClass(status.newerLevel)}`, style: { fontSize: "0.65em" }, children: ["v", status.newestPv?.version, " available"] })) : isOnDev && hasGroupRelease ? ((0, jsx_runtime_1.jsxs)("span", { className: "badge ms-1 text-bg-secondary", style: { fontSize: "0.65em" }, children: ["release: v", status.groupReleasePv?.version] })) : ((0, jsx_runtime_1.jsx)("span", { className: "badge ms-1 text-bg-success", style: { fontSize: "0.65em" }, children: "up to date" }))] })), (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: pkg.description, positions: ["bottom", "top", "right", "left"] })] }), hasUpdate && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-primary ms-2 text-nowrap", disabled: updating, onClick: handleUpdate, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-arrow-up-circle me-1" })), "Update"] })), isOnDev && hasGroupRelease && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-secondary ms-2 text-nowrap", disabled: updating, onClick: handleUseRelease, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-arrow-in-right me-1" })), "Use Release"] })), hasDevVersion && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-danger ms-2 text-nowrap", disabled: updating, onClick: handleUseDev, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-tools me-1" })), "Use Dev"] }))] }));
 };
 const PackageList = () => {
     const [searchTextObs] = (0, react_1.useState)(() => (0, peers_sdk_1.observable)(""));
     const [searchText] = (0, hooks_1.useObservable)(searchTextObs);
     const addingPackage = (0, hooks_1.useObservableState)(false);
+    const refreshKey = (0, hooks_1.useObservableState)(0);
     const [cursorObs] = (0, react_1.useState)(() => (0, peers_sdk_1.observable)());
     const newCursor = (0, react_1.useCallback)(async () => {
         const cursor = await (0, peers_sdk_1.Packages)().cursor({
@@ -91,6 +154,42 @@ const PackageList = () => {
         if (moreMatches.length === 0) {
             cursorObs(undefined);
         }
+        if (!searchText.length && existing.length === 0 && moreMatches.length > 0) {
+            const DEV_WITH_RELEASE_RANK = 0.5;
+            const rankMap = new Map();
+            await Promise.all(moreMatches.map(async (pkg) => {
+                try {
+                    const pVar = (0, peers_sdk_1.packagePrefsVar)(pkg.packageId);
+                    await pVar.loadingPromise;
+                    const eff = (0, peers_sdk_1.getEffectivePackagePrefs)(pkg, pVar());
+                    if (!eff.activePackageVersionId)
+                        return;
+                    const s = await (0, package_helpers_1.checkVersionStatus)(pkg.packageId, eff.activePackageVersionId, eff.followTags);
+                    if (!s)
+                        return;
+                    if (s.newerLevel) {
+                        rankMap.set(pkg.packageId, package_helpers_1.updateLevelRank[s.newerLevel]);
+                    }
+                    else if (s.activePv.versionTag === "dev" && pkg.activePackageVersionId) {
+                        try {
+                            const gpv = await (0, peers_sdk_1.PackageVersions)().get(pkg.activePackageVersionId);
+                            if (gpv && gpv.versionTag !== "dev") {
+                                rankMap.set(pkg.packageId, DEV_WITH_RELEASE_RANK);
+                            }
+                        }
+                        catch { }
+                    }
+                }
+                catch { }
+            }));
+            moreMatches.sort((a, b) => {
+                const aRank = rankMap.get(a.packageId) ?? 0;
+                const bRank = rankMap.get(b.packageId) ?? 0;
+                if (bRank !== aRank)
+                    return bRank - aRank;
+                return (a.name || "").localeCompare(b.name || "");
+            });
+        }
         return moreMatches;
     }
     async function searchSubmit(evt) {
@@ -99,7 +198,6 @@ const PackageList = () => {
         const name = searchText.trim();
         if (!name)
             return;
-        // check if name is a remote repo url
         if (name.startsWith("http") || name.endsWith(".git")) {
             if (!confirm(`Add remote package: ${name}`))
                 return;
@@ -113,7 +211,6 @@ const PackageList = () => {
             }
             catch (err) {
                 let errMessage = err instanceof Error ? err.message : String(err);
-                // replace all whitespace with a single space for confirm dialog
                 errMessage = errMessage.replace(/\s+/g, " ");
                 confirm(`Error adding remote package: ${errMessage}`);
             }
@@ -142,10 +239,8 @@ const PackageList = () => {
     if (addingPackage()) {
         return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsxs)("div", { className: "container-fluid d-flex justify-content-center mt-5", children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-seam" }), "\u00A0 Adding Package"] }), (0, jsx_runtime_1.jsx)("div", { className: "container-fluid d-flex justify-content-center mt-2", children: (0, jsx_runtime_1.jsx)("div", { className: "progress", role: "progressbar", "aria-label": "Animated striped example", "aria-valuenow": 100, "aria-valuemin": 0, "aria-valuemax": 100, children: (0, jsx_runtime_1.jsx)("div", { className: "progress-bar progress-bar-striped progress-bar-animated", style: { width: 150 } }) }) })] }));
     }
-    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid", children: [(0, jsx_runtime_1.jsxs)("div", { className: "input-group mt-3 mb-3", children: [(0, jsx_runtime_1.jsx)(input_1.Input, { value: searchTextObs, className: "form-control", placeholder: "Search, add, or create package", autoFocus: !!(0, globals_1.isDesktop)(), onKeyUp: (evt) => searchSubmit(evt) }), (0, jsx_runtime_1.jsx)("button", { className: "btn btn-outline-secondary dropdown-toggle sm", type: "button", "data-bs-toggle": "dropdown", "aria-expanded": "false", children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-plus-lg" }) }), (0, jsx_runtime_1.jsxs)("ul", { className: "dropdown-menu dropdown-menu-end", children: [(0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", href: "#packages/newlocal", children: "New Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Remote Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("hr", { className: "dropdown-divider" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", onClick: () => peers_sdk_1.rpcServerCalls.openPath(peers_sdk_1.packagesRootDir), style: { cursor: "pointer" }, children: "Open Packages Directory" }) })] })] }), (0, jsx_runtime_1.jsx)("div", { className: "peers-list-container", children: (0, jsx_runtime_1.jsx)(lazy_list_1.LazyList, { resetTrigger: searchText, loadMore: loadMore, scrollThreshold: 0.6, renderItems: (packages) => {
-                        return packages.map((pkg) => {
-                            return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid pb-4", children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-fill" }), "\u00A0\u00A0", (0, jsx_runtime_1.jsx)("a", { href: `#packages/${pkg.packageId}`, children: pkg.name }), (0, jsx_runtime_1.jsx)(PackageVersionBadge, { activePackageVersionId: pkg.activePackageVersionId, packageId: pkg.packageId, followVersionTags: pkg.followVersionTags }), (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: pkg.description, positions: ["bottom", "top", "right", "left"] })] }, pkg.packageId));
-                        });
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid", children: [(0, jsx_runtime_1.jsxs)("div", { className: "input-group mt-3 mb-3", children: [(0, jsx_runtime_1.jsx)(input_1.Input, { value: searchTextObs, className: "form-control", placeholder: "Search, add, or create package", autoFocus: !!(0, globals_1.isDesktop)(), onKeyUp: (evt) => searchSubmit(evt) }), (0, jsx_runtime_1.jsx)("button", { className: "btn btn-outline-secondary dropdown-toggle sm", type: "button", "data-bs-toggle": "dropdown", "aria-expanded": "false", children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-plus-lg" }) }), (0, jsx_runtime_1.jsxs)("ul", { className: "dropdown-menu dropdown-menu-end", children: [(0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", href: "#packages/newlocal", children: "New Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Remote Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("hr", { className: "dropdown-divider" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", onClick: () => peers_sdk_1.rpcServerCalls.openPath(peers_sdk_1.packagesRootDir), style: { cursor: "pointer" }, children: "Open Packages Directory" }) })] })] }), (0, jsx_runtime_1.jsx)("div", { className: "peers-list-container", children: (0, jsx_runtime_1.jsx)(lazy_list_1.LazyList, { resetTrigger: `${searchText}_${refreshKey()}`, loadMore: loadMore, scrollThreshold: 0.6, renderItems: (packages) => {
+                        return packages.map((pkg) => ((0, jsx_runtime_1.jsx)(PackageRow, { pkg: pkg, onUpdated: () => refreshKey(refreshKey() + 1) }, pkg.packageId)));
                     }, loadingIndicator: (0, jsx_runtime_1.jsx)("div", { className: "d-flex justify-content-center", style: { height: 200 }, children: (0, jsx_runtime_1.jsx)(loading_indicator_1.LoadingIndicator, {}) }), endOfList: (0, jsx_runtime_1.jsx)("div", { className: "d-flex justify-content-center", style: { height: 200 } }) }) })] }));
 };
 exports.PackageList = PackageList;

package/dist/screens/packages/package-versions.js

@@ -5,6 +5,7 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = require("react");
 const hooks_1 = require("../../hooks");
+const package_helpers_1 = require("./package-helpers");
 function formatDate(iso) {
     try {
         const d = new Date(iso);
@@ -77,18 +78,7 @@ const PackageVersionsList = (props) => {
     async function activateVersion(pv) {
         setActivating(pv.packageVersionId);
         try {
-            await (0, peers_sdk_1.updatePackagePrefs)(pkg.packageId, {
-                activePackageVersionId: pv.packageVersionId,
-            });
-            // For non-dev versions, also update the group default so other devices
-            // can discover this as the recommended version.
-            if (pv.versionTag !== "dev") {
-                const current = await (0, peers_sdk_1.Packages)().get(pkg.packageId);
-                if (current) {
-                    current.activePackageVersionId = pv.packageVersionId;
-                    await (0, peers_sdk_1.Packages)().signAndSave(current);
-                }
-            }
+            await (0, package_helpers_1.activatePackageVersion)(pkg.packageId, pv);
             await pkg.load();
             refreshKey(refreshKey() + 1);
         }
@@ -163,7 +153,17 @@ const PackageVersionsList = (props) => {
     async function pinVersion() {
         setPinning(true);
         try {
-            await (0, peers_sdk_1.updatePackagePrefs)(pkg.packageId, { pinned: true });
+            const pinsGroup = !(0, peers_sdk_1.hasDeviceFollowOverride)(devicePrefs) && (await (0, package_helpers_1.isGroupAdmin)());
+            if (pinsGroup) {
+                const current = await (0, peers_sdk_1.Packages)().get(pkg.packageId);
+                if (current) {
+                    current.versionFollowRange = "pinned";
+                    await (0, peers_sdk_1.Packages)().signAndSave(current);
+                }
+            }
+            else {
+                await (0, peers_sdk_1.updatePackagePrefs)(pkg.packageId, { pinned: true });
+            }
             await pkg.load();
         }
         catch (err) {

package/dist/system-apps/index.d.ts

@@ -1,4 +1,5 @@
-import type { IAppNav, IPackage } from "@peers-app/peers-sdk";
+import type { IAppNav } from "@peers-app/peers-sdk";
+import type { IPackageWithNavs } from "../ui-router/routes-loader";
 export { accountApp } from "./account.app";
 export { assistantsApp } from "./assistants.app";
 export { consoleLogsApp } from "./console-logs.app";
@@ -17,4 +18,4 @@ export { typesApp } from "./types.app";
 export { variablesApp } from "./variables.app";
 export { workflowsApp } from "./workflows.app";
 export declare const systemApps: IAppNav[];
-export declare const systemPackage: IPackage;
+export declare const systemPackage: IPackageWithNavs;

package/dist/tabs-layout/tabs-state.d.ts

@@ -1,4 +1,5 @@
-import { type IAppNav, type IPackage, type Observable } from "@peers-app/peers-sdk";
+import { type IAppNav, type Observable } from "@peers-app/peers-sdk";
+import { type IPackageWithNavs } from "../ui-router/routes-loader";
 export interface TabState {
     tabId: string;
     packageId?: string;
@@ -21,7 +22,7 @@ export declare function goToTabPath(path: string): void;
 export declare const handleMainPathChanged: (oldPath: string, newPath: string, setNewMainPath: (path: string) => void) => void;
 type AppInfo = {
     navItem: IAppNav;
-    package: IPackage;
+    package: IPackageWithNavs;
 };
 export declare function determineAppFromPath(path: string): AppInfo | undefined;
 export declare const updateActiveTabTitle: (newTitle: string) => void;

package/dist/ui-router/routes-loader.d.ts

@@ -1,22 +1,8 @@
+import { type IAppNav, type IPackage } from "@peers-app/peers-sdk";
 import "../ui-defaults";
-export declare const allPackages: import("@peers-app/peers-sdk").Observable<{
-    name: string;
-    description: string;
-    signature: string;
-    packageId: string;
-    createdBy: string;
-    publishPublicKey: string;
-    disabled?: boolean | undefined;
-    appNavs?: {
-        name: string;
-        iconClassName: string;
-        navigationPath: string;
-        displayName?: string | undefined;
-    }[] | undefined;
-    remoteRepo?: string | undefined;
-    activePackageVersionId?: string | undefined;
-    versionFollowRange?: "pinned" | "patch" | "minor" | "latest" | undefined;
-    followVersionTags?: string | undefined;
-    updateUrl?: string | undefined;
-}[]>;
+/** IPackage enriched with appNavs from the active PackageVersion. */
+export type IPackageWithNavs = IPackage & {
+    appNavs?: IAppNav[];
+};
+export declare const allPackages: import("@peers-app/peers-sdk").Observable<IPackageWithNavs[]>;
 export declare const loadAllRoutes: () => Promise<true | undefined>;

package/dist/ui-router/routes-loader.js

@@ -31,8 +31,7 @@ function subscribeToPrefs(packageId) {
     });
 }
 /**
- * Enrich an IPackage with appNavs from the device's active PV record.
- * Falls back to `pkg.appNavs` for backward compat with older data.
+ * Enrich an IPackage with appNavs from the device's active PackageVersion record.
  */
 async function enrichWithPvAppNavs(pkg) {
     let pvId = pkg.activePackageVersionId;
@@ -53,7 +52,7 @@ async function enrichWithPvAppNavs(pkg) {
         }
     }
     catch {
-        /* fall through to pkg.appNavs */
+        /* PV not found */
     }
     return pkg;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-ui",
-  "version": "0.19.0",
+  "version": "0.19.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-ui.git"
@@ -28,7 +28,7 @@
     "lint:fix": "biome check --write ."
   },
   "peerDependencies": {
-    "@peers-app/peers-sdk": "^0.19.0",
+    "@peers-app/peers-sdk": "^0.19.6",
     "bootstrap": "^5.3.3",
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
@@ -39,7 +39,7 @@
     "@babel/preset-env": "^7.24.5",
     "@babel/preset-react": "^7.24.1",
     "@babel/preset-typescript": "^7.27.1",
-    "@peers-app/peers-sdk": "0.19.0",
+    "@peers-app/peers-sdk": "0.19.6",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",

package/src/index.tsx

@@ -6,6 +6,7 @@ export * from "./components/markdown-editor/editor-inline";
 export * from "./components/markdown-with-mentions";
 export * from "./components/sortable-list";
 export * from "./components/tabs";
+export { Typeahead, type TypeaheadItem } from "./components/typeahead";
 export * from "./components/voice-indicator";
 export { mainContentPath } from "./globals";
 export * from "./hooks";

package/src/screens/packages/package-details.tsx

@@ -1,5 +1,4 @@
 import { Packages, rpcServerCalls } from "@peers-app/peers-sdk";
-import React from "react";
 import { Input } from "../../components/input";
 import { LoadingIndicator } from "../../components/loading-indicator";
 import { type ISaveButtonProps, SaveButton } from "../../components/save-button";
@@ -13,9 +12,9 @@ interface IProps {
   packageId: string;
 }
 
+/** Detail screen for a single package with Info, Versions, Components, and Dependencies tabs. */
 export const PackageDetails = (props: IProps) => {
   const refresh = useObservableState(Date.now());
-  const saveDeviceTagRef = React.useRef<(() => Promise<void>) | null>(null);
 
   const pkg = usePromise(
     async () => {
@@ -88,7 +87,6 @@ export const PackageDetails = (props: IProps) => {
             doc={pkg}
             onClick={async () => {
               await pkg.save();
-              await saveDeviceTagRef.current?.();
             }}
             addActions={[...addActions]}
           />
@@ -102,7 +100,7 @@ export const PackageDetails = (props: IProps) => {
             name: "Info",
             content: (
               <ScreenTabBody>
-                <PackageInfo pkg={pkg} saveDeviceTagRef={saveDeviceTagRef} />
+                <PackageInfo pkg={pkg} />
               </ScreenTabBody>
             ),
           },

package/src/screens/packages/package-helpers.ts

@@ -0,0 +1,140 @@
+import {
+  doesTagMatch,
+  GroupMemberRole,
+  getUserContext,
+  getUserRole,
+  hasDeviceFollowOverride,
+  type IPackageVersion,
+  Packages,
+  PackageVersions,
+  packagePrefsVar,
+  updatePackagePrefs,
+} from "@peers-app/peers-sdk";
+
+/** Severity of a version update: major > minor > patch. */
+export type UpdateLevel = "major" | "minor" | "patch" | null;
+
+/** Result of checking a package's version status against available versions. */
+export interface IVersionStatus {
+  activePv: IPackageVersion;
+  newerLevel: UpdateLevel;
+  newestPv: IPackageVersion | null;
+}
+
+/**
+ * Check a package's version status: what's currently active, whether a newer
+ * version exists within the follow policy, and which version is the best
+ * upgrade candidate.
+ *
+ * @param packageId - The package to check.
+ * @param activePackageVersionId - The effective active version (device or group).
+ * @param followVersionTags - Tag filter from effective prefs.
+ */
+export async function checkVersionStatus(
+  packageId: string,
+  activePackageVersionId: string,
+  followVersionTags: string | undefined,
+): Promise<IVersionStatus | null> {
+  const all = await PackageVersions().list({ packageId });
+  const active = all.find((v) => v.packageVersionId === activePackageVersionId);
+  if (!active) return null;
+
+  let newerLevel: UpdateLevel = null;
+  let newestPv: IPackageVersion | null = null;
+
+  if (active.version) {
+    const parse = (v: string) => v.split(".").map(Number);
+    const [aMaj, aMin, aPat] = parse(active.version);
+    let bestVersion = active.version;
+
+    for (const v of all) {
+      if (!v.version || v.packageVersionId === activePackageVersionId) continue;
+      if (!doesTagMatch(active.versionTag, v.versionTag, followVersionTags, undefined)) continue;
+      const [maj, min, pat] = parse(v.version);
+      const [bMaj, bMin, bPat] = parse(bestVersion);
+
+      let candidateLevel: UpdateLevel = null;
+      if (maj > aMaj) candidateLevel = "major";
+      else if (maj === aMaj && min > aMin) candidateLevel = "minor";
+      else if (maj === aMaj && min === aMin && pat > aPat) candidateLevel = "patch";
+      else if (
+        maj === aMaj &&
+        min === aMin &&
+        pat === aPat &&
+        (v.createdAt || "") > (active.createdAt || "")
+      )
+        candidateLevel = "patch";
+
+      if (!candidateLevel) continue;
+
+      const levelRank = { major: 3, minor: 2, patch: 1 };
+      if (!newerLevel || levelRank[candidateLevel] > levelRank[newerLevel]) {
+        newerLevel = candidateLevel;
+      }
+
+      const isHigherThanBest =
+        maj > bMaj ||
+        (maj === bMaj && min > bMin) ||
+        (maj === bMaj && min === bMin && pat > bPat) ||
+        (maj === bMaj &&
+          min === bMin &&
+          pat === bPat &&
+          (v.createdAt || "") > (newestPv?.createdAt || active.createdAt || ""));
+
+      if (!newestPv || isHigherThanBest) {
+        newestPv = v;
+        bestVersion = v.version;
+      }
+    }
+  }
+  return { activePv: active, newerLevel, newestPv };
+}
+
+/** Whether the current user is an admin of the active group. */
+export async function isGroupAdmin(): Promise<boolean> {
+  try {
+    const userCtx = await getUserContext();
+    const dc = userCtx.defaultDataContext();
+    const contextId = dc?.groupId || dc?.dataContextId;
+    if (!contextId) return false;
+    const role = await getUserRole(contextId, userCtx.userId);
+    return role >= GroupMemberRole.Admin;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Activate a specific package version, handling group-level vs device-local
+ * activation. When the device has no follow override and the user is a group
+ * admin, the group's `activePackageVersionId` is advanced so all devices
+ * stay in sync. Otherwise only the device-local prefs are updated.
+ *
+ * @param packageId - The package to activate a version for.
+ * @param pv - The package version to activate.
+ */
+export async function activatePackageVersion(
+  packageId: string,
+  pv: IPackageVersion,
+): Promise<void> {
+  const prefsVar = packagePrefsVar(packageId);
+  await prefsVar.loadingPromise;
+  const devicePrefs = prefsVar();
+
+  const activatesGroup =
+    pv.versionTag !== "dev" && !hasDeviceFollowOverride(devicePrefs) && (await isGroupAdmin());
+
+  if (activatesGroup) {
+    const current = await Packages().get(packageId);
+    if (current) {
+      current.activePackageVersionId = pv.packageVersionId;
+      await Packages().signAndSave(current);
+    }
+    await updatePackagePrefs(packageId, { activePackageVersionId: undefined });
+  } else {
+    await updatePackagePrefs(packageId, { activePackageVersionId: pv.packageVersionId });
+  }
+}
+
+/** Numeric rank for sorting packages by update urgency. */
+export const updateLevelRank: Record<string, number> = { major: 3, minor: 2, patch: 1 };