@stats-forge/github-stats-forge-core 0.0.2 → 0.1.0

package/build/fetchers/gist.d.ts

@@ -1,11 +1,8 @@
-import type { CardConfig } from '../common/config.js';
-import type { GistData } from './types.js';
+import type { CardConfig } from '../common/config.ts';
+import type { GistData } from './types.ts';
 /**
  * Fetch GitHub gist information by given username and ID.
  *
- * @param props Fetcher props.
- * @param props.id GitHub gist ID.
- * @param config Deployment config supplying the PAT pool.
  * @returns Gist data.
  */
 declare const fetchGist: ({ id }: {

package/build/fetchers/gist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/fetchers/gist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA+B3C;;;;;;;GAOG;AACH,QAAA,MAAM,SAAS,GACb,QAAQ;IAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAClC,QAAQ,UAAU,KACjB,OAAO,CAAC,QAAQ,CA8BlB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/fetchers/gist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA8B3C;;;;GAIG;AACH,QAAA,MAAM,SAAS,WACL;IAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,UAC1B,UAAU,KACjB,OAAO,CAAC,QAAQ,CA8BlB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/build/fetchers/gist.js

@@ -6,7 +6,6 @@ const fetcher = createGraphQLFetcher(GistInfoDocument, 'token');
 /**
  * This function calculates the primary language of a gist by files size.
  *
- * @param files Files.
  * @returns Primary language, or `null` when no file has a language.
  */
 const calculatePrimaryLanguage = (files) => {
@@ -29,9 +28,6 @@ const calculatePrimaryLanguage = (files) => {
 /**
  * Fetch GitHub gist information by given username and ID.
  *
- * @param props Fetcher props.
- * @param props.id GitHub gist ID.
- * @param config Deployment config supplying the PAT pool.
  * @returns Gist data.
  */
 const fetchGist = async ({ id }, config) => {
@@ -44,7 +40,7 @@ const fetchGist = async ({ id }, config) => {
             code: 'upstream',
         });
     }
-    const gist = res.data.data.viewer.gist;
+    const { gist } = res.data.data.viewer;
     if (!gist) {
         throw new CardError('Gist not found', {
             code: 'not_found',

package/build/fetchers/index.d.ts

@@ -1,13 +1,13 @@
-export { fetchGist } from './gist.js';
-export { fetchRepo } from './repo.js';
-export { fetchRepoUserStats, fetchStats } from './stats.js';
-export { fetchTopLanguages } from './top-languages.js';
-export { fetchWakatimeStats } from './wakatime.js';
-export type { GistData, Lang, RepoUserStats, RepositoryData, StatsData, TopLangData, WakaTimeData, WakaTimeLang, } from './types.js';
-export { CardConfig } from '../common/config.js';
-export type { CardConfigInit, PersonalAccessToken } from '../common/config.js';
-export type { FetchLike } from '../common/http.js';
-export { retryer } from '../common/retryer.js';
-export { CardError } from '../common/error.js';
-export type { ErrorCode } from '../common/error.js';
+export { fetchGist } from './gist.ts';
+export { fetchRepo } from './repo.ts';
+export { fetchRepoUserStats, fetchStats } from './stats.ts';
+export { fetchTopLanguages } from './top-languages.ts';
+export { fetchWakatimeStats } from './wakatime.ts';
+export type { GistData, Lang, RepoUserStats, RepositoryData, StatsData, TopLangData, WakaTimeData, WakaTimeLang, } from './types.ts';
+export { CardConfig } from '../common/config.ts';
+export type { CardConfigInit, PersonalAccessToken } from '../common/config.ts';
+export type { FetchLike } from '../common/http.ts';
+export { retryer } from '../common/retryer.ts';
+export { CardError } from '../common/error.ts';
+export type { ErrorCode } from '../common/error.ts';
 //# sourceMappingURL=index.d.ts.map

package/build/fetchers/repo.d.ts

@@ -1,17 +1,8 @@
-import type { CardConfig } from '../common/config.js';
-import type { RepositoryData } from './types.js';
+import type { CardConfig } from '../common/config.ts';
+import type { RepositoryData } from './types.ts';
 /**
  * Fetch repository data.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.reponame GitHub repository name.
- * @param props.include_prs_authored Include count of PRs authored.
- * @param props.include_prs_commented Include count of PRs commented.
- * @param props.include_prs_reviewed Include count of PRs reviewed.
- * @param props.include_issues_authored Include count of issues authored.
- * @param props.include_issues_commented Include count of issues commented.
- * @param config Deployment config supplying the PAT pool.
  * @returns Repository data.
  */
 declare const fetchRepo: ({ username, reponame, include_prs_authored, include_prs_commented, include_prs_reviewed, include_issues_authored, include_issues_commented, }: {

package/build/fetchers/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/fetchers/repo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,SAAS,GACb,+IAQG;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD,EACD,QAAQ,UAAU,KACjB,OAAO,CAAC,cAAc,CA2FxB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/fetchers/repo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;GAIG;AACH,QAAA,MAAM,SAAS,kJASV;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD,UACO,UAAU,KACjB,OAAO,CAAC,cAAc,CAuFxB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/build/fetchers/repo.js

@@ -8,43 +8,30 @@ const urlExample = '/api/pin?username=USERNAME&repo=REPO_NAME';
 /**
  * Fetch repository data.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.reponame GitHub repository name.
- * @param props.include_prs_authored Include count of PRs authored.
- * @param props.include_prs_commented Include count of PRs commented.
- * @param props.include_prs_reviewed Include count of PRs reviewed.
- * @param props.include_issues_authored Include count of issues authored.
- * @param props.include_issues_commented Include count of issues commented.
- * @param config Deployment config supplying the PAT pool.
  * @returns 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, }, config) => {
-    let owner = username;
-    if (reponame && reponame.includes('/')) {
-        const [parsedOwner, parsedRepo] = reponame.split('/');
-        owner = parsedOwner ?? '';
-        reponame = parsedRepo ?? '';
+    // `?repo=owner/name` carries the owner itself, and then it wins over `?username=`.
+    let parsedOwner = username;
+    let repo = reponame;
+    if (repo?.includes('/')) {
+        const [ownerFromRepo, nameFromRepo] = repo.split('/');
+        parsedOwner = ownerFromRepo ?? '';
+        repo = nameFromRepo ?? '';
     }
-    if (owner && !username) {
-        username = owner;
-    }
-    if (username && !owner) {
-        owner = username;
-    }
-    if (!username && !reponame) {
+    const login = username || parsedOwner;
+    if (!login && !repo) {
         throw CardError.missingParam(['username', 'repo'], urlExample);
     }
-    if (!username) {
+    if (!login) {
         throw CardError.missingParam(['username'], urlExample);
     }
-    if (!reponame) {
+    if (!repo) {
         throw CardError.missingParam(['repo'], urlExample);
     }
-    // the guards above leave `username` set, and `owner` mirrors it when `repo` carried none
-    const repoOwner = owner ?? username;
-    const res = await retryer(fetcher, { login: repoOwner, repo: reponame }, config);
-    const data = res.data.data;
+    const repoOwner = parsedOwner || login;
+    const res = await retryer(fetcher, { login: repoOwner, repo }, config);
+    const { data } = res.data;
     if (!data.user && !data.organization) {
         throw new CardError('Not found', {
             code: 'not_found',
@@ -52,7 +39,7 @@ const fetchRepo = async ({ username, reponame, include_prs_authored = false, inc
         });
     }
     if (data.organization === null && data.user) {
-        const repository = data.user.repository;
+        const { repository } = data.user;
         if (!repository || repository.isPrivate) {
             throw new CardError('User Repository Not found', {
                 code: 'not_found',
@@ -60,8 +47,8 @@ const fetchRepo = async ({ username, reponame, include_prs_authored = false, inc
             });
         }
         const repoUserStats = await fetchRepoUserStats({
-            username,
-            repo: [`${repoOwner}/${reponame}`],
+            username: login,
+            repo: [`${repoOwner}/${repo}`],
             include_prs_authored,
             include_prs_commented,
             include_prs_reviewed,
@@ -74,7 +61,7 @@ const fetchRepo = async ({ username, reponame, include_prs_authored = false, inc
         };
     }
     if (data.user === null && data.organization) {
-        const repository = data.organization.repository;
+        const { repository } = data.organization;
         if (!repository || repository.isPrivate) {
             throw new CardError('Organization Repository Not found', {
                 code: 'not_found',
@@ -82,8 +69,8 @@ const fetchRepo = async ({ username, reponame, include_prs_authored = false, inc
             });
         }
         const repoUserStats = await fetchRepoUserStats({
-            username,
-            repo: [`${repoOwner}/${reponame}`],
+            username: login,
+            repo: [`${repoOwner}/${repo}`],
             include_prs_authored,
             include_prs_commented,
             include_prs_reviewed,

package/build/fetchers/stats.d.ts

@@ -1,18 +1,8 @@
-import type { CardConfig } from '../common/config.js';
-import type { RepoUserStats, StatsData } from './types.js';
+import type { CardConfig } from '../common/config.ts';
+import type { RepoUserStats, StatsData } from './types.ts';
 /**
  * Fetch the per-repository counts the REST search API answers, one request each.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.repo Repositories the search is scoped to.
- * @param props.owner Owners the search is scoped to.
- * @param props.include_prs_authored Include count of PRs authored.
- * @param props.include_prs_commented Include count of PRs commented.
- * @param props.include_prs_reviewed Include count of PRs reviewed.
- * @param props.include_issues_authored Include count of issues authored.
- * @param props.include_issues_commented Include count of issues commented.
- * @param config Deployment config supplying the PAT pool.
  * @returns Only the counts that were asked for.
  */
 declare const fetchRepoUserStats: ({ username, repo, owner, include_prs_authored, include_prs_commented, include_prs_reviewed, include_issues_authored, include_issues_commented, }: {
@@ -28,26 +18,6 @@ declare const fetchRepoUserStats: ({ username, repo, owner, include_prs_authored
 /**
  * Fetch stats for a given username.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.include_all_commits Include all commits.
- * @param props.exclude_repo Repositories to exclude.
- * @param props.include_merged_pull_requests Include merged pull requests.
- * @param props.include_discussions Include discussions.
- * @param props.include_discussions_answers Include discussions answers.
- * @param props.commits_year Year to count total commits.
- * @param props.repo Repositories to scope the REST search to.
- * @param props.owner Owners to scope the REST search to.
- * @param props.include_prs_authored Include count of PRs authored.
- * @param props.include_prs_commented Include count of PRs commented.
- * @param props.include_prs_reviewed Include count of PRs reviewed.
- * @param props.include_issues_authored Include count of issues authored.
- * @param props.include_issues_commented Include count of issues commented.
- * @param props.ownerAffiliations Owner affiliations. Default: OWNER.
- * @param props.include_contributions Include all-time contributions.
- * @param props.include_all_time_contribs Include all-time count of repos contributed to.
- * @param props.contribs_include_own_repos Include user-owned repos in contributed-to counts.
- * @param config Deployment config supplying the PAT pool.
  * @returns Stats data.
  */
 declare const fetchStats: ({ username, include_all_commits, exclude_repo, include_merged_pull_requests, include_discussions, include_discussions_answers, commits_year, repo, owner, include_prs_authored, include_prs_commented, include_prs_reviewed, include_issues_authored, include_issues_commented, ownerAffiliations, include_contributions, include_all_time_contribs, contribs_include_own_repos, }: {

package/build/fetchers/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/fetchers/stats.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAuBtD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA+M3D;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,kBAAkB,GACtB,kJASG;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD,EACD,QAAQ,UAAU,KACjB,OAAO,CAAC,aAAa,CA+DvB,CAAC;AAsLF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,QAAA,MAAM,UAAU,GACd,oXAmBG;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD,EACD,QAAQ,UAAU,KACjB,OAAO,CAAC,SAAS,CA+JnB,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/fetchers/stats.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAwBtD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA4L3D;;;;GAIG;AACH,QAAA,MAAM,kBAAkB,qJAUnB;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD,UACO,UAAU,KACjB,OAAO,CAAC,aAAa,CA+DvB,CAAC;AA8KF;;;;GAIG;AACH,QAAA,MAAM,UAAU,uXAoBX;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD,UACO,UAAU,KACjB,OAAO,CAAC,SAAS,CA+JnB,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC"}

package/build/fetchers/stats.js

@@ -1,11 +1,11 @@
-import githubUsernameRegex from 'github-username-regex';
 import { calculateRank } from '../calculateRank.js';
+import { GITHUB_USERNAME_PATTERN } from '../common/constants.js';
 import { getGitHubYearRange, toGitHubDateTime } from '../common/date.js';
 import { CardError, USER_NOT_FOUND } from '../common/error.js';
-import { wrapTextMultiline } from '../common/fmt.js';
 import { createGraphQLFetcher, httpRequest } from '../common/http.js';
 import { logger } from '../common/log.js';
 import { buildSearchFilter, chunkArray, parseOwnerAffiliations } from '../common/ops.js';
+import { wrapTextMultiline } from '../common/render.js';
 import { retryer } from '../common/retryer.js';
 import { buildContributionsDocument } from '../graphql/contributionsDocument.js';
 import { UserInfoDocument, UserReposDocument } from '../graphql/generated/stats.js';
@@ -16,19 +16,10 @@ const reposFetcher = createGraphQLFetcher(UserReposDocument, 'bearer');
 /**
  * Fetch stats information for a given username.
  *
- * @param variables Fetcher variables.
- * @param variables.username GitHub username.
- * @param variables.includeMergedPullRequests Include merged pull requests.
- * @param variables.includeDiscussions Include discussions.
- * @param variables.includeDiscussionsAnswers Include discussions answers.
- * @param variables.startTime Time to start the count of total commits.
- * @param variables.ownerAffiliations The owner affiliations to filter by. Default: OWNER.
- * @param variables.includeUserRepositories Whether to include the user's own repositories in the repos contributed to.
- * @param config Deployment config supplying the PAT pool.
- * @returns The stats response, with every fetched page's repos merged in.
- *
  * @description Supports multi-page fetching when the `FETCH_MULTI_PAGE_STARS`
  * env variable is `true` or a fetch limit.
+ *
+ * @returns The stats response, with every fetched page's repos merged in.
  */
 const statsFetcher = async ({ username, includeMergedPullRequests, includeDiscussions, includeDiscussionsAnswers, startTime, ownerAffiliations, includeUserRepositories, }, config) => {
     // only the first request carries the stats themselves
@@ -69,10 +60,10 @@ const statsFetcher = async ({ username, includeMergedPullRequests, includeDiscus
         }
         pageRepositories = page.data.data.user?.repositories;
         extraRepoNodes.push(...(pageRepositories?.nodes ?? []));
-        fetchedPages++;
+        fetchedPages += 1;
     }
     if (extraRepoNodes.length > 0) {
-        // deep copy to avoid mutating the response cached by the frontend
+        // defensive: the merge below is the only place a parsed response is mutated
         stats = structuredClone({
             data: stats.data,
             statusText: stats.statusText,
@@ -84,22 +75,16 @@ const statsFetcher = async ({ username, includeMergedPullRequests, includeDiscus
 /**
  * Fetch total items count using the REST search API.
  *
- * @param variables Fetcher variables.
- * @param token GitHub token.
- * @param context What the retryer supplies each attempt.
- * @param context.fetch Transport to send the request with.
- * @returns The search response, carrying `total_count`.
- *
  * @see https://developer.github.com/v3/search/#search-commits
+ *
+ * @returns The search response, carrying `total_count`.
  */
 const fetchTotalItems = (variables, token, { fetch }) => {
     const type = String(variables['type']);
     const filter = String(variables['filter']);
     const repo = variables['repo'];
     const owner = variables['owner'];
-    return httpRequest(fetch, `https://api.github.com/search/${type}?per_page=1&q=` +
-        buildSearchFilter(repo, owner).replaceAll(' ', '+') +
-        filter, {
+    return httpRequest(fetch, `https://api.github.com/search/${type}?per_page=1&q=${buildSearchFilter(repo, owner).replaceAll(' ', '+')}${filter}`, {
         method: 'GET',
         headers: {
             'Content-Type': 'application/json',
@@ -111,21 +96,14 @@ const fetchTotalItems = (variables, token, { fetch }) => {
 /**
  * Fetch a total count for a given username via the REST search API.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.repo Repositories the search is scoped to.
- * @param props.owner Owners the search is scoped to.
- * @param props.type Search endpoint to hit, `issues` or `commits`.
- * @param props.filter Query fragment appended to the scope filter.
- * @param config Deployment config supplying the PAT pool.
- * @returns Total count.
- *
  * The GraphQL API can't return this.
  * @see https://github.com/anuraghazra/github-readme-stats/issues/92#issuecomment-661026467
  * @see https://github.com/anuraghazra/github-readme-stats/pull/211
+ *
+ * @returns Total count.
  */
 const totalItemsFetcher = async ({ username, repo, owner, type, filter, }, config) => {
-    if (!githubUsernameRegex.test(username)) {
+    if (!GITHUB_USERNAME_PATTERN.test(username)) {
         logger.log('Invalid username provided.');
         throw new CardError('Invalid username provided.', {
             code: 'invalid_param',
@@ -136,13 +114,13 @@ const totalItemsFetcher = async ({ username, repo, owner, type, filter, }, confi
     try {
         res = await retryer(fetchTotalItems, { login: username, repo, owner, type, filter }, config);
     }
-    catch (err) {
-        logger.log(err);
-        throw err;
+    catch (error) {
+        logger.log(error);
+        throw error;
     }
     const totalCount = res.data.total_count;
-    if (totalCount === undefined || isNaN(totalCount)) {
-        logger.error('GitHub error: ' + JSON.stringify(res.data));
+    if (typeof totalCount !== 'number' || Number.isNaN(totalCount)) {
+        logger.error(`GitHub error: ${JSON.stringify(res.data)}`);
         throw new CardError('Could not fetch data from GitHub REST API.', {
             code: 'upstream',
         });
@@ -152,16 +130,6 @@ const totalItemsFetcher = async ({ username, repo, owner, type, filter, }, confi
 /**
  * Fetch the per-repository counts the REST search API answers, one request each.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.repo Repositories the search is scoped to.
- * @param props.owner Owners the search is scoped to.
- * @param props.include_prs_authored Include count of PRs authored.
- * @param props.include_prs_commented Include count of PRs commented.
- * @param props.include_prs_reviewed Include count of PRs reviewed.
- * @param props.include_issues_authored Include count of issues authored.
- * @param props.include_issues_commented Include count of issues commented.
- * @param config Deployment config supplying the PAT pool.
  * @returns Only the counts that were asked for.
  */
 const fetchRepoUserStats = async ({ username, repo = [], owner = [], include_prs_authored = false, include_prs_commented = false, include_prs_reviewed = false, include_issues_authored = false, include_issues_commented = false, }, config) => {
@@ -215,10 +183,6 @@ const fetchRepoUserStats = async ({ username, repo = [], owner = [], include_prs
 };
 /**
  * Turn a GraphQL `errors` payload into the error to throw.
- *
- * @param errors Errors from the response envelope.
- * @param statusText HTTP status text, used as the error type when GitHub gave a message.
- * @param fallback Message when GitHub gave none.
  */
 const graphqlError = (errors, statusText, fallback) => {
     logger.error(errors);
@@ -246,7 +210,7 @@ const fetchTotalContributions = async (username, years, config) => {
     if (contribRes.data.errors) {
         throw graphqlError(contribRes.data.errors, contribRes.statusText, 'Something went wrong while trying to retrieve the contributions data using the GraphQL API.');
     }
-    const user = contribRes.data.data.user;
+    const { user } = contribRes.data.data;
     if (!user) {
         return 0;
     }
@@ -278,25 +242,22 @@ const REPOS_CONTRIBUTED_TO_ERROR = 'Something went wrong while trying to retriev
  *
  * Whether private contributions are included depends on the used PAT.
  *
- * @param canonicalUsername Username as GitHub reports it; `nameWithOwner` uses its
- *        casing, which the raw query-string username need not match.
- * @param years Contribution years to walk.
- * @param includeOwnRepos Whether to count the user's own repositories.
- * @param config Deployment config supplying the PAT pool.
  * @returns Count of repositories.
  */
-const fetchAllTimeReposContributedTo = async (canonicalUsername, years, includeOwnRepos, config) => {
+const fetchAllTimeReposContributedTo = async (
+/** `nameWithOwner` uses GitHub's casing, which the query-string username need not match */
+canonicalUsername, years, includeOwnRepos, config) => {
     const repos = new Set();
-    let pending = years.map(getGitHubYearRange);
+    let pending = years.map((year) => getGitHubYearRange(year));
     while (pending.length > 0) {
         const nextPending = [];
         for (const chunk of chunkArray(pending, MAX_RANGES_PER_REQUEST)) {
-            const fetcher = createGraphQLFetcher(buildReposContributedToDocument(chunk, includeOwnRepos), 'bearer');
-            const res = await retryer(fetcher, { login: canonicalUsername, maxRepositories: MAX_REPOSITORIES_LIMIT }, config);
+            const chunkFetcher = createGraphQLFetcher(buildReposContributedToDocument(chunk, includeOwnRepos), 'bearer');
+            const res = await retryer(chunkFetcher, { login: canonicalUsername, maxRepositories: MAX_REPOSITORIES_LIMIT }, config);
             if (res.data.errors) {
                 throw graphqlError(res.data.errors, res.statusText, REPOS_CONTRIBUTED_TO_ERROR);
             }
-            const user = res.data.data.user;
+            const { user } = res.data.data;
             if (!user) {
                 throw new CardError(REPOS_CONTRIBUTED_TO_ERROR, { code: 'upstream' });
             }
@@ -347,26 +308,6 @@ const fetchAllTimeReposContributedTo = async (canonicalUsername, years, includeO
 /**
  * Fetch stats for a given username.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.include_all_commits Include all commits.
- * @param props.exclude_repo Repositories to exclude.
- * @param props.include_merged_pull_requests Include merged pull requests.
- * @param props.include_discussions Include discussions.
- * @param props.include_discussions_answers Include discussions answers.
- * @param props.commits_year Year to count total commits.
- * @param props.repo Repositories to scope the REST search to.
- * @param props.owner Owners to scope the REST search to.
- * @param props.include_prs_authored Include count of PRs authored.
- * @param props.include_prs_commented Include count of PRs commented.
- * @param props.include_prs_reviewed Include count of PRs reviewed.
- * @param props.include_issues_authored Include count of issues authored.
- * @param props.include_issues_commented Include count of issues commented.
- * @param props.ownerAffiliations Owner affiliations. Default: OWNER.
- * @param props.include_contributions Include all-time contributions.
- * @param props.include_all_time_contribs Include all-time count of repos contributed to.
- * @param props.contribs_include_own_repos Include user-owned repos in contributed-to counts.
- * @param config Deployment config supplying the PAT pool.
  * @returns 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 = [], include_contributions = false, include_all_time_contribs = false, contribs_include_own_repos = false, }, config) => {
@@ -409,7 +350,7 @@ const fetchStats = async ({ username, include_all_commits = false, exclude_repo
     // Catch GraphQL errors.
     if (res.data.errors) {
         logger.error(res.data.errors);
-        const firstError = res.data.errors[0];
+        const [firstError] = res.data.errors;
         if (firstError?.type === 'NOT_FOUND') {
             throw new CardError(firstError.message || 'Could not fetch user.', {
                 code: 'not_found',
@@ -424,7 +365,7 @@ const fetchStats = async ({ username, include_all_commits = false, exclude_repo
         }
         throw new CardError('Something went wrong while trying to retrieve the stats data using the GraphQL API.', { code: 'upstream' });
     }
-    const user = res.data.data.user;
+    const { user } = res.data.data;
     if (!user) {
         throw new CardError('Could not fetch user.', {
             code: 'not_found',

package/build/fetchers/top-languages.d.ts

@@ -1,15 +1,8 @@
-import type { CardConfig } from '../common/config.js';
-import type { TopLangData } from './types.js';
+import type { CardConfig } from '../common/config.ts';
+import type { TopLangData } from './types.ts';
 /**
  * Fetch top languages for a given username.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.exclude_repo List of repositories to exclude. Default: [].
- * @param props.size_weight Weightage to be given to size.
- * @param props.count_weight Weightage to be given to count.
- * @param props.ownerAffiliations The owner affiliations to filter by. Default: OWNER.
- * @param config Deployment config supplying the PAT pool.
  * @returns Top languages data.
  */
 declare const fetchTopLanguages: ({ username, exclude_repo, size_weight, count_weight, ownerAffiliations, }: {

package/build/fetchers/top-languages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"top-languages.d.ts","sourceRoot":"","sources":["../../src/fetchers/top-languages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAatD,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,YAAY,CAAC;AAIpD;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,iBAAiB,GACrB,2EAMG;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACnC,EACD,QAAQ,UAAU,KACjB,OAAO,CAAC,WAAW,CAuFrB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"top-languages.d.ts","sourceRoot":"","sources":["../../src/fetchers/top-languages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAatD,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,YAAY,CAAC;AAIpD;;;;GAIG;AACH,QAAA,MAAM,iBAAiB,8EAOlB;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,iBAAiB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACnC,UACO,UAAU,KACjB,OAAO,CAAC,WAAW,CAgFrB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/build/fetchers/top-languages.js

@@ -1,21 +1,14 @@
 import { CardError, USER_NOT_FOUND } from '../common/error.js';
-import { wrapTextMultiline } from '../common/fmt.js';
 import { createGraphQLFetcher } from '../common/http.js';
 import { logger } from '../common/log.js';
 import { parseOwnerAffiliations } from '../common/ops.js';
+import { wrapTextMultiline } from '../common/render.js';
 import { retryer } from '../common/retryer.js';
 import { TopLanguagesDocument } from '../graphql/generated/top-languages.js';
 const fetcher = createGraphQLFetcher(TopLanguagesDocument, 'token');
 /**
  * Fetch top languages for a given username.
  *
- * @param props Fetcher props.
- * @param props.username GitHub username.
- * @param props.exclude_repo List of repositories to exclude. Default: [].
- * @param props.size_weight Weightage to be given to size.
- * @param props.count_weight Weightage to be given to count.
- * @param props.ownerAffiliations The owner affiliations to filter by. Default: OWNER.
- * @param config Deployment config supplying the PAT pool.
  * @returns Top languages data.
  */
 const fetchTopLanguages = async ({ username, exclude_repo = [], size_weight = 1, count_weight = 0, ownerAffiliations = [], }, config) => {
@@ -29,7 +22,7 @@ const fetchTopLanguages = async ({ username, exclude_repo = [], size_weight = 1,
     }, config);
     if (res.data.errors) {
         logger.error(res.data.errors);
-        const firstError = res.data.errors[0];
+        const [firstError] = res.data.errors;
         if (firstError?.type === 'NOT_FOUND') {
             throw new CardError(firstError.message || 'Could not fetch user.', {
                 code: 'not_found',
@@ -47,43 +40,34 @@ const fetchTopLanguages = async ({ username, exclude_repo = [], size_weight = 1,
     const repoToHide = {};
     const allExcludedRepos = [...exclude_repo, ...config.excludeRepositories];
     // populate repoToHide map for quick lookup while filtering out
-    allExcludedRepos.forEach((repoName) => {
+    for (const repoName of allExcludedRepos) {
         repoToHide[repoName] = true;
-    });
+    }
     // filter out repositories to be hidden
     const repoNodes = (res.data.data.user?.repositories.nodes ?? []).filter((node) => !!node && !repoToHide[node.name]);
-    // flatten edges across repos. Order matters: `concat(acc)` prepends, and the
-    // shared repoCount below depends on visitation order.
-    const languageEdges = repoNodes.reduce((acc, repo) => {
+    let languageEdges = [];
+    for (const repo of repoNodes) {
         const edges = (repo.languages?.edges ?? []).filter((edge) => !!edge);
-        return edges.length > 0 ? edges.concat(acc) : acc;
-    }, []);
-    // accumulate size and repo count per language
+        if (edges.length > 0) {
+            languageEdges = [...edges, ...languageEdges];
+        }
+    }
+    // accumulate size and repo count per language, each read back off the language's own entry
     const languageMap = {};
-    let repoCount = 0;
     for (const edge of languageEdges) {
         const existing = languageMap[edge.node.name];
-        // same language seen again: add to its size and bump count; else reset to 1
-        let langSize = edge.size;
-        if (existing && edge.node.name === existing.name) {
-            langSize = edge.size + existing.size;
-            repoCount += 1;
-        }
-        else {
-            repoCount = 1;
-        }
         languageMap[edge.node.name] = {
             name: edge.node.name,
             color: edge.node.color,
-            size: langSize,
-            count: repoCount,
+            size: edge.size + (existing?.size ?? 0),
+            count: (existing?.count ?? 0) + 1,
         };
     }
     // comparison index calculation
     for (const lang of Object.values(languageMap)) {
-        lang.size = Math.pow(lang.size, size_weight) * Math.pow(lang.count, count_weight);
+        lang.size = lang.size ** size_weight * lang.count ** count_weight;
     }
     // return languages sorted by (weighted) size, descending
-    return Object.fromEntries(Object.entries(languageMap).sort(([, a], [, b]) => b.size - a.size));
+    return Object.fromEntries(Object.entries(languageMap).toSorted(([, a], [, b]) => b.size - a.size));
 };
 export { fetchTopLanguages };

package/build/fetchers/types.d.ts

@@ -1,4 +1,4 @@
-import type { RepoInfoFragment } from '../graphql/generated/repo.js';
+import type { RepoInfoFragment } from '../graphql/generated/repo.ts';
 export interface GistData {
     name: string;
     nameWithOwner: string;

package/build/fetchers/wakatime.d.ts

@@ -1,14 +1,10 @@
-import type { CardConfig } from '../common/config.js';
-import type { WakaTimeData } from './types.js';
+import type { CardConfig } from '../common/config.ts';
+import type { WakaTimeData } from './types.ts';
 /**
  * WakaTime data fetcher.
  *
  * WakaTime needs no GitHub token; the config is here for the transport it carries.
  *
- * @param props Fetcher props.
- * @param props.username WakaTime username.
- * @param props.api_domain Optional WakaTime API domain (defaults to `wakatime.com`).
- * @param config Deployment config supplying the transport.
  * @returns WakaTime data response.
  */
 declare const fetchWakatimeStats: ({ username, api_domain, }: {

package/build/fetchers/wakatime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wakatime.d.ts","sourceRoot":"","sources":["../../src/fetchers/wakatime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,kBAAkB,GACtB,2BAGG;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,EACD,QAAQ,UAAU,KACjB,OAAO,CAAC,YAAY,CA2BtB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"wakatime.d.ts","sourceRoot":"","sources":["../../src/fetchers/wakatime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;GAMG;AACH,QAAA,MAAM,kBAAkB,8BAInB;IACD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,UACO,UAAU,KACjB,OAAO,CAAC,YAAY,CA2BtB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}