Function findVersionIntroductionCommit

scripts/utils/git.ts:34–84

(
  packageJsonPath: string,
  version: string,
)

 * Returns null when the version can't be found in the available git history.
 */
export function findVersionIntroductionCommit(
  packageJsonPath: string,
  version: string,
): string | null {
  let normalizedPath = packageJsonPath.replaceAll("\\", "/");

  let output: string;
  try {
    output = execGit(["log", "--format=%H", "--", normalizedPath]);
  } catch {
    return null;
  }

  if (output.length === 0) {
    return null;
  }

  let commits = output.split("\n").filter((line) => line.length > 0);

  for (let commit of commits) {
    let commitVersion = getPackageVersionAtRef(commit, normalizedPath);
    if (commitVersion !== version) {
      continue;
    }

    let parentLine = execGit(["rev-list", "--parents", "-n", "1", commit]);
    // eslint-disable-next-line @typescript-eslint/no-unused-vars
    let [_commit, ...parents] = parentLine
      .split(" ")
      .filter((line) => line.length > 0);

    if (parents.length === 0) {
      return commit;
    }

    let introducedInCommit = false;
    for (let parent of parents) {
      let parentVersion = getPackageVersionAtRef(parent, normalizedPath);
      if (parentVersion !== version) {
        introducedInCommit = true;
        break;
      }
    }

    if (introducedInCommit) {
      return commit;
    }
  }

  return null;
}

/**
 * Gets the local commit target for a tag.