emdash-cms--emdash/packages/core/tests/unit/api/registry-env-compat.test.ts

/**
 * Environment-compatibility gate for registry install/update.
 *
 * `handleRegistryInstall` and `handleRegistryUpdate` both call
 * `assertEnvCompatible` after release selection / yank-check and before the
 * artifact fetch. The full handler path needs a mocked DiscoveryClient (tracked
 * separately); these tests exercise the gate's decision logic directly — the
 * same helper both handlers use — plus the host-env builder and the error-code
 * status mapping that surfaces `ENV_INCOMPATIBLE` to the admin.
 */

import { describe, expect, it } from "vitest";

import { mapErrorStatus } from "../../../src/api/errors.js";
import { assertEnvCompatible } from "../../../src/api/handlers/registry.js";

describe("assertEnvCompatible", () => {
	const host = { "env:emdash": "1.2.0", "env:astro": "4.12.0" };

	it("returns null when every constraint is satisfied", () => {
		expect(
			assertEnvCompatible({ "env:emdash": ">=1.0.0", "env:astro": ">=4.0.0" }, host),
		).toBeNull();
	});

	it("returns null when there are no constraints", () => {
		expect(assertEnvCompatible(undefined, host)).toBeNull();
		expect(assertEnvCompatible({}, host)).toBeNull();
	});

	it("returns an ENV_INCOMPATIBLE error when a constraint is not satisfied", () => {
		const error = assertEnvCompatible({ "env:astro": ">=4.16" }, host);
		expect(error?.code).toBe("ENV_INCOMPATIBLE");
		expect(error?.details.requires).toEqual({ "env:astro": ">=4.16" });
		expect(error?.details.host).toEqual(host);
		expect(error?.message).toContain("env:astro");
	});

	it("reports every unsatisfied constraint, skipping satisfied ones", () => {
		const error = assertEnvCompatible({ "env:emdash": ">=2.0.0", "env:astro": ">=4.0.0" }, host);
		expect(error?.details.requires).toEqual({ "env:emdash": ">=2.0.0" });
	});

	it("does not crash on a garbage requires shape", () => {
		expect(assertEnvCompatible("garbage", host)).toBeNull();
		expect(assertEnvCompatible(42, host)).toBeNull();
		expect(assertEnvCompatible({ "env:astro": 999 }, host)).toBeNull();
		expect(assertEnvCompatible(null, host)).toBeNull();
	});

	it("skips constraints for envs the host does not advertise", () => {
		expect(assertEnvCompatible({ "did:plc:abc": "^1.0.0" }, host)).toBeNull();
		expect(assertEnvCompatible({ "env:astro": ">=4.16" }, { "env:emdash": "1.2.0" })).toBeNull();
	});
});

describe("ENV_INCOMPATIBLE status mapping", () => {
	it("maps to 409 Conflict", () => {
		expect(mapErrorStatus("ENV_INCOMPATIBLE")).toBe(409);
	});
});