@stats-forge/github-stats-forge-core 0.0.1

package/src/graphql/generated/stats.ts

@@ -0,0 +1,180 @@
+// Generated file — see .github/CONTRIBUTING.md
+
+/** Internal type. DO NOT USE DIRECTLY. */
+type Exact<T extends { [key: string]: unknown }> = { [K in keyof T]: T[K] };
+import { graphqlDocument } from '../graphqlDocument.js';
+
+import type * as Types from './common.js';
+export type RepoNodeFragment = { name: string; stargazerCount: number };
+
+export type RepoStarsFragment = {
+  repositories: {
+    totalCount: number;
+    nodes: Array<{ name: string; stargazerCount: number } | null> | null;
+    pageInfo: { hasNextPage: boolean; endCursor: string | null };
+  };
+};
+
+export type UserReposQueryVariables = Exact<{
+  login: string;
+  after?: string | null | undefined;
+  ownerAffiliations?:
+    | Array<Types.RepositoryAffiliation | null | undefined>
+    | Types.RepositoryAffiliation
+    | null
+    | undefined;
+}>;
+
+export type UserReposQuery = {
+  user: {
+    repositories: {
+      totalCount: number;
+      nodes: Array<{ name: string; stargazerCount: number } | null> | null;
+      pageInfo: { hasNextPage: boolean; endCursor: string | null };
+    };
+  } | null;
+};
+
+export type UserInfoQueryVariables = Exact<{
+  login: string;
+  after?: string | null | undefined;
+  includeMergedPullRequests: boolean;
+  includeDiscussions: boolean;
+  includeDiscussionsAnswers: boolean;
+  startTime?: string | null | undefined;
+  ownerAffiliations?:
+    | Array<Types.RepositoryAffiliation | null | undefined>
+    | Types.RepositoryAffiliation
+    | null
+    | undefined;
+  includeUserRepositories: boolean;
+}>;
+
+export type UserInfoQuery = {
+  user: {
+    name: string | null;
+    login: string;
+    commits: { totalCommitContributions: number };
+    reviews: { totalPullRequestReviewContributions: number };
+    repositoriesContributedTo: { totalCount: number };
+    pullRequests: { totalCount: number };
+    mergedPullRequests?: { totalCount: number };
+    openIssues: { totalCount: number };
+    closedIssues: { totalCount: number };
+    followers: { totalCount: number };
+    repositoryDiscussions?: { totalCount: number };
+    repositoryDiscussionComments?: { totalCount: number };
+    contributionsCollection: { contributionYears: Array<number> };
+    repositories: {
+      totalCount: number;
+      nodes: Array<{ name: string; stargazerCount: number } | null> | null;
+      pageInfo: { hasNextPage: boolean; endCursor: string | null };
+    };
+  } | null;
+};
+
+export type YearContributionsFragment = { contributionCalendar: { totalContributions: number } };
+
+export type RangeContributionsByRepoFragment = {
+  commitContributionsByRepository: Array<{ repository: { nameWithOwner: string } }>;
+  issueContributionsByRepository: Array<{ repository: { nameWithOwner: string } }>;
+  pullRequestContributionsByRepository: Array<{ repository: { nameWithOwner: string } }>;
+  repositoryContributions?: {
+    nodes: Array<{ repository: { nameWithOwner: string } } | null> | null;
+  };
+};
+
+export const UserReposDocument = graphqlDocument<UserReposQuery, UserReposQueryVariables>(`
+query userRepos($login: String!, $after: String, $ownerAffiliations: [RepositoryAffiliation]) {
+  user(login: $login) {
+    ...RepoStars
+  }
+}
+fragment RepoStars on User {
+  repositories(
+    first: 100
+    after: $after
+    ownerAffiliations: $ownerAffiliations
+    orderBy: {direction: DESC, field: STARGAZERS}
+  ) {
+    totalCount
+    nodes {
+      ...RepoNode
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+  }
+}
+fragment RepoNode on Repository {
+  name
+  stargazerCount
+}`);
+
+export const UserInfoDocument = graphqlDocument<UserInfoQuery, UserInfoQueryVariables>(`
+query userInfo($login: String!, $after: String, $includeMergedPullRequests: Boolean!, $includeDiscussions: Boolean!, $includeDiscussionsAnswers: Boolean!, $startTime: DateTime = null, $ownerAffiliations: [RepositoryAffiliation], $includeUserRepositories: Boolean!) {
+  user(login: $login) {
+    name
+    login
+    commits: contributionsCollection(from: $startTime) {
+      totalCommitContributions
+    }
+    reviews: contributionsCollection {
+      totalPullRequestReviewContributions
+    }
+    repositoriesContributedTo(
+      first: 1
+      contributionTypes: [COMMIT, ISSUE, PULL_REQUEST, REPOSITORY]
+      includeUserRepositories: $includeUserRepositories
+    ) {
+      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
+    }
+    contributionsCollection {
+      contributionYears
+    }
+    ...RepoStars
+  }
+}
+fragment RepoStars on User {
+  repositories(
+    first: 100
+    after: $after
+    ownerAffiliations: $ownerAffiliations
+    orderBy: {direction: DESC, field: STARGAZERS}
+  ) {
+    totalCount
+    nodes {
+      ...RepoNode
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+  }
+}
+fragment RepoNode on Repository {
+  name
+  stargazerCount
+}`);

package/src/graphql/generated/top-languages.ts

@@ -0,0 +1,66 @@
+// Generated file — see .github/CONTRIBUTING.md
+
+/** Internal type. DO NOT USE DIRECTLY. */
+type Exact<T extends { [key: string]: unknown }> = { [K in keyof T]: T[K] };
+import { graphqlDocument } from '../graphqlDocument.js';
+
+import type * as Types from './common.js';
+export type TopLanguageFragment = { size: number; node: { color: string | null; name: string } };
+
+export type TopLanguagesRepositoryFragment = {
+  name: string;
+  languages: {
+    edges: Array<{ size: number; node: { color: string | null; name: string } } | null> | null;
+  } | null;
+};
+
+export type TopLanguagesQueryVariables = Exact<{
+  login: string;
+  ownerAffiliations?:
+    | Array<Types.RepositoryAffiliation | null | undefined>
+    | Types.RepositoryAffiliation
+    | null
+    | undefined;
+}>;
+
+export type TopLanguagesQuery = {
+  user: {
+    repositories: {
+      nodes: Array<{
+        name: string;
+        languages: {
+          edges: Array<{
+            size: number;
+            node: { color: string | null; name: string };
+          } | null> | null;
+        } | null;
+      } | null> | null;
+    };
+  } | null;
+};
+
+export const TopLanguagesDocument = graphqlDocument<TopLanguagesQuery, TopLanguagesQueryVariables>(`
+query topLanguages($login: String!, $ownerAffiliations: [RepositoryAffiliation]) {
+  user(login: $login) {
+    repositories(ownerAffiliations: $ownerAffiliations, isFork: false, first: 100) {
+      nodes {
+        ...TopLanguagesRepository
+      }
+    }
+  }
+}
+fragment TopLanguagesRepository on Repository {
+  name
+  languages(first: 10, orderBy: {field: SIZE, direction: DESC}) {
+    edges {
+      ...TopLanguage
+    }
+  }
+}
+fragment TopLanguage on LanguageEdge {
+  size
+  node {
+    color
+    name
+  }
+}`);

package/src/graphql/graphqlDocument.ts

@@ -0,0 +1,25 @@
+/**
+ * A GraphQL query paired with the types of its result and variables.
+ *
+ * `text` is what goes over the wire; the other two members only carry types and are never assigned.
+ * Documents are generated from `queries/*.graphql`
+ * See `scripts/generate-graphql-types.js`.
+ */
+interface GraphQLDocument<TResult, TVariables> {
+  readonly text: string;
+  readonly __result?: TResult;
+  readonly __variables?: TVariables;
+}
+
+/**
+ * Build a typed document.
+ *
+ * @param text The query text, including every fragment it spreads.
+ * @returns The document to pass to the function created by `createGraphQLFetcher`.
+ */
+const graphqlDocument = <TResult, TVariables>(
+  text: string,
+): GraphQLDocument<TResult, TVariables> => ({ text });
+
+export { graphqlDocument };
+export type { GraphQLDocument };

package/src/graphql/queries/gist.graphql

@@ -0,0 +1,25 @@
+fragment GistFileInfo on GistFile {
+  name
+  language {
+    name
+  }
+  size
+}
+
+query gistInfo($gistName: String!) {
+  viewer {
+    gist(name: $gistName) {
+      description
+      owner {
+        login
+      }
+      stargazerCount
+      forks {
+        totalCount
+      }
+      files {
+        ...GistFileInfo
+      }
+    }
+  }
+}

package/src/graphql/queries/repo.graphql

@@ -0,0 +1,28 @@
+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
+    }
+  }
+}

package/src/graphql/queries/stats.graphql

@@ -0,0 +1,113 @@
+fragment RepoNode on Repository {
+  name
+  stargazerCount
+}
+
+fragment RepoStars on User {
+  repositories(
+    first: 100
+    after: $after
+    ownerAffiliations: $ownerAffiliations
+    orderBy: { direction: DESC, field: STARGAZERS }
+  ) {
+    totalCount
+    nodes {
+      ...RepoNode
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+  }
+}
+
+query userRepos($login: String!, $after: String, $ownerAffiliations: [RepositoryAffiliation]) {
+  user(login: $login) {
+    ...RepoStars
+  }
+}
+
+query userInfo(
+  $login: String!
+  $after: String
+  $includeMergedPullRequests: Boolean!
+  $includeDiscussions: Boolean!
+  $includeDiscussionsAnswers: Boolean!
+  $startTime: DateTime = null
+  $ownerAffiliations: [RepositoryAffiliation]
+  $includeUserRepositories: Boolean!
+) {
+  user(login: $login) {
+    name
+    login
+    commits: contributionsCollection(from: $startTime) {
+      totalCommitContributions
+    }
+    reviews: contributionsCollection {
+      totalPullRequestReviewContributions
+    }
+    repositoriesContributedTo(
+      first: 1
+      contributionTypes: [COMMIT, ISSUE, PULL_REQUEST, REPOSITORY]
+      includeUserRepositories: $includeUserRepositories
+    ) {
+      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
+    }
+    contributionsCollection {
+      contributionYears
+    }
+    ...RepoStars
+  }
+}
+
+fragment YearContributions on ContributionsCollection {
+  contributionCalendar {
+    totalContributions
+  }
+}
+
+fragment RangeContributionsByRepo on ContributionsCollection {
+  commitContributionsByRepository(maxRepositories: $maxRepositories) {
+    repository {
+      nameWithOwner
+    }
+  }
+  issueContributionsByRepository(maxRepositories: $maxRepositories) {
+    repository {
+      nameWithOwner
+    }
+  }
+  pullRequestContributionsByRepository(maxRepositories: $maxRepositories) {
+    repository {
+      nameWithOwner
+    }
+  }
+  repositoryContributions(first: $maxRepositories) @include(if: $includeOwnRepos) {
+    nodes {
+      repository {
+        nameWithOwner
+      }
+    }
+  }
+}

package/src/graphql/queries/top-languages.graphql

@@ -0,0 +1,27 @@
+fragment TopLanguage on LanguageEdge {
+  size
+  node {
+    color
+    name
+  }
+}
+
+fragment TopLanguagesRepository on Repository {
+  name
+  languages(first: 10, orderBy: { field: SIZE, direction: DESC }) {
+    edges {
+      ...TopLanguage
+    }
+  }
+}
+
+query topLanguages($login: String!, $ownerAffiliations: [RepositoryAffiliation]) {
+  user(login: $login) {
+    # do not fetch forks
+    repositories(ownerAffiliations: $ownerAffiliations, isFork: false, first: 100) {
+      nodes {
+        ...TopLanguagesRepository
+      }
+    }
+  }
+}

package/src/graphql/reposContributedToDocument.ts

@@ -0,0 +1,83 @@
+import type { GitHubDateRange } from '../common/date.js';
+import { toGitHubDateTime } from '../common/date.js';
+
+import type { RangeContributionsByRepoFragment } from './generated/stats.js';
+import { graphqlDocument } from './graphqlDocument.js';
+
+/** max value GitHub allows for `first/maxRepositories` */
+const MAX_REPOSITORIES_LIMIT = 100;
+
+interface ReposContributedToQueryVariables {
+  login: string;
+  maxRepositories: number;
+}
+
+interface ReposContributedToQuery {
+  user: Record<`range_${number}`, RangeContributionsByRepoFragment> | null;
+}
+
+/**
+ * Build a query for the repositories a user contributed to within multiple time
+ * ranges. One aliased `contributionsCollection` field per range, so all ranges
+ * are fetched in a single request. The shape is only known at runtime.
+ *
+ * Mirrors the `contributionTypes: [COMMIT, ISSUE, PULL_REQUEST, REPOSITORY]`
+ * filter used by `repositoriesContributedTo` in `stats.graphql`.
+ *
+ * @param ranges Ranges to fetch, one `range_<index>` alias each.
+ * @param includeOwnRepos Whether to select `repositoryContributions`.
+ * @returns Document for `createGraphQLFetcher`.
+ */
+const buildReposContributedToDocument = (
+  ranges: Array<GitHubDateRange>,
+  includeOwnRepos: boolean,
+) => {
+  const rangeFields = ranges
+    .map(
+      ({ from, to }, index) =>
+        `range_${index}: contributionsCollection(from: "${toGitHubDateTime(from)}", to: "${toGitHubDateTime(to)}") { ...RangeContributionsByRepo }`,
+    )
+    .join('\n');
+
+  // `repositoryContributions` only ever returns repos the user owns,
+  // so it is left out rather than gated with @include: an excluded field still counts toward the query's node cost.
+  // stats.graphql carries the directive so the generated type marks the field optional.
+  const ownRepoField = includeOwnRepos
+    ? `repositoryContributions(first: $maxRepositories) {
+    nodes {
+      repository {
+        nameWithOwner
+      }
+    }
+  }`
+    : '';
+
+  // fragment must match queries/stats.graphql, which generates its type
+  return graphqlDocument<ReposContributedToQuery, ReposContributedToQueryVariables>(`
+query userReposContributedTo($login: String!, $maxRepositories: Int!) {
+  user(login: $login) {
+    ${rangeFields}
+  }
+}
+fragment RangeContributionsByRepo on ContributionsCollection {
+  commitContributionsByRepository(maxRepositories: $maxRepositories) {
+    repository {
+      nameWithOwner
+    }
+  }
+  issueContributionsByRepository(maxRepositories: $maxRepositories) {
+    repository {
+      nameWithOwner
+    }
+  }
+  pullRequestContributionsByRepository(maxRepositories: $maxRepositories) {
+    repository {
+      nameWithOwner
+    }
+  }
+  ${ownRepoField}
+}`);
+};
+
+export { buildReposContributedToDocument, MAX_REPOSITORIES_LIMIT };
+export type { ReposContributedToQuery };

package/src/index.ts

@@ -0,0 +1,18 @@
+export { fetchWakatimeStats } from './fetchers/wakatime.js';
+export { retryer } from './common/retryer.js';
+
+export { renderError } from './common/render.js';
+
+export type { ApiError, ApiResult } from './api/api-result.js';
+export { gist } from './api/gist.js';
+export { stats } from './api/stats.js';
+export { pin } from './api/pin.js';
+export { topLangs } from './api/top-langs.js';
+export { wakatime } from './api/wakatime.js';
+
+export { CardConfig } from './common/config.js';
+export type { PersonalAccessToken } from './common/config.js';
+export type { FetchLike } from './common/http.js';
+
+export { themes } from './themes/index.js';
+export type { ThemeName } from './themes/index.js';