// ---------------------------------------------------------------------------// 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("<not json>", { 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);  });});