prowler/ui/lib/runtime-env.test.ts

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

import { readEnv } from "./runtime-env";

describe("readEnv", () => {
  afterEach(() => {
    vi.unstubAllEnvs();
  });

  it("returns the primary value when it is set", () => {
    // Given
    vi.stubEnv("UI_API_BASE_URL", "https://primary.example.com");

    // When / Then
    expect(readEnv("UI_API_BASE_URL")).toBe("https://primary.example.com");
  });

  it("returns null when the primary is unset and no legacy is given", () => {
    // Given
    vi.stubEnv("UI_API_BASE_URL", undefined);

    // When / Then
    expect(readEnv("UI_API_BASE_URL")).toBeNull();
  });

  it("treats an empty or whitespace-only primary as unset", () => {
    // Given
    vi.stubEnv("UI_API_BASE_URL", "   ");

    // When / Then
    expect(readEnv("UI_API_BASE_URL")).toBeNull();
  });

  it("falls back to the legacy var when the primary is unset", () => {
    // Given
    vi.stubEnv("UI_API_BASE_URL", undefined);
    vi.stubEnv("NEXT_PUBLIC_API_BASE_URL", "https://legacy.example.com");

    // When / Then
    expect(readEnv("UI_API_BASE_URL", "NEXT_PUBLIC_API_BASE_URL")).toBe(
      "https://legacy.example.com",
    );
  });

  it("falls back to the legacy var when the primary is empty", () => {
    // Given
    vi.stubEnv("UI_API_BASE_URL", "");
    vi.stubEnv("NEXT_PUBLIC_API_BASE_URL", "https://legacy.example.com");

    // When / Then
    expect(readEnv("UI_API_BASE_URL", "NEXT_PUBLIC_API_BASE_URL")).toBe(
      "https://legacy.example.com",
    );
  });

  it("prefers the primary over the legacy when both are set", () => {
    // Given
    vi.stubEnv("UI_API_BASE_URL", "https://primary.example.com");
    vi.stubEnv("NEXT_PUBLIC_API_BASE_URL", "https://legacy.example.com");

    // When / Then
    expect(readEnv("UI_API_BASE_URL", "NEXT_PUBLIC_API_BASE_URL")).toBe(
      "https://primary.example.com",
    );
  });

  it("returns null when neither the primary nor the legacy is set", () => {
    // Given
    vi.stubEnv("UI_API_BASE_URL", undefined);
    vi.stubEnv("NEXT_PUBLIC_API_BASE_URL", undefined);

    // When / Then
    expect(readEnv("UI_API_BASE_URL", "NEXT_PUBLIC_API_BASE_URL")).toBeNull();
  });
});