@stats-organization/github-readme-stats-core 2.1.5 → 2.2.0

package/src/fetchers/repo.js

@@ -1,161 +0,0 @@
-import { MissingParamError } from "../common/error.js";
-import { request } from "../common/http.js";
-import { retryer } from "../common/retryer.js";
-
-import { fetchRepoUserStats } from "./stats.js";
-
-/**
- * Repo data fetcher.
- *
- * @param {object} variables Fetcher variables.
- * @param {string} token GitHub token.
- * @returns {Promise<import('axios').AxiosResponse>} The response.
- */
-const fetcher = (variables, token) => {
-  return request(
-    {
-      query: `
-      fragment RepoInfo on Repository {
-        name
-        nameWithOwner
-        isPrivate
-        isArchived
-        isTemplate
-        stargazerCount
-        description
-        primaryLanguage {
-          color
-          id
-          name
-        }
-        forkCount
-      }
-      query getRepo($login: String!, $repo: String!) {
-        user(login: $login) {
-          repository(name: $repo) {
-            ...RepoInfo
-          }
-        }
-        organization(login: $login) {
-          repository(name: $repo) {
-            ...RepoInfo
-          }
-        }
-      }
-    `,
-      variables,
-    },
-    {
-      Authorization: `token ${token}`,
-    },
-  );
-};
-
-const urlExample = "/api/pin?username=USERNAME&repo=REPO_NAME";
-
-/**
- * @typedef {import("./types").RepositoryData} RepositoryData Repository data.
- */
-
-/**
- * Fetch repository data.
- *
- * @param {string} username GitHub username.
- * @param {string} reponame GitHub repository name.
- * @returns {Promise<RepositoryData>} Repository data.
- */
-const fetchRepo = async (
-  username,
-  reponame,
-  include_prs_authored = false,
-  include_prs_commented = false,
-  include_prs_reviewed = false,
-  include_issues_authored = false,
-  include_issues_commented = false,
-  pat = null,
-) => {
-  let owner = username;
-  if (reponame && reponame.includes("/")) {
-    const [parsed_owner, parsed_repo] = reponame.split("/");
-    owner = parsed_owner;
-    reponame = parsed_repo;
-  }
-
-  if (owner && !username) {
-    username = owner;
-  }
-  if (username && !owner) {
-    owner = username;
-  }
-  if (!username && !reponame) {
-    throw new MissingParamError(["username", "repo"], urlExample);
-  }
-  if (!username) {
-    throw new MissingParamError(["username"], urlExample);
-  }
-  if (!reponame) {
-    throw new MissingParamError(["repo"], urlExample);
-  }
-
-  let res = await retryer(fetcher, { login: owner, repo: reponame }, pat);
-
-  const data = res.data.data;
-
-  if (!data.user && !data.organization) {
-    throw new Error("Not found");
-  }
-
-  const isUser = data.organization === null && data.user;
-  const isOrg = data.user === null && data.organization;
-
-  if (isUser) {
-    if (!data.user.repository || data.user.repository.isPrivate) {
-      throw new Error("User Repository Not found");
-    }
-    let repoUserStats = await fetchRepoUserStats(
-      username,
-      [owner + "/" + reponame],
-      [],
-      include_prs_authored,
-      include_prs_commented,
-      include_prs_reviewed,
-      include_issues_authored,
-      include_issues_commented,
-      pat,
-    );
-    return {
-      ...repoUserStats,
-      ...data.user.repository,
-      starCount: data.user.repository.stargazerCount,
-    };
-  }
-
-  if (isOrg) {
-    if (
-      !data.organization.repository ||
-      data.organization.repository.isPrivate
-    ) {
-      throw new Error("Organization Repository Not found");
-    }
-    let repoUserStats = await fetchRepoUserStats(
-      username,
-      [owner + "/" + reponame],
-      [],
-      include_prs_authored,
-      include_prs_commented,
-      include_prs_reviewed,
-      include_issues_authored,
-      include_issues_commented,
-      pat,
-    );
-    return {
-      ...repoUserStats,
-      ...data.organization.repository,
-      starCount: data.organization.repository.stargazerCount,
-    };
-  }
-
-  throw new Error("Unexpected behavior");
-};
-
-export { fetchRepo };

