// Tests Docker image digest metadata and lockfile consistency.
import { readFile } from "node:fs/promises";
import { resolve } from "node:path";
import { fileURLToPath } from "node:url";
import { describe, expect, it } from "vitest";
import { parse } from "yaml";

const repoRoot = resolve(fileURLToPath(new URL(".", import.meta.url)), "..");

const DIGEST_PINNED_DOCKERFILES = [
  "Dockerfile",
  "scripts/docker/sandbox/Dockerfile",
  "scripts/docker/sandbox/Dockerfile.browser",
  "scripts/docker/cleanup-smoke/Dockerfile",
  "scripts/docker/install-sh-e2e/Dockerfile",
  "scripts/docker/install-sh-nonroot/Dockerfile",
  "scripts/docker/install-sh-smoke/Dockerfile",
  "scripts/e2e/Dockerfile",
  "scripts/e2e/Dockerfile.qr-import",
  "scripts/e2e/plugin-binding-command-escape.Dockerfile",
] as const;

type DependabotDockerGroup = {
  patterns?: string[];
};

type DependabotUpdate = {
  "package-ecosystem"?: string;
  directory?: string;
  schedule?: { interval?: string };
  groups?: Record<string, DependabotDockerGroup>;
};

type DependabotConfig = {
  updates?: DependabotUpdate[];
};

function resolveArgDefaults(dockerfile: string): Map<string, string> {
  const argDefaults = new Map<string, string>();
  for (const line of dockerfile.split(/\r?\n/)) {
    const trimmed = line.trim();
    const argMatch = trimmed.match(/^ARG\s+([A-Z0-9_]+)=(.+)$/);
    if (!argMatch) {
      continue;
    }
    const [, name, rawValue] = argMatch;
    argDefaults.set(name, rawValue.replace(/^["']|["']$/g, ""));
  }
  return argDefaults;
}

function resolveFromImageRef(fromLine: string, argDefaults: Map<string, string>): string {
  const fromMatch = fromLine.trim().match(/^FROM\s+(\S+?)(?:\s+AS\s+\S+)?$/);
  if (!fromMatch) {
    return fromLine;
  }
  const imageRef = fromMatch[1];
  const argName =
    imageRef.match(/^\$\{([A-Z0-9_]+)\}$/)?.[1] ?? imageRef.match(/^\$([A-Z0-9_]+)$/)?.[1];
  if (!argName) {
    return imageRef;
  }
  return argDefaults.get(argName) ?? imageRef;
}

function resolveAllArgBackedFromReferences(
  dockerfile: string,
): { stage: string; imageRef: string }[] {
  const argDefaults = resolveArgDefaults(dockerfile);
  const results: { stage: string; imageRef: string }[] = [];
  let stageIndex = 0;
  for (const line of dockerfile.split(/\r?\n/)) {
    const trimmed = line.trim();
    if (!trimmed.startsWith("FROM ")) {
      continue;
    }
    const imageRef = resolveFromImageRef(trimmed, argDefaults);
    // Only check FROM lines that use an ARG — literal `FROM scratch` etc. are intentionally unpinned.
    const usesArg =
      trimmed.match(/FROM\s+\$\{[A-Z0-9_]+\}/) !== null ||
      trimmed.match(/FROM\s+\$[A-Z0-9_]+/) !== null;
    if (usesArg) {
      const stageMatch = trimmed.match(/AS\s+(\S+)/i);
      const stageName = stageMatch ? stageMatch[1] : `stage-${stageIndex}`;
      results.push({ stage: stageName, imageRef });
    }
    stageIndex += 1;
  }
  return results;
}

function resolveFirstFromReference(dockerfile: string): string | undefined {
  const argDefaults = resolveArgDefaults(dockerfile);
  const fromLine = dockerfile.split(/\r?\n/).find((line) => line.trimStart().startsWith("FROM "));
  if (!fromLine) {
    return undefined;
  }
  return resolveFromImageRef(fromLine, argDefaults);
}

function requireFirstFromReference(dockerfile: string, dockerfilePath: string): string {
  const imageRef = resolveFirstFromReference(dockerfile);
  if (!imageRef) {
    throw new Error(`${dockerfilePath} should define a FROM line`);
  }
  return imageRef;
}

function requireDependabotDockerUpdate(config: DependabotConfig): DependabotUpdate {
  const dockerUpdate = config.updates?.find(
    (update) => update["package-ecosystem"] === "docker" && update.directory === "/",
  );
  if (!dockerUpdate) {
    throw new Error("expected Dependabot Docker update entry for root Dockerfiles");
  }
  return dockerUpdate;
}

function requireDockerImageGroup(update: DependabotUpdate): DependabotDockerGroup {
  const group = update.groups?.["docker-images"];
  if (!group) {
    throw new Error("expected Dependabot docker-images group");
  }
  return group;
}

describe("docker base image pinning", () => {
  it("pins selected Dockerfile FROM lines to immutable sha256 digests", async () => {
    for (const dockerfilePath of DIGEST_PINNED_DOCKERFILES) {
      const dockerfile = await readFile(resolve(repoRoot, dockerfilePath), "utf8");
      const imageRef = requireFirstFromReference(dockerfile, dockerfilePath);
      expect(imageRef, `${dockerfilePath} FROM must be digest-pinned`).toMatch(
        /^\S+@sha256:[a-f0-9]{64}$/,
      );
    }
  });

  it("pins all ARG-backed FROM stages in selected Dockerfiles to sha256 digests", async () => {
    for (const dockerfilePath of DIGEST_PINNED_DOCKERFILES) {
      const dockerfile = await readFile(resolve(repoRoot, dockerfilePath), "utf8");
      const stages = resolveAllArgBackedFromReferences(dockerfile);
      for (const { stage, imageRef } of stages) {
        expect(imageRef, `${dockerfilePath} stage "${stage}" must be digest-pinned`).toMatch(
          /^\S+@sha256:[a-f0-9]{64}$/,
        );
      }
    }
  });

  it("keeps Dependabot Docker updates enabled for root Dockerfiles", async () => {
    const raw = await readFile(resolve(repoRoot, ".github/dependabot.yml"), "utf8");
    const config = parse(raw) as DependabotConfig;
    const dockerUpdate = requireDependabotDockerUpdate(config);
    const dockerImagesGroup = requireDockerImageGroup(dockerUpdate);

    expect(dockerUpdate.schedule?.interval).toBe("weekly");
    expect(dockerImagesGroup.patterns).toContain("*");
  });
});
