homeio

1import { describe, expect, it } from "vitest";
2
3import {
4  compareImageTags,
5  extractImageTag,
6  isTagUpdateAvailable,
7} from "@/lib/server/modules/store/update-check";
8
9describe("update-check (tag-based)", () => {
10  describe("extractImageTag", () => {
11    it("extracts tag from image with repo prefix", () => {
12      expect(extractImageTag("plexinc/pms-docker:1.41.3")).toBe("1.41.3");
13    });
14
15    it("extracts tag from simple image", () => {
16      expect(extractImageTag("nginx:1.25.3")).toBe("1.25.3");
17    });
18
19    it("returns null for image with no tag", () => {
20      expect(extractImageTag("nginx")).toBeNull();
21    });
22
23    it("returns null for null/undefined input", () => {
24      expect(extractImageTag(null)).toBeNull();
25      expect(extractImageTag(undefined)).toBeNull();
26    });
27  });
28
29  describe("compareImageTags", () => {
30    it("returns positive when a is greater", () => {
31      expect(compareImageTags("1.41.3", "1.41.2")).toBeGreaterThan(0);
32      expect(compareImageTags("2026.3.0", "2025.2.1")).toBeGreaterThan(0);
33    });
34
35    it("returns negative when a is less", () => {
36      expect(compareImageTags("1.41.2", "1.41.3")).toBeLessThan(0);
37      expect(compareImageTags("2025.2.1", "2026.3.0")).toBeLessThan(0);
38    });
39
40    it("returns 0 when equal", () => {
41      expect(compareImageTags("1.41.2", "1.41.2")).toBe(0);
42    });
43
44    it("compares by major version first", () => {
45      expect(compareImageTags("2.0.0", "1.99.99")).toBeGreaterThan(0);
46    });
47  });
48
49  describe("isTagUpdateAvailable", () => {
50    it("returns true when catalog tag is strictly newer", () => {
51      expect(isTagUpdateAvailable("plexinc/pms-docker:1.41.2", "plexinc/pms-docker:1.41.3")).toBe(true);
52      expect(isTagUpdateAvailable("wisdomsky/cloudflared-web:2025.2.1", "wisdomsky/cloudflared-web:2026.3.0")).toBe(true);
53    });
54
55    it("returns false when catalog tag is older than installed", () => {
56      // Catalog lags behind installed — should NOT show as update
57      expect(isTagUpdateAvailable("wisdomsky/cloudflared-web:2026.3.0", "wisdomsky/cloudflared-web:2025.2.1")).toBe(false);
58    });
59
60    it("returns false when tags are equal", () => {
61      expect(isTagUpdateAvailable("nginx:1.25.3", "nginx:1.25.3")).toBe(false);
62    });
63
64    it("returns false when either image is null", () => {
65      expect(isTagUpdateAvailable(null, "nginx:1.25.3")).toBe(false);
66      expect(isTagUpdateAvailable("nginx:1.25.3", null)).toBe(false);
67      expect(isTagUpdateAvailable(null, null)).toBe(false);
68    });
69
70    it("returns false when images have no tags", () => {
71      expect(isTagUpdateAvailable("nginx", "nginx")).toBe(false);
72    });
73  });
74});
75