package/src/fetchers/stats.js

@@ -1,473 +0,0 @@
-import axios from "axios";
-import githubUsernameRegex from "github-username-regex";
-
-import { calculateRank } from "../calculateRank.js";
-import { getConfig } from "../common/config.js";
-import { CustomError, MissingParamError } from "../common/error.js";
-import { wrapTextMultiline } from "../common/fmt.js";
-import { request } from "../common/http.js";
-import { logger } from "../common/log.js";
-import { buildSearchFilter, parseOwnerAffiliations } from "../common/ops.js";
-import { retryer } from "../common/retryer.js";
-
-// GraphQL queries.
-const GRAPHQL_REPOS_FIELD = `
-  repositories(first: 100, after: $after, ownerAffiliations: $ownerAffiliations, orderBy: {direction: DESC, field: STARGAZERS}) {
-    totalCount
-    nodes {
-      name
-      stargazerCount
-    }
-    pageInfo {
-      hasNextPage
-      endCursor
-    }
-  }
-`;
-
-const GRAPHQL_REPOS_QUERY = `
-  query userInfo($login: String!, $after: String, $ownerAffiliations: [RepositoryAffiliation]) {
-    user(login: $login) {
-      ${GRAPHQL_REPOS_FIELD}
-    }
-  }
-`;
-
-const GRAPHQL_STATS_QUERY = `
-  query userInfo($login: String!, $after: String, $includeMergedPullRequests: Boolean!, $includeDiscussions: Boolean!, $includeDiscussionsAnswers: Boolean!, $startTime: DateTime = null, $ownerAffiliations: [RepositoryAffiliation]) {
-    user(login: $login) {
-      name
-      login
-      commits: contributionsCollection (from: $startTime) {
-        totalCommitContributions,
-      }
-      reviews: contributionsCollection {
-        totalPullRequestReviewContributions
-      }
-      repositoriesContributedTo(first: 1, contributionTypes: [COMMIT, ISSUE, PULL_REQUEST, REPOSITORY]) {
-        totalCount
-      }
-      pullRequests(first: 1) {
-        totalCount
-      }
-      mergedPullRequests: pullRequests(states: MERGED) @include(if: $includeMergedPullRequests) {
-        totalCount
-      }
-      openIssues: issues(states: OPEN) {
-        totalCount
-      }
-      closedIssues: issues(states: CLOSED) {
-        totalCount
-      }
-      followers {
-        totalCount
-      }
-      repositoryDiscussions @include(if: $includeDiscussions) {
-        totalCount
-      }
-      repositoryDiscussionComments(onlyAnswers: true) @include(if: $includeDiscussionsAnswers) {
-        totalCount
-      }
-      ${GRAPHQL_REPOS_FIELD}
-    }
-  }
-`;
-
-/**
- * Stats fetcher object.
- *
- * @param {object & { after: string | null }} variables Fetcher variables.
- * @param {string} token GitHub token.
- * @returns {Promise<import('axios').AxiosResponse>} Axios response.
- */
-const fetcher = (variables, token) => {
-  const query = variables.after ? GRAPHQL_REPOS_QUERY : GRAPHQL_STATS_QUERY;
-  return request(
-    {
-      query,
-      variables,
-    },
-    {
-      Authorization: `bearer ${token}`,
-    },
-  );
-};
-
-/**
- * Fetch stats information for a given username.
- *
- * @param {object} variables Fetcher variables.
- * @param {string} variables.username GitHub username.
- * @param {boolean} variables.includeMergedPullRequests Include merged pull requests.
- * @param {boolean} variables.includeDiscussions Include discussions.
- * @param {boolean} variables.includeDiscussionsAnswers Include discussions answers.
- * @param {string|undefined} variables.startTime Time to start the count of total commits.
- * @param {string[]} variables.ownerAffiliations The owner affiliations to filter by. Default: OWNER.
- * @param {string | null} variables.pat PAT override or null.
- * @returns {Promise<import('axios').AxiosResponse>} Axios response.
- *
- * @description This function supports multi-page fetching if the 'FETCH_MULTI_PAGE_STARS' environment variable is set to true or a limit of fetches.
- */
-const statsFetcher = async ({
-  username,
-  includeMergedPullRequests,
-  includeDiscussions,
-  includeDiscussionsAnswers,
-  startTime,
-  ownerAffiliations,
-  pat,
-}) => {
-  let stats;
-  let hasNextPage = true;
-  let endCursor = null;
-  let fetchedPages = 0;
-  while (hasNextPage) {
-    const variables = {
-      login: username,
-      first: 100,
-      after: endCursor,
-      includeMergedPullRequests,
-      includeDiscussions,
-      includeDiscussionsAnswers,
-      startTime,
-      ownerAffiliations,
-    };
-    let res = await retryer(fetcher, variables, pat);
-    if (res.data.errors) {
-      return res;
-    }
-
-    // Store stats data.
-    const repoNodes = res.data.data.user.repositories.nodes;
-    if (stats) {
-      if (fetchedPages === 1) {
-        // make deep copy of relevant stats fields to avoid altering the cached response object in frontend
-        stats = structuredClone({
-          data: stats.data,
-          statusText: stats.statusText,
-        });
-      }
-      stats.data.data.user.repositories.nodes.push(...repoNodes);
-    } else {
-      stats = res;
-    }
-
-    fetchedPages++;
-    const repoNodesWithStars = repoNodes.filter(
-      (node) => node.stargazerCount !== 0,
-    );
-
-    hasNextPage =
-      (getConfig().fetchMultiPageStars === "true" ||
-        getConfig().fetchMultiPageStars > fetchedPages) &&
-      repoNodes.length === repoNodesWithStars.length &&
-      res.data.data.user.repositories.pageInfo.hasNextPage;
-
-    endCursor = res.data.data.user.repositories.pageInfo.endCursor;
-  }
-
-  return stats;
-};
-
-/**
- * Fetch total commits using the REST API.
- *
- * @param {object} variables Fetcher variables.
- * @param {string} token GitHub token.
- * @returns {Promise<import('axios').AxiosResponse>} Axios response.
- *
- * @see https://developer.github.com/v3/search/#search-commits
- */
-const fetchTotalItems = (variables, token) => {
-  return axios({
-    method: "get",
-    url:
-      `https://api.github.com/search/` +
-      variables.type +
-      `?per_page=1&q=` +
-      buildSearchFilter(variables.repo, variables.owner).replaceAll(" ", "+") +
-      variables.filter,
-    headers: {
-      "Content-Type": "application/json",
-      Accept: "application/vnd.github.cloak-preview",
-      Authorization: `token ${token}`,
-    },
-  });
-};
-
-/**
- * Fetch all the commits for all the repositories of a given username.
- *
- * @param {string} username GitHub username.
- * @returns {Promise<number>} Total commits.
- *
- * @description Done like this because the GitHub API does not provide a way to fetch all the commits. See
- * #92#issuecomment-661026467 and #211 for more information.
- */
-const totalItemsFetcher = async (username, repo, owner, type, filter, pat) => {
-  if (!githubUsernameRegex.test(username)) {
-    logger.log("Invalid username provided.");
-    throw new Error("Invalid username provided.");
-  }
-
-  let res;
-  try {
-    res = await retryer(
-      fetchTotalItems,
-      {
-        login: username,
-        repo,
-        owner,
-        type,
-        filter,
-      },
-      pat,
-    );
-  } catch (err) {
-    logger.log(err);
-    throw err;
-  }
-
-  const totalCount = res.data.total_count;
-  if (isNaN(totalCount)) {
-    logger.error("GitHub error: " + JSON.stringify(res.data));
-    throw new CustomError(
-      "Could not fetch data from GitHub REST API.",
-      CustomError.GITHUB_REST_API_ERROR,
-    );
-  }
-  return totalCount;
-};
-
-const fetchRepoUserStats = async (
-  username,
-  repo,
-  owner,
-  include_prs_authored,
-  include_prs_commented,
-  include_prs_reviewed,
-  include_issues_authored,
-  include_issues_commented,
-  pat,
-) => {
-  let stats = {};
-  if (include_prs_authored) {
-    stats.totalPRsAuthored = await totalItemsFetcher(
-      username,
-      repo,
-      owner,
-      "issues",
-      `author:${username}+type:pr`,
-      pat,
-    );
-  }
-  if (include_prs_commented) {
-    stats.totalPRsCommented = await totalItemsFetcher(
-      username,
-      repo,
-      owner,
-      "issues",
-      `commenter:${username}+-author:${username}+type:pr`,
-      pat,
-    );
-  }
-  if (include_prs_reviewed) {
-    stats.totalPRsReviewed = await totalItemsFetcher(
-      username,
-      repo,
-      owner,
-      "issues",
-      `reviewed-by:${username}+-author:${username}+type:pr`,
-      pat,
-    );
-  }
-  if (include_issues_authored) {
-    stats.totalIssuesAuthored = await totalItemsFetcher(
-      username,
-      repo,
-      owner,
-      "issues",
-      `author:${username}+type:issue`,
-      pat,
-    );
-  }
-  if (include_issues_commented) {
-    stats.totalIssuesCommented = await totalItemsFetcher(
-      username,
-      repo,
-      owner,
-      "issues",
-      `commenter:${username}+-author:${username}+type:issue`,
-      pat,
-    );
-  }
-  return stats;
-};
-
-/**
- * Fetch stats for a given username.
- *
- * @param {string} username GitHub username.
- * @param {boolean} include_all_commits Include all commits.
- * @param {string[]} exclude_repo Repositories to exclude.
- * @param {boolean} include_merged_pull_requests Include merged pull requests.
- * @param {boolean} include_discussions Include discussions.
- * @param {boolean} include_discussions_answers Include discussions answers.
- * @param {number|undefined} commits_year Year to count total commits
- * @param {string[]} ownerAffiliations Owner affiliations. Default: OWNER.
- * @returns {Promise<import("./types").StatsData>} Stats data.
- */
-const fetchStats = async (
-  username,
-  include_all_commits = false,
-  exclude_repo = [],
-  include_merged_pull_requests = false,
-  include_discussions = false,
-  include_discussions_answers = false,
-  commits_year,
-  repo = [],
-  owner = [],
-  include_prs_authored = false,
-  include_prs_commented = false,
-  include_prs_reviewed = false,
-  include_issues_authored = false,
-  include_issues_commented = false,
-  ownerAffiliations = [],
-  pat = null,
-) => {
-  if (!username) {
-    throw new MissingParamError(["username"]);
-  }
-
-  const stats = {
-    name: "",
-    totalPRs: 0,
-    totalPRsMerged: 0,
-    mergedPRsPercentage: 0,
-    totalReviews: 0,
-    totalCommits: 0,
-    totalIssues: 0,
-    totalStars: 0,
-    totalDiscussionsStarted: 0,
-    totalDiscussionsAnswered: 0,
-    contributedTo: 0,
-    totalPRsAuthored: 0,
-    totalPRsCommented: 0,
-    totalPRsReviewed: 0,
-    totalIssuesAuthored: 0,
-    totalIssuesCommented: 0,
-    rank: { level: "C", percentile: 100 },
-  };
-  ownerAffiliations = parseOwnerAffiliations(ownerAffiliations);
-
-  let res = await statsFetcher(
-    {
-      username,
-      includeMergedPullRequests: include_merged_pull_requests,
-      includeDiscussions: include_discussions,
-      includeDiscussionsAnswers: include_discussions_answers,
-      startTime: commits_year ? `${commits_year}-01-01T00:00:00Z` : undefined,
-      ownerAffiliations,
-    },
-    pat,
-  );
-
-  // Catch GraphQL errors.
-  if (res.data.errors) {
-    logger.error(res.data.errors);
-    if (res.data.errors[0].type === "NOT_FOUND") {
-      throw new CustomError(
-        res.data.errors[0].message || "Could not fetch user.",
-        CustomError.USER_NOT_FOUND,
-      );
-    }
-    if (res.data.errors[0].message) {
-      throw new CustomError(
-        wrapTextMultiline(res.data.errors[0].message, 525, 12)[0],
-        res.statusText,
-      );
-    }
-    throw new CustomError(
-      "Something went wrong while trying to retrieve the stats data using the GraphQL API.",
-      CustomError.GRAPHQL_ERROR,
-    );
-  }
-
-  const user = res.data.data.user;
-
-  stats.name = user.name || user.login;
-
-  // if include_all_commits, fetch all commits using the REST API.
-  if (include_all_commits) {
-    stats.totalCommits = await totalItemsFetcher(
-      username,
-      repo,
-      owner,
-      "commits",
-      `author:${username}`,
-      pat,
-    );
-  } else {
-    stats.totalCommits = user.commits.totalCommitContributions;
-  }
-  let repoUserStats = await fetchRepoUserStats(
-    username,
-    repo,
-    owner,
-    include_prs_authored,
-    include_prs_commented,
-    include_prs_reviewed,
-    include_issues_authored,
-    include_issues_commented,
-    pat,
-  );
-  Object.assign(stats, repoUserStats);
-
-  stats.totalPRs = user.pullRequests.totalCount;
-  if (include_merged_pull_requests) {
-    stats.totalPRsMerged = user.mergedPullRequests.totalCount;
-    stats.mergedPRsPercentage =
-      (user.mergedPullRequests.totalCount / user.pullRequests.totalCount) *
-        100 || 0;
-  }
-  stats.totalReviews = user.reviews.totalPullRequestReviewContributions;
-  stats.totalIssues = user.openIssues.totalCount + user.closedIssues.totalCount;
-  if (include_discussions) {
-    stats.totalDiscussionsStarted = user.repositoryDiscussions.totalCount;
-  }
-  if (include_discussions_answers) {
-    stats.totalDiscussionsAnswered =
-      user.repositoryDiscussionComments.totalCount;
-  }
-  stats.contributedTo = user.repositoriesContributedTo.totalCount;
-
-  // Retrieve stars while filtering out repositories to be hidden.
-  const allExcludedRepos = [
-    ...exclude_repo,
-    ...getConfig().excludeRepositories,
-  ];
-  let repoToHide = new Set(allExcludedRepos);
-
-  stats.totalStars = user.repositories.nodes
-    .filter((data) => {
-      return !repoToHide.has(data.name);
-    })
-    .reduce((prev, curr) => {
-      return prev + curr.stargazerCount;
-    }, 0);
-
-  stats.rank = calculateRank({
-    all_commits: include_all_commits,
-    commits: stats.totalCommits,
-    prs: stats.totalPRs,
-    reviews: stats.totalReviews,
-    issues: stats.totalIssues,
-    repos: user.repositories.totalCount,
-    stars: stats.totalStars,
-    followers: user.followers.totalCount,
-  });
-
-  return stats;
-};
-
-export { fetchStats, fetchRepoUserStats };