// --------------------------------------------------------------------------- // Unit tests for the shared update-check resolver. Pins the resolution order // (disable, JSON override, single-value override, registry, failure) and the // semver verdict that both the CLI notice and the web UpdateCard depend on. // --------------------------------------------------------------------------- import { describe, expect, it } from "@effect/vitest"; import { __resetDistTagsCache, checkForUpdate, compareVersions, resolveDistTags, resolveUpdateChannel, } from "./update-check"; const jsonResponse = (body: unknown, ok = true): Response => new Response(JSON.stringify(body), { status: ok ? 200 : 500, headers: { "content-type": "application/json" }, }); const fetchReturning = (body: unknown, ok = true): typeof fetch => (async () => jsonResponse(body, ok)) as typeof fetch; // A fetch impl whose body is not valid JSON, exercising resolveDistTags' // best-effort catch: any registry misbehaviour collapses to {}. const fetchThatFails = (): typeof fetch => (async () => new Response("", { status: 200 })) as typeof fetch; describe("compareVersions", () => { it("orders by major, minor, patch", () => { expect(compareVersions("1.0.0", "2.0.0")).toBe(-1); expect(compareVersions("1.5.22", "1.5.21")).toBe(1); expect(compareVersions("1.5.22", "1.5.22")).toBe(0); }); it("treats a prerelease as older than its release", () => { expect(compareVersions("1.6.0-beta.1", "1.6.0")).toBe(-1); expect(compareVersions("1.6.0-beta.1", "1.6.0-beta.2")).toBe(-1); }); it("returns null for unparseable input", () => { expect(compareVersions("not-a-version", "1.0.0")).toBeNull(); }); }); describe("resolveUpdateChannel", () => { it("routes beta builds to the beta channel", () => { expect(resolveUpdateChannel("1.6.0-beta.3")).toBe("beta"); expect(resolveUpdateChannel("1.5.22")).toBe("latest"); expect(resolveUpdateChannel("0.0.0-dev")).toBe("latest"); }); }); describe("resolveDistTags", () => { it("returns nothing when the check is disabled", async () => { const tags = await resolveDistTags({ env: { EXECUTOR_DISABLE_UPDATE_CHECK: "1", EXECUTOR_FORCE_LATEST_VERSION: "9.9.9" }, fetchImpl: fetchThatFails(), }); expect(tags).toEqual({}); }); it("honours a JSON dist-tags override", async () => { const tags = await resolveDistTags({ env: { EXECUTOR_NPM_DIST_TAGS: JSON.stringify({ latest: "9.9.9", beta: "9.9.9-beta.1" }) }, fetchImpl: fetchThatFails(), }); expect(tags).toEqual({ latest: "9.9.9", beta: "9.9.9-beta.1" }); }); it("honours a single-value override on both channels", async () => { const tags = await resolveDistTags({ env: { EXECUTOR_FORCE_LATEST_VERSION: "2.0.0" }, fetchImpl: fetchThatFails(), }); expect(tags).toEqual({ latest: "2.0.0", beta: "2.0.0" }); }); it("falls back to the registry, keeping only string tags", async () => { __resetDistTagsCache(); const tags = await resolveDistTags({ env: {}, fetchImpl: fetchReturning({ latest: "1.5.22", beta: "1.6.0-beta.1", next: 5 }), }); expect(tags).toEqual({ latest: "1.5.22", beta: "1.6.0-beta.1" }); }); it("swallows a failing registry into an empty result", async () => { __resetDistTagsCache(); const tags = await resolveDistTags({ env: {}, fetchImpl: fetchThatFails() }); expect(tags).toEqual({}); }); it("negative-caches a failure so the next call skips the fetch", async () => { __resetDistTagsCache(); const failed = await resolveDistTags({ env: {}, fetchImpl: fetchThatFails() }); expect(failed).toEqual({}); // Within the negative TTL the cached empty result is reused, even though a // working registry is now reachable (so an offline server pays the timeout // once, not per request). const cached = await resolveDistTags({ env: {}, fetchImpl: fetchReturning({ latest: "1.5.22" }), }); expect(cached).toEqual({}); }); }); describe("checkForUpdate", () => { it("flags an available update on the resolved channel", async () => { const status = await checkForUpdate("1.5.22", { env: { EXECUTOR_NPM_DIST_TAGS: JSON.stringify({ latest: "1.6.0" }) }, }); expect(status.updateAvailable).toBe(true); expect(status.latestVersion).toBe("1.6.0"); expect(status.channel).toBe("latest"); expect(status.command).toBe("npm i -g executor@latest"); }); it("stays quiet when already current", async () => { const status = await checkForUpdate("1.6.0", { env: { EXECUTOR_NPM_DIST_TAGS: JSON.stringify({ latest: "1.6.0" }) }, }); expect(status.updateAvailable).toBe(false); }); it("compares a beta build against the beta tag", async () => { const status = await checkForUpdate("1.6.0-beta.1", { env: { EXECUTOR_NPM_DIST_TAGS: JSON.stringify({ latest: "1.5.22", beta: "1.6.0-beta.2" }) }, }); expect(status.channel).toBe("beta"); expect(status.updateAvailable).toBe(true); expect(status.latestVersion).toBe("1.6.0-beta.2"); expect(status.command).toBe("npm i -g executor@beta"); }); it("treats the dev build as upgradeable to any release", async () => { const status = await checkForUpdate("0.0.0-dev", { env: { EXECUTOR_FORCE_LATEST_VERSION: "1.5.22" }, }); expect(status.updateAvailable).toBe(true); }); });