Skip to content

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.

feat(versioning): implement version check and update notifications

Khuram Niaz898bc3739400
diff --git a/__tests__/version.spec.ts b/__tests__/version.spec.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.tsx
index 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>
<span
className={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({
<SupportDialog
open={supportDialogOpen}
onOpenChange={setSupportDialogOpen}
+ version={version}
/>
</>
);
diff --git a/src/components/SupportDialog.tsx b/src/components/SupportDialog.tsx
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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;
+}