@lizardbyte/contribkit 2025.821.193159 → 2025.1130.1103

package/README.md

@@ -1,7 +1,7 @@
 # ContribKit
 
 [![GitHub stars](https://img.shields.io/github/stars/lizardbyte/contribkit.svg?logo=github&style=for-the-badge)](https://github.com/LizardByte/contribkit)
-[![GitHub Workflow Status (CI)](https://img.shields.io/github/actions/workflow/status/lizardbyte/contribkit/ci.yml.svg?branch=master&label=CI%20build&logo=github&style=for-the-badge)](https://github.com/LizardByte/contribkit/actions/workflows/CI.yml?query=branch%3Amaster)
+[![GitHub Workflow Status (CI)](https://img.shields.io/github/actions/workflow/status/lizardbyte/contribkit/_ci-node.yml.svg?branch=master&label=CI%20build&logo=github&style=for-the-badge)](https://github.com/LizardByte/contribkit/actions/workflows/CI.yml?query=branch%3Amaster)
 [![Codecov](https://img.shields.io/codecov/c/gh/LizardByte/contribkit?token=WBivqQDwFw&style=for-the-badge&logo=codecov&label=codecov)](https://codecov.io/gh/LizardByte/contribkit)
 [![NPM Monthly Downloads](https://img.shields.io/npm/dm/%40lizardbyte%2Fcontribkit?style=for-the-badge&logo=npm&label=npm%20downloads/m)](https://www.npmjs.com/package/@lizardbyte/contribkit)
 [![NPM Version](https://img.shields.io/npm/v/%40lizardbyte%2Fcontribkit?style=for-the-badge&logo=npm&label=npm%20version)](https://www.npmjs.com/package/@lizardbyte/contribkit)
@@ -13,7 +13,8 @@ Supports:
 
 - Contributors:
   - [**CrowdIn**](https://crowdin.com)
-  - [**GitHub**](https://github.com)
+  - [**GitHub Contributors**](https://github.com) (contributors to a specific repository)
+  - [**GitHub Contributions**](https://github.com) (merged PRs aggregated by repository owner across all repos for a single user)
   - [**Gitlab**](https://gitlab.com)
 - Sponsors:
   - [**GitHub Sponsors**](https://github.com/sponsors)
@@ -37,11 +38,25 @@ CONTRIBKIT_CROWDIN_MIN_TRANSLATIONS=1
 
 ; GitHubContributors provider.
 ; Token requires the `public_repo` and `read:user` scopes.
+; This provider tracks all contributors to a specific repository.
 CONTRIBKIT_GITHUB_CONTRIBUTORS_TOKEN=
 CONTRIBKIT_GITHUB_CONTRIBUTORS_LOGIN=
 CONTRIBKIT_GITHUB_CONTRIBUTORS_MIN=1
 CONTRIBKIT_GITHUB_CONTRIBUTORS_REPO=
 
+; GitHubContributions provider.
+; Token requires the `read:user` scope.
+; This provider aggregates merged pull requests across all repositories by repository owner (user or organization).
+; Each owner appears once with the total merged PRs you authored to their repos.
+; Avatar and link point to the owner (or to the repo if only one repo per owner).
+; Only merged PRs are counted - open or closed-without-merge PRs are excluded.
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_TOKEN=
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGIN=
+; Optional: Cap the maximum contribution count per org/user (useful for circles visualization)
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_MAX=
+; Optional: Apply logarithmic scaling to reduce dominance of high contributors (true/false)
+CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGARITHMIC=
+
 ; GitlabContributors provider.
 ; Token requires the `read_api` and `read_user` scopes.
 CONTRIBKIT_GITLAB_CONTRIBUTORS_TOKEN=
@@ -96,9 +111,26 @@ CONTRIBKIT_LIBERAPAY_LOGIN=
 > This will require different env variables to be set for each provider, and to be created from separate
 > commands.
 
+#### GitHub Provider Options
+
+There are two GitHub contributor providers available:
+
+- **GitHubContributors**: Tracks all contributors to a specific repository (e.g., `owner/repo`). Each contributor appears once with their actual contribution count to that repository.
+- **GitHubContributions**: Aggregates a single user's **merged pull requests** across all repositories, grouped by repository owner (user or organization). Each owner appears once with the total merged PRs. The avatar and link point to the owner (or to the specific repo if only one repo per owner).
+
+Use **GitHubContributors** when you want to showcase everyone who has contributed to your project with their contribution counts.
+Use **GitHubContributions** when you want to understand where a single user's completed contributions (merged PRs) have gone, without overwhelming duplicates per repo under the same owner.
+
+**GitHubContributions accuracy**:
+- Counts only **merged** pull requests - open or closed-without-merge PRs are excluded
+- Discovers repos via **2 sources**:
+  1. **contributionsCollection** - Yearly commit timeline (full history) for discovering repositories you have committed to
+  2. **Search API** - Repositories where you have merged PRs (`is:pr is:merged author:login`)
+- When an owner has only one repo, the link points to that repo; otherwise to the owner profile
+
 Run:
 
-```base
+```bash
 npx contribkit
 ```
 
@@ -133,6 +165,11 @@ export default defineConfig({
     // ...
   },
 
+  // For contributor providers:
+  githubContributions: {
+    login: 'username',
+  },
+
   // Rendering configs
   width: 800,
   renderer: 'tiers', // or 'circles'

package/dist/chunks/index.mjs

@@ -43,6 +43,12 @@ class Queue {
 
 		this.#head = this.#head.next;
 		this.#size--;
+
+		// Clean up tail reference when queue becomes empty
+		if (!this.#head) {
+			this.#tail = undefined;
+		}
+
 		return current.value;
 	}
 

package/dist/chunks/index3.mjs

@@ -1514,7 +1514,7 @@ var hasRequiredLodash_groupby;
 function requireLodash_groupby () {
 	if (hasRequiredLodash_groupby) return lodash_groupby.exports;
 	hasRequiredLodash_groupby = 1;
-	(function (module, exports) {
+	(function (module, exports$1) {
 		/** Used as the size to enable large array optimizations. */
 		var LARGE_ARRAY_SIZE = 200;
 
@@ -1608,7 +1608,7 @@ function requireLodash_groupby () {
 		var root = freeGlobal || freeSelf || Function('return this')();
 
 		/** Detect free variable `exports`. */
-		var freeExports = exports && !exports.nodeType && exports;
+		var freeExports = exports$1 && !exports$1.nodeType && exports$1;
 
 		/** Detect free variable `module`. */
 		var freeModule = freeExports && 'object' == 'object' && module && !module.nodeType && module;
@@ -4007,13 +4007,13 @@ var hasRequiredTransforms;
 function requireTransforms () {
 	if (hasRequiredTransforms) return transforms;
 	hasRequiredTransforms = 1;
-	(function (exports) {
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.HeaderTransformer = exports.RowTransformerValidator = void 0;
+	(function (exports$1) {
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.HeaderTransformer = exports$1.RowTransformerValidator = void 0;
 		var RowTransformerValidator_1 = requireRowTransformerValidator();
-		Object.defineProperty(exports, "RowTransformerValidator", { enumerable: true, get: function () { return RowTransformerValidator_1.RowTransformerValidator; } });
+		Object.defineProperty(exports$1, "RowTransformerValidator", { enumerable: true, get: function () { return RowTransformerValidator_1.RowTransformerValidator; } });
 		var HeaderTransformer_1 = requireHeaderTransformer();
-		Object.defineProperty(exports, "HeaderTransformer", { enumerable: true, get: function () { return HeaderTransformer_1.HeaderTransformer; } });
+		Object.defineProperty(exports$1, "HeaderTransformer", { enumerable: true, get: function () { return HeaderTransformer_1.HeaderTransformer; } });
 		
 	} (transforms));
 	return transforms;
@@ -4392,17 +4392,17 @@ var hasRequiredColumn;
 function requireColumn () {
 	if (hasRequiredColumn) return column;
 	hasRequiredColumn = 1;
-	(function (exports) {
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.ColumnFormatter = exports.QuotedColumnParser = exports.NonQuotedColumnParser = exports.ColumnParser = void 0;
+	(function (exports$1) {
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.ColumnFormatter = exports$1.QuotedColumnParser = exports$1.NonQuotedColumnParser = exports$1.ColumnParser = void 0;
 		var ColumnParser_1 = requireColumnParser();
-		Object.defineProperty(exports, "ColumnParser", { enumerable: true, get: function () { return ColumnParser_1.ColumnParser; } });
+		Object.defineProperty(exports$1, "ColumnParser", { enumerable: true, get: function () { return ColumnParser_1.ColumnParser; } });
 		var NonQuotedColumnParser_1 = requireNonQuotedColumnParser();
-		Object.defineProperty(exports, "NonQuotedColumnParser", { enumerable: true, get: function () { return NonQuotedColumnParser_1.NonQuotedColumnParser; } });
+		Object.defineProperty(exports$1, "NonQuotedColumnParser", { enumerable: true, get: function () { return NonQuotedColumnParser_1.NonQuotedColumnParser; } });
 		var QuotedColumnParser_1 = requireQuotedColumnParser();
-		Object.defineProperty(exports, "QuotedColumnParser", { enumerable: true, get: function () { return QuotedColumnParser_1.QuotedColumnParser; } });
+		Object.defineProperty(exports$1, "QuotedColumnParser", { enumerable: true, get: function () { return QuotedColumnParser_1.QuotedColumnParser; } });
 		var ColumnFormatter_1 = requireColumnFormatter();
-		Object.defineProperty(exports, "ColumnFormatter", { enumerable: true, get: function () { return ColumnFormatter_1.ColumnFormatter; } });
+		Object.defineProperty(exports$1, "ColumnFormatter", { enumerable: true, get: function () { return ColumnFormatter_1.ColumnFormatter; } });
 		
 	} (column));
 	return column;
@@ -4583,21 +4583,21 @@ var hasRequiredParser;
 function requireParser () {
 	if (hasRequiredParser) return parser;
 	hasRequiredParser = 1;
-	(function (exports) {
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.QuotedColumnParser = exports.NonQuotedColumnParser = exports.ColumnParser = exports.Token = exports.Scanner = exports.RowParser = exports.Parser = void 0;
+	(function (exports$1) {
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.QuotedColumnParser = exports$1.NonQuotedColumnParser = exports$1.ColumnParser = exports$1.Token = exports$1.Scanner = exports$1.RowParser = exports$1.Parser = void 0;
 		var Parser_1 = requireParser$1();
-		Object.defineProperty(exports, "Parser", { enumerable: true, get: function () { return Parser_1.Parser; } });
+		Object.defineProperty(exports$1, "Parser", { enumerable: true, get: function () { return Parser_1.Parser; } });
 		var RowParser_1 = requireRowParser();
-		Object.defineProperty(exports, "RowParser", { enumerable: true, get: function () { return RowParser_1.RowParser; } });
+		Object.defineProperty(exports$1, "RowParser", { enumerable: true, get: function () { return RowParser_1.RowParser; } });
 		var Scanner_1 = requireScanner();
-		Object.defineProperty(exports, "Scanner", { enumerable: true, get: function () { return Scanner_1.Scanner; } });
+		Object.defineProperty(exports$1, "Scanner", { enumerable: true, get: function () { return Scanner_1.Scanner; } });
 		var Token_1 = requireToken();
-		Object.defineProperty(exports, "Token", { enumerable: true, get: function () { return Token_1.Token; } });
+		Object.defineProperty(exports$1, "Token", { enumerable: true, get: function () { return Token_1.Token; } });
 		var column_1 = requireColumn();
-		Object.defineProperty(exports, "ColumnParser", { enumerable: true, get: function () { return column_1.ColumnParser; } });
-		Object.defineProperty(exports, "NonQuotedColumnParser", { enumerable: true, get: function () { return column_1.NonQuotedColumnParser; } });
-		Object.defineProperty(exports, "QuotedColumnParser", { enumerable: true, get: function () { return column_1.QuotedColumnParser; } });
+		Object.defineProperty(exports$1, "ColumnParser", { enumerable: true, get: function () { return column_1.ColumnParser; } });
+		Object.defineProperty(exports$1, "NonQuotedColumnParser", { enumerable: true, get: function () { return column_1.NonQuotedColumnParser; } });
+		Object.defineProperty(exports$1, "QuotedColumnParser", { enumerable: true, get: function () { return column_1.QuotedColumnParser; } });
 		
 	} (parser));
 	return parser;
@@ -4834,7 +4834,7 @@ var hasRequiredSrc;
 function requireSrc () {
 	if (hasRequiredSrc) return src;
 	hasRequiredSrc = 1;
-	(function (exports) {
+	(function (exports$1) {
 		var __createBinding = (src && src.__createBinding) || (Object.create ? (function(o, m, k, k2) {
 		    if (k2 === undefined) k2 = k;
 		    var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -4858,39 +4858,39 @@ function requireSrc () {
 		    __setModuleDefault(result, mod);
 		    return result;
 		};
-		var __exportStar = (src && src.__exportStar) || function(m, exports) {
-		    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+		var __exportStar = (src && src.__exportStar) || function(m, exports$1) {
+		    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports$1, p)) __createBinding(exports$1, m, p);
 		};
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.parseString = exports.parseFile = exports.parseStream = exports.parse = exports.ParserOptions = exports.CsvParserStream = void 0;
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.parseString = exports$1.parseFile = exports$1.parseStream = exports$1.parse = exports$1.ParserOptions = exports$1.CsvParserStream = void 0;
 		const fs = __importStar(require$$0$1);
 		const stream_1 = require$$1;
 		const ParserOptions_1 = requireParserOptions();
 		const CsvParserStream_1 = requireCsvParserStream();
-		__exportStar(requireTypes(), exports);
+		__exportStar(requireTypes(), exports$1);
 		var CsvParserStream_2 = requireCsvParserStream();
-		Object.defineProperty(exports, "CsvParserStream", { enumerable: true, get: function () { return CsvParserStream_2.CsvParserStream; } });
+		Object.defineProperty(exports$1, "CsvParserStream", { enumerable: true, get: function () { return CsvParserStream_2.CsvParserStream; } });
 		var ParserOptions_2 = requireParserOptions();
-		Object.defineProperty(exports, "ParserOptions", { enumerable: true, get: function () { return ParserOptions_2.ParserOptions; } });
+		Object.defineProperty(exports$1, "ParserOptions", { enumerable: true, get: function () { return ParserOptions_2.ParserOptions; } });
 		const parse = (args) => {
 		    return new CsvParserStream_1.CsvParserStream(new ParserOptions_1.ParserOptions(args));
 		};
-		exports.parse = parse;
+		exports$1.parse = parse;
 		const parseStream = (stream, options) => {
 		    return stream.pipe(new CsvParserStream_1.CsvParserStream(new ParserOptions_1.ParserOptions(options)));
 		};
-		exports.parseStream = parseStream;
+		exports$1.parseStream = parseStream;
 		const parseFile = (location, options = {}) => {
 		    return fs.createReadStream(location).pipe(new CsvParserStream_1.CsvParserStream(new ParserOptions_1.ParserOptions(options)));
 		};
-		exports.parseFile = parseFile;
+		exports$1.parseFile = parseFile;
 		const parseString = (string, options) => {
 		    const rs = new stream_1.Readable();
 		    rs.push(string);
 		    rs.push(null);
 		    return rs.pipe(new CsvParserStream_1.CsvParserStream(new ParserOptions_1.ParserOptions(options)));
 		};
-		exports.parseString = parseString;
+		exports$1.parseString = parseString;
 		
 	} (src));
 	return src;

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 import cac from 'cac';
-import { S as SvgComposer, i as generateBadge, p as partitionTiers, t as tierPresets, v as version, l as loadConfig, k as resolveProviders, j as guessProviders, r as resolveAvatars, q as outputFormats, s as svgToPng, g as svgToWebp } from './shared/contribkit.C8dVxxYO.mjs';
+import { S as SvgComposer, i as generateBadge, p as partitionTiers, t as tierPresets, v as version, l as loadConfig, k as resolveProviders, j as guessProviders, r as resolveAvatars, q as outputFormats, s as svgToPng, g as svgToWebp } from './shared/contribkit.DLdCPKip.mjs';
 import fs from 'node:fs';
 import fsp from 'node:fs/promises';
 import { resolve, dirname, relative, join } from 'node:path';

package/dist/index.d.mts

@@ -83,7 +83,7 @@ interface Sponsorship {
 }
 declare const outputFormats: readonly ["svg", "png", "webp", "json"];
 type OutputFormat = typeof outputFormats[number];
-type ProviderName = 'github' | 'patreon' | 'opencollective' | 'afdian' | 'polar' | 'liberapay' | 'githubContributors' | 'gitlabContributors' | 'crowdinContributors';
+type ProviderName = 'github' | 'patreon' | 'opencollective' | 'afdian' | 'polar' | 'liberapay' | 'githubContributors' | 'gitlabContributors' | 'crowdinContributors' | 'githubContributions';
 type GitHubAccountType = 'user' | 'organization';
 interface ProvidersConfig {
     github?: {
@@ -278,6 +278,36 @@ interface ProvidersConfig {
          */
         minTranslations?: number;
     };
+    githubContributions?: {
+        /**
+         * GitHub user login to fetch contributions for.
+         *
+         * Will read from `CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGIN` environment variable if not set.
+         */
+        login?: string;
+        /**
+         * GitHub Token that has access to read user contributions.
+         *
+         * Will read from `CONTRIBKIT_GITHUB_CONTRIBUTIONS_TOKEN` environment variable if not set.
+         *
+         * @deprecated It's not recommended set this value directly, pass from env or use `.env` file.
+         */
+        token?: string;
+        /**
+         * Cap the maximum contribution count per organization/user.
+         * Useful to prevent one dominant contributor from overshadowing others in visualizations.
+         *
+         * @example 100 // Cap all contributions at 100 PRs max
+         */
+        maxContributions?: number;
+        /**
+         * Apply logarithmic scaling to contribution counts.
+         * Useful to reduce the visual dominance of high contributors while maintaining relative differences.
+         *
+         * @default false
+         */
+        logarithmicScaling?: boolean;
+    };
 }
 interface ContribkitRenderOptions {
     /**
@@ -557,6 +587,7 @@ declare const ProvidersMap: {
     polar: Provider;
     liberapay: Provider;
     githubContributors: Provider;
+    githubContributions: Provider;
     gitlabContributors: Provider;
     crowdinContributors: Provider;
 };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { F as FALLBACK_AVATAR, G as GitHubProvider, P as ProvidersMap, S as SvgComposer, c as defaultConfig, b as defaultInlineCSS, a as defaultTiers, d as defineConfig, n as fetchGitHubSponsors, m as fetchSponsors, h as genSvgImage, i as generateBadge, j as guessProviders, l as loadConfig, o as makeQuery, q as outputFormats, p as partitionTiers, e as presets, f as resizeImage, r as resolveAvatars, k as resolveProviders, s as svgToPng, g as svgToWebp, t as tierPresets } from './shared/contribkit.C8dVxxYO.mjs';
+export { F as FALLBACK_AVATAR, G as GitHubProvider, P as ProvidersMap, S as SvgComposer, c as defaultConfig, b as defaultInlineCSS, a as defaultTiers, d as defineConfig, n as fetchGitHubSponsors, m as fetchSponsors, h as genSvgImage, i as generateBadge, j as guessProviders, l as loadConfig, o as makeQuery, q as outputFormats, p as partitionTiers, e as presets, f as resizeImage, r as resolveAvatars, k as resolveProviders, s as svgToPng, g as svgToWebp, t as tierPresets } from './shared/contribkit.DLdCPKip.mjs';
 import 'unconfig';
 import 'node:process';
 import 'dotenv';

package/dist/shared/{contribkit.C8dVxxYO.mjs → contribkit.DLdCPKip.mjs}

@@ -196,12 +196,18 @@ function loadEnv() {
       token: process.env.CONTRIBKIT_CROWDIN_TOKEN,
       projectId: Number(process.env.CONTRIBKIT_CROWDIN_PROJECT_ID),
       minTranslations: Number(process.env.CONTRIBKIT_CROWDIN_MIN_TRANSLATIONS) || 1
+    },
+    githubContributions: {
+      login: process.env.CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGIN,
+      token: process.env.CONTRIBKIT_GITHUB_CONTRIBUTIONS_TOKEN,
+      maxContributions: Number(process.env.CONTRIBKIT_GITHUB_CONTRIBUTIONS_MAX) || void 0,
+      logarithmicScaling: process.env.CONTRIBKIT_GITHUB_CONTRIBUTIONS_LOGARITHMIC === "true"
     }
   };
   return JSON.parse(JSON.stringify(config));
 }
 
-const version = "2025.821.193159";
+const version = "2025.1130.1103";
 
 async function fetchImage(url) {
   const arrayBuffer = await $fetch(url, {
@@ -345,7 +351,8 @@ function partitionTiers(sponsors, tiers, includePastSponsors) {
 }
 
 function genSvgImage(x, y, size, radius, base64Image, imageFormat) {
-  const cropId = `c${crypto.createHash("md5").update(base64Image).digest("hex").slice(0, 6)}`;
+  const hashInput = `${x}:${y}:${size}:${radius}:${base64Image}`;
+  const cropId = `c${crypto.createHash("sha256").update(hashInput).digest("hex").slice(0, 6)}`;
   return `
   <clipPath id="${cropId}">
     <rect x="${x}" y="${y}" width="${size}" height="${size}" rx="${size * radius}" ry="${size * radius}" />
@@ -675,6 +682,8 @@ function normalizeUrl$1(urlString, options) {
 		removeDirectoryIndex: false,
 		removeExplicitPort: false,
 		sortQueryParameters: true,
+		removePath: false,
+		transformPath: false,
 		...options,
 	};
 
@@ -786,6 +795,18 @@ function normalizeUrl$1(urlString, options) {
 		}
 	}
 
+	// Remove path
+	if (options.removePath) {
+		urlObject.pathname = '/';
+	}
+
+	// Transform path components
+	if (options.transformPath && typeof options.transformPath === 'function') {
+		const pathComponents = urlObject.pathname.split('/').filter(Boolean);
+		const newComponents = options.transformPath(pathComponents);
+		urlObject.pathname = newComponents?.length > 0 ? `/${newComponents.join('/')}` : '/';
+	}
+
 	if (urlObject.hostname) {
 		// Remove trailing dot
 		urlObject.hostname = urlObject.hostname.replace(/\.$/, '');
@@ -826,12 +847,21 @@ function normalizeUrl$1(urlString, options) {
 
 	// Sort query parameters
 	if (options.sortQueryParameters) {
+		const originalSearch = urlObject.search;
 		urlObject.searchParams.sort();
 
 		// Calling `.sort()` encodes the search parameters, so we need to decode them again.
 		try {
 			urlObject.search = decodeURIComponent(urlObject.search);
 		} catch {}
+
+		// Fix parameters that originally had no equals sign but got one added by URLSearchParams
+		const partsWithoutEquals = originalSearch.slice(1).split('&').filter(p => p && !p.includes('='));
+		for (const part of partsWithoutEquals) {
+			const decoded = decodeURIComponent(part);
+			// Only replace at word boundaries to avoid partial matches
+			urlObject.search = urlObject.search.replace(`?${decoded}=`, `?${decoded}`).replace(`&${decoded}=`, `&${decoded}`);
+		}
 	}
 
 	if (options.removeTrailingSlash) {
@@ -1082,6 +1112,246 @@ async function fetchGitHubContributors(token, login, repo, minContributions = 1)
   }));
 }
 
+const GitHubContributionsProvider = {
+  name: "githubContributions",
+  fetchSponsors(config) {
+    if (!config.githubContributions?.login)
+      throw new Error("GitHub login is required for githubContributions provider");
+    return fetchGitHubContributions(
+      config.githubContributions?.token || config.token,
+      config.githubContributions.login,
+      config.githubContributions.maxContributions,
+      config.githubContributions.logarithmicScaling
+    );
+  }
+};
+function createGraphQLFetch(token) {
+  return async (body) => {
+    return await $fetch("https://api.github.com/graphql", {
+      method: "POST",
+      headers: {
+        Authorization: `bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body
+    });
+  };
+}
+async function fetchUserCreationDate(graphqlFetch, login) {
+  const userInfoQuery = `
+    query($login: String!) {
+      user(login: $login) {
+        createdAt
+      }
+    }
+  `;
+  const userInfo = await graphqlFetch({
+    query: userInfoQuery,
+    variables: { login }
+  });
+  return new Date(userInfo.data.user.createdAt);
+}
+function generateYearRanges(accountCreated, now) {
+  const years = [];
+  for (let year = accountCreated.getFullYear(); year <= now.getFullYear(); year++) {
+    const from = year === accountCreated.getFullYear() ? accountCreated.toISOString() : `${year}-01-01T00:00:00Z`;
+    const to = year === now.getFullYear() ? now.toISOString() : `${year}-12-31T23:59:59Z`;
+    years.push({ from, to });
+  }
+  return years;
+}
+async function fetchContributionsForYear(graphqlFetch, login, from, to) {
+  const contributionsQuery = `
+    query($login: String!, $from: DateTime!, $to: DateTime!) {
+      user(login: $login) {
+        contributionsCollection(from: $from, to: $to) {
+          commitContributionsByRepository {
+            repository {
+              name
+              nameWithOwner
+              url
+              owner { login url avatarUrl __typename }
+            }
+          }
+        }
+      }
+    }
+  `;
+  const contributionsResp = await graphqlFetch({
+    query: contributionsQuery,
+    variables: { login, from, to }
+  });
+  return contributionsResp.data.user.contributionsCollection.commitContributionsByRepository.map((item) => item.repository).filter((repo) => repo?.nameWithOwner);
+}
+async function discoverReposFromContributions(graphqlFetch, login, repoMap) {
+  console.log(`[contribkit][githubContributions] fetching contribution timeline to discover more repos...`);
+  try {
+    const accountCreated = await fetchUserCreationDate(graphqlFetch, login);
+    const now = /* @__PURE__ */ new Date();
+    const years = generateYearRanges(accountCreated, now);
+    console.log(`[contribkit][githubContributions] querying contributions across ${years.length} years...`);
+    for (const { from, to } of years) {
+      try {
+        const repos = await fetchContributionsForYear(graphqlFetch, login, from, to);
+        for (const repo of repos) {
+          repoMap.set(repo.nameWithOwner, repo);
+        }
+      } catch (e) {
+        console.warn(`[contribkit][githubContributions] failed contributions query for ${from.slice(0, 4)}:`, e.message);
+      }
+    }
+  } catch (e) {
+    console.warn(`[contribkit][githubContributions] contribution timeline discovery failed:`, e.message);
+  }
+}
+async function discoverReposFromMergedPRs(graphqlFetch, login, repoMap) {
+  console.log(`[contribkit][githubContributions] searching for repos with merged PRs...`);
+  try {
+    const searchQueryBase = `is:pr is:merged author:${login}`;
+    let searchAfter = null;
+    let page = 0;
+    const maxPages = 10;
+    do {
+      const response = await graphqlFetch({
+        query: `
+          query($searchQuery: String!, $after: String) {
+            search(query: $searchQuery, type: ISSUE, first: 100, after: $after) {
+              pageInfo { hasNextPage endCursor }
+              edges { node { ... on PullRequest { repository { name nameWithOwner url owner { login url avatarUrl __typename } } } } }
+            }
+          }
+        `,
+        variables: { searchQuery: searchQueryBase, after: searchAfter }
+      });
+      for (const edge of response.data.search.edges) {
+        const r = edge.node.repository;
+        if (r?.nameWithOwner)
+          repoMap.set(r.nameWithOwner, r);
+      }
+      searchAfter = response.data.search.pageInfo.endCursor;
+      page++;
+      if (response.data.search.pageInfo.hasNextPage && page < maxPages)
+        console.log(`[contribkit][githubContributions] merged PR search page ${page}, ${repoMap.size} repos so far`);
+    } while (searchAfter && page < maxPages);
+  } catch (e) {
+    console.warn(`[contribkit][githubContributions] merged PR search failed:`, e.message);
+  }
+}
+async function fetchPRCountForRepo(graphqlFetch, repo, login) {
+  const searchQuery = `repo:${repo.nameWithOwner} is:pr is:merged author:${login}`;
+  try {
+    const response = await graphqlFetch({
+      query: `query($q: String!) { search(query: $q, type: ISSUE) { issueCount } }`,
+      variables: { q: searchQuery }
+    });
+    return response.data.search.issueCount;
+  } catch (e) {
+    console.warn(`[contribkit][githubContributions] failed PR count for ${repo.nameWithOwner}:`, e.message);
+    return 0;
+  }
+}
+async function fetchMergedPRCounts(graphqlFetch, allRepos, login) {
+  console.log(`[contribkit][githubContributions] fetching merged PR counts per repository...`);
+  const repoPRs = /* @__PURE__ */ new Map();
+  const batchSize = 10;
+  for (let i = 0; i < allRepos.length; i += batchSize) {
+    const batch = allRepos.slice(i, i + batchSize);
+    const counts = await Promise.all(batch.map((repo) => fetchPRCountForRepo(graphqlFetch, repo, login)));
+    for (let index = 0; index < batch.length; index++) {
+      const count = counts[index];
+      if (count > 0)
+        repoPRs.set(batch[index].nameWithOwner, count);
+    }
+    if (i + batchSize < allRepos.length)
+      console.log(`[contribkit][githubContributions] processed PR batches for ${Math.min(i + batchSize, allRepos.length)}/${allRepos.length} repos...`);
+  }
+  console.log(`[contribkit][githubContributions] found merged PR counts for ${repoPRs.size} repositories`);
+  return repoPRs;
+}
+function aggregateByOwner(results) {
+  const aggregated = /* @__PURE__ */ new Map();
+  for (const { repo, prs } of results) {
+    const key = `${repo.owner.__typename}:${repo.owner.login}`;
+    const existing = aggregated.get(key);
+    if (existing) {
+      existing.totalPRs += prs;
+      existing.repos.push({ repo, prs });
+    } else {
+      aggregated.set(key, { owner: repo.owner, totalPRs: prs, repos: [{ repo, prs }] });
+    }
+  }
+  return aggregated;
+}
+function logConsolidatedOwners(aggregated) {
+  const consolidated = Array.from(aggregated.values()).filter((a) => a.repos.length > 1);
+  if (consolidated.length) {
+    console.log(`[contribkit][githubContributions] consolidated ${consolidated.length} owners with multiple repos:`);
+    for (const { owner, repos, totalPRs } of consolidated.toSorted((a, b) => b.repos.length - a.repos.length).slice(0, 10))
+      console.log(`  - ${owner.login}: ${repos.length} repos, ${totalPRs} merged PRs`);
+    if (consolidated.length > 10)
+      console.log(`  ... and ${consolidated.length - 10} more`);
+  }
+}
+function applyContributionScaling(totalPRs, maxContributions, logarithmicScaling) {
+  let scaled = totalPRs;
+  if (logarithmicScaling && scaled > 0) {
+    scaled = Math.log10(scaled + 1) * 10;
+  }
+  if (maxContributions !== void 0 && scaled > maxContributions) {
+    scaled = maxContributions;
+  }
+  return scaled;
+}
+function convertToSponsorships(aggregated, maxContributions, logarithmicScaling) {
+  return Array.from(aggregated.values()).sort((a, b) => b.totalPRs - a.totalPRs).map(({ owner, totalPRs, repos }) => {
+    const scaledPRs = applyContributionScaling(totalPRs, maxContributions, logarithmicScaling);
+    const linkUrl = repos.length === 1 ? repos[0].repo.url : owner.url;
+    return {
+      sponsor: { type: owner.__typename, login: owner.login, name: owner.login, avatarUrl: owner.avatarUrl, linkUrl, socialLogins: { github: owner.login } },
+      isOneTime: false,
+      monthlyDollars: scaledPRs,
+      privacyLevel: "PUBLIC",
+      tierName: "Repository",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      provider: "githubContributions",
+      raw: { owner, totalPRs, scaledPRs, repoCount: repos.length }
+    };
+  });
+}
+async function fetchGitHubContributions(token, login, maxContributions, logarithmicScaling) {
+  if (!token)
+    throw new Error("GitHub token is required");
+  if (!login)
+    throw new Error("GitHub login is required");
+  const graphqlFetch = createGraphQLFetch(token);
+  console.log(`[contribkit][githubContributions] discovering repositories (sources: contributionsCollection + merged PR search)...`);
+  const repoMap = /* @__PURE__ */ new Map();
+  await discoverReposFromContributions(graphqlFetch, login, repoMap);
+  console.log(`[contribkit][githubContributions] found ${repoMap.size} repos after contribution timeline`);
+  await discoverReposFromMergedPRs(graphqlFetch, login, repoMap);
+  console.log(`[contribkit][githubContributions] found ${repoMap.size} repos after merged PR search`);
+  const allRepos = Array.from(repoMap.values());
+  console.log(`[contribkit][githubContributions] discovered ${allRepos.length} total unique repositories`);
+  const repoPRs = await fetchMergedPRCounts(graphqlFetch, allRepos, login);
+  const results = [];
+  for (const repo of allRepos) {
+    const prs = repoPRs.get(repo.nameWithOwner) || 0;
+    if (prs > 0)
+      results.push({ repo, prs });
+  }
+  console.log(`[contribkit][githubContributions] computed merged PR counts for ${results.length} repositories (from ${allRepos.length} total repos with PRs)`);
+  const aggregated = aggregateByOwner(results);
+  logConsolidatedOwners(aggregated);
+  const scalingInfo = [];
+  if (maxContributions !== void 0)
+    scalingInfo.push(`max cap: ${maxContributions}`);
+  if (logarithmicScaling)
+    scalingInfo.push("logarithmic scaling enabled");
+  if (scalingInfo.length > 0)
+    console.log(`[contribkit][githubContributions] applying contribution scaling: ${scalingInfo.join(", ")}`);
+  return convertToSponsorships(aggregated, maxContributions, logarithmicScaling);
+}
+
 const GitlabContributorsProvider = {
   name: "gitlabContributors",
   fetchSponsors(config) {
@@ -1642,6 +1912,7 @@ const ProvidersMap = {
   polar: PolarProvider,
   liberapay: LiberapayProvider,
   githubContributors: GitHubContributorsProvider,
+  githubContributions: GitHubContributionsProvider,
   gitlabContributors: GitlabContributorsProvider,
   crowdinContributors: CrowdinContributorsProvider
 };
@@ -1661,6 +1932,8 @@ function guessProviders(config) {
     items.push("liberapay");
   if (config.githubContributors?.login && config.githubContributors?.token)
     items.push("githubContributors");
+  if (config.githubContributions?.login && config.githubContributions?.token)
+    items.push("githubContributions");
   if (config.gitlabContributors?.token && config.gitlabContributors?.repoId)
     items.push("gitlabContributors");
   if (config.crowdinContributors?.token && config.crowdinContributors?.projectId)

package/package.json

@@ -5,7 +5,7 @@
     "type": "git",
     "url": "git+https://github.com/LizardByte/contribkit.git"
   },
-  "version": "2025.821.193159",
+  "version": "2025.1130.1103",
   "description": "Toolkit for generating contributor images",
   "license": "MIT",
   "funding": "https://app.lizardbyte.dev",