Function getProjectLink

packages/cli/src/util/projects/link.ts:78–109

(
  client: Client,
  path: string,
  projectName?: string,
  projectNameIsExplicit?: boolean
)

}

export async function getProjectLink(
  client: Client,
  path: string,
  projectName?: string,
  projectNameIsExplicit?: boolean
): Promise<ProjectLink | null> {
  // Prefer an explicit per-directory link (`.vercel/project.json`) over a
  // repository-level link (`.vercel/repo.json`). This prevents scenarios where
  // a freshly-created local link (e.g. after `vc link`) is ignored and the
  // user is re-prompted to select a repo-linked project again.
  // When `projectNameIsExplicit` is true, the caller is resolving a user-
  // supplied `--project` value, so mismatched local links must not win.
  const dirLink = await getLinkFromDir(getVercelDirectory(path));
  if (dirLink) {
    if (!projectNameIsExplicit || !projectName) {
      return dirLink;
    }

    if (
      dirLink.projectId === projectName ||
      dirLink.projectName === projectName
    ) {
      return dirLink;
    }
  }
  return await getProjectLinkFromRepoLink(
    client,
    path,
    projectName,
    projectNameIsExplicit
  );
}

async function getProjectLinkFromRepoLink(
  client: Client,