Job application tracker and AI-powered job search assistant. Helps job seekers manage their search journey with AI resume review, job matching, task logging, and application analytics, all while keeping your data private.
TypeScript ai-agentai-resume-analyzerapplication-trackerapplication-tracking-systematscareerjob-applicationjob-automationjob-huntingjob-searchjob-seeker-toolsjob-trackerjob-trackingjobsearchjobseekersmcpollamaresumeresume-reviewself-hosted
feat(versioning): implement version check and update notifications
Khuram Niaz898bc3739400
diff --git a/__tests__/version.spec.ts b/__tests__/version.spec.tsnew file mode 100644index 0000000..865155e--- /dev/null+++ b/__tests__/version.spec.ts@@ -0,0 +1,42 @@+import { describe, it, expect } from "vitest";+import { isNewerVersion } from "@/lib/version";++describe("isNewerVersion", () => {+ it("detects a newer patch, minor and major", () => {+ expect(isNewerVersion("1.1.18", "1.1.17")).toBe(true);+ expect(isNewerVersion("1.2.0", "1.1.17")).toBe(true);+ expect(isNewerVersion("2.0.0", "1.1.17")).toBe(true);+ });++ it("returns false for the same or an older version", () => {+ expect(isNewerVersion("1.1.17", "1.1.17")).toBe(false);+ expect(isNewerVersion("1.1.16", "1.1.17")).toBe(false);+ expect(isNewerVersion("1.0.99", "1.1.0")).toBe(false);+ });++ it("ignores a leading v on either side", () => {+ expect(isNewerVersion("v1.2.0", "1.1.17")).toBe(true);+ expect(isNewerVersion("v1.1.17", "v1.1.17")).toBe(false);+ });++ it("compares segments numerically, not lexically", () => {+ expect(isNewerVersion("1.10.0", "1.9.0")).toBe(true);+ expect(isNewerVersion("1.9.0", "1.10.0")).toBe(false);+ });++ it("treats missing segments as zero", () => {+ expect(isNewerVersion("1.2", "1.1.17")).toBe(true);+ expect(isNewerVersion("1.1", "1.1.17")).toBe(false);+ });++ it("ignores pre-release and build suffixes", () => {+ expect(isNewerVersion("1.2.0-beta.1", "1.1.17")).toBe(true);+ expect(isNewerVersion("1.1.17-beta.1", "1.1.17")).toBe(false);+ });++ it("returns false when either side does not parse", () => {+ expect(isNewerVersion("latest", "1.1.17")).toBe(false);+ expect(isNewerVersion("1.2.0", "")).toBe(false);+ expect(isNewerVersion("", "")).toBe(false);+ });+});diff --git a/src/app/api/version/route.ts b/src/app/api/version/route.tsnew file mode 100644index 0000000..141d20c--- /dev/null+++ b/src/app/api/version/route.ts@@ -0,0 +1,52 @@+import { auth } from "@/auth";+import { NextResponse } from "next/server";+import { APP_CONSTANTS } from "@/lib/constants";+import { isNewerVersion } from "@/lib/version";+import { AppVersionInfo } from "@/models/version.model";+import packageJson from "../../../../package.json";++const RELEASE_URL = `https://api.github.com/repos/${APP_CONSTANTS.GITHUB_REPO}/releases/latest`;++// A self-hosted instance can be offline or rate-limited; that is not an error+// worth surfacing, so every failure degrades to "no update available".+async function fetchLatestRelease() {+ const res = await fetch(RELEASE_URL, {+ headers: { Accept: "application/vnd.github+json" },+ next: { revalidate: APP_CONSTANTS.UPDATE_CHECK_REVALIDATE_SECONDS },+ });+ if (!res.ok) return null;++ const data = await res.json();+ return typeof data?.tag_name === "string"+ ? { tag: data.tag_name as string, url: data.html_url as string }+ : null;+}++export async function GET() {+ const session = await auth();+ if (!session?.user?.id) {+ return NextResponse.json({ error: "Not authenticated" }, { status: 401 });+ }++ const current = packageJson.version;+ let release: Awaited<ReturnType<typeof fetchLatestRelease>> = null;++ try {+ release = await fetchLatestRelease();+ } catch (error) {+ console.error("[Version] Update check failed:", error);+ }++ const updateAvailable = release+ ? isNewerVersion(release.tag, current)+ : false;++ const info: AppVersionInfo = {+ current,+ latest: release?.tag ?? null,+ updateAvailable,+ releaseUrl: updateAvailable ? (release?.url ?? null) : null,+ };++ return NextResponse.json(info, { status: 200 });+}diff --git a/src/components/ProfileDropdown.tsx b/src/components/ProfileDropdown.tsxindex 7ffc59a..b9a903c 100644--- a/src/components/ProfileDropdown.tsx+++ b/src/components/ProfileDropdown.tsx@@ -2,7 +2,7 @@import { useState } from "react";import Link from "next/link";-import { PowerIcon, Settings, Info } from "lucide-react";+import { PowerIcon, Settings, Info, ArrowUpCircle } from "lucide-react";import {DropdownMenu,DropdownMenuTrigger,@@ -14,6 +14,7 @@ import {import { Tooltip, TooltipContent, TooltipTrigger } from "./ui/tooltip";import UserAvatar from "./UserAvatar";import { SupportDialog } from "./SupportDialog";+import { useAppVersion } from "@/hooks/useAppVersion";import { cn } from "@/lib/utils";interface ProfileDropdownProps {@@ -28,6 +29,7 @@ export function ProfileDropdown({signOutAction,}: ProfileDropdownProps) {const [supportDialogOpen, setSupportDialogOpen] = useState(false);+ const version = useAppVersion();const label = user?.email ?? "My Account";return (@@ -41,8 +43,17 @@ export function ProfileDropdown({aria-label="User menu"className="navlink h-10 w-full text-muted-foreground hover:text-foreground">- <span className="flex h-full w-14 shrink-0 items-center justify-center">+ <span className="relative flex h-full w-14 shrink-0 items-center justify-center"><UserAvatar user={user} />+ {version?.updateAvailable && (+ <>+ <span+ aria-hidden+ className="absolute right-3 top-1 h-2.5 w-2.5 rounded-full bg-primary ring-2 ring-background"+ />+ <span className="sr-only">Update available</span>+ </>+ )}</span><spanclassName={cn(@@ -73,6 +84,15 @@ export function ProfileDropdown({<Info className="w-5 mr-2" />Support</DropdownMenuItem>+ {version?.updateAvailable && (+ <DropdownMenuItem+ onClick={() => setSupportDialogOpen(true)}+ className="cursor-pointer text-primary focus:text-primary"+ >+ <ArrowUpCircle className="w-5 mr-2" />+ Update available+ </DropdownMenuItem>+ )}<DropdownMenuSeparator /><DropdownMenuItem asChild className="cursor-pointer"><form action={signOutAction}>@@ -88,6 +108,7 @@ export function ProfileDropdown({<SupportDialogopen={supportDialogOpen}onOpenChange={setSupportDialogOpen}+ version={version}/></>);diff --git a/src/components/SupportDialog.tsx b/src/components/SupportDialog.tsxindex dab96ab..af71724 100644--- a/src/components/SupportDialog.tsx+++ b/src/components/SupportDialog.tsx@@ -7,14 +7,20 @@ import {DialogHeader,DialogTitle,} from "./ui/dialog";+import { AppVersionInfo } from "@/models/version.model";import packageJson from "../../package.json";interface SupportDialogProps {open: boolean;onOpenChange: (open: boolean) => void;+ version?: AppVersionInfo | null;}-export function SupportDialog({ open, onOpenChange }: SupportDialogProps) {+export function SupportDialog({+ open,+ onOpenChange,+ version,+}: SupportDialogProps) {const appVersion = packageJson.version;const currentYear = new Date().getFullYear();@@ -38,6 +44,18 @@ export function SupportDialog({ open, onOpenChange }: SupportDialogProps) {<div className="space-y-2"><h3 className="text-sm font-semibold">Version</h3><p className="text-sm text-muted-foreground">v{appVersion}</p>+ {version?.updateAvailable && (+ <p className="text-sm">+ <a+ href={version.releaseUrl ?? undefined}+ target="_blank"+ rel="noopener noreferrer"+ className="text-primary hover:underline"+ >+ {version.latest} is available+ </a>+ </p>+ )}</div><div className="space-y-2"><h3 className="text-sm font-semibold">Copyright</h3>diff --git a/src/hooks/useAppVersion.ts b/src/hooks/useAppVersion.tsnew file mode 100644index 0000000..36ea590--- /dev/null+++ b/src/hooks/useAppVersion.ts@@ -0,0 +1,23 @@+import { useState, useEffect } from "react";+import { AppVersionInfo } from "@/models/version.model";++export function useAppVersion() {+ const [version, setVersion] = useState<AppVersionInfo | null>(null);++ useEffect(() => {+ let active = true;++ fetch("/api/version")+ .then((res) => (res.ok ? res.json() : null))+ .then((data: AppVersionInfo | null) => {+ if (active) setVersion(data);+ })+ .catch(() => {});++ return () => {+ active = false;+ };+ }, []);++ return version;+}diff --git a/src/lib/constants.ts b/src/lib/constants.tsindex cd64189..889d0a8 100644--- a/src/lib/constants.ts+++ b/src/lib/constants.ts@@ -43,6 +43,11 @@ export const APP_CONSTANTS = {RESUME_EXPORT_SETTINGS_STORAGE_KEY: "resume-export-settings",COVER_LETTER_EXPORT_SETTINGS_STORAGE_KEY: "cover-letter-export-settings",SIDEBAR_DOM_ID: "app-sidebar",++ // Update check: the upstream repo and how long a GitHub release lookup is+ // cached. A day is plenty — releases are rare and the check is unauthenticated.+ GITHUB_REPO: "Gsync/jobsync",+ UPDATE_CHECK_REVALIDATE_SECONDS: 86_400,// Paired so the rail width and its matching content offset can't drift.SIDEBAR_WIDTH: {expanded: { rail: "w-56", contentOffset: "sm:pl-56" },diff --git a/src/lib/version.ts b/src/lib/version.tsnew file mode 100644index 0000000..1d65e53--- /dev/null+++ b/src/lib/version.ts@@ -0,0 +1,19 @@+// Numeric semver compare. Pre-release/build suffixes are ignored: a release+// tagged v1.2.0-beta counts as 1.2.0.+function parseVersion(value: string): number[] | null {+ const core = value.trim().replace(/^v/i, "").split(/[-+]/)[0];+ if (!/^\d+(\.\d+)*$/.test(core)) return null;+ return core.split(".").map(Number);+}++export function isNewerVersion(latest: string, current: string): boolean {+ const a = parseVersion(latest);+ const b = parseVersion(current);+ if (!a || !b) return false;++ for (let i = 0; i < Math.max(a.length, b.length); i++) {+ const diff = (a[i] ?? 0) - (b[i] ?? 0);+ if (diff !== 0) return diff > 0;+ }+ return false;+}diff --git a/src/models/version.model.ts b/src/models/version.model.tsnew file mode 100644index 0000000..a8994de--- /dev/null+++ b/src/models/version.model.ts@@ -0,0 +1,6 @@+export interface AppVersionInfo {+ current: string;+ latest: string | null;+ updateAvailable: boolean;+ releaseUrl: string | null;+}