homeio

1import "server-only";
2
3/** Compare two image tags as dot-separated numeric segments. Returns >0 if a > b. */
4export function compareImageTags(a: string, b: string): number {
5  const pa = a.split(".").map((s) => parseInt(s, 10) || 0);
6  const pb = b.split(".").map((s) => parseInt(s, 10) || 0);
7  const len = Math.max(pa.length, pb.length);
8  for (let i = 0; i < len; i++) {
9    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
10    if (diff !== 0) return diff;
11  }
12  return 0;
13}
14
15/** Extract the tag from an image reference (e.g. "nginx:1.25.3" → "1.25.3"). */
16export function extractImageTag(image: string | null | undefined): string | null {
17  if (!image) return null;
18  const lastSlash = image.lastIndexOf("/");
19  const lastColon = image.lastIndexOf(":");
20  if (lastColon > lastSlash) return image.slice(lastColon + 1) || null;
21  return null;
22}
23
24/**
25 * Returns true when the catalog template has a strictly newer tag than
26 * what is currently written in the installed compose file.
27 */
28export function isTagUpdateAvailable(
29  installedImage: string | null | undefined,
30  catalogImage: string | null | undefined,
31): boolean {
32  const installedTag = extractImageTag(installedImage);
33  const catalogTag = extractImageTag(catalogImage);
34  if (!installedTag || !catalogTag) return false;
35  return compareImageTags(catalogTag, installedTag) > 0;
36}
37