@stats-forge/github-stats-forge-core 0.3.0 → 0.4.0

package/build/common/localize.js

@@ -0,0 +1,163 @@
+/**
+ * Every locale a card can be asked for.
+ *
+ * A key is written in `en` first and translated afterwards, so a card's table need not
+ * carry every locale — a wording falls back to `en`. This list is what the api accepts.
+ *
+ * @see https://www.andiamo.co.uk/resources/iso-language-codes/ for language codes.
+ */
+const AVAILABLE_LOCALES = [
+    'en',
+    'ar',
+    'az',
+    'bg',
+    'bn',
+    'ca',
+    'cn',
+    'zh-tw',
+    'cs',
+    'de',
+    'sw',
+    'ur',
+    'es',
+    'fa',
+    'fi',
+    'fr',
+    'hi',
+    'sa',
+    'hu',
+    'it',
+    'ja',
+    'kr',
+    'nl',
+    'pt-pt',
+    'pt-br',
+    'np',
+    'el',
+    'ro',
+    'ru',
+    'uk-ua',
+    'id',
+    'ml',
+    'my',
+    'ta',
+    'sk',
+    'tr',
+    'pl',
+    'uz',
+    'vi',
+    'se',
+    'he',
+    'fil',
+    'th',
+    'sr',
+    'sr-latn',
+    'no',
+    'be',
+];
+const FALLBACK_LOCALE = 'en';
+/**
+ * Checks whether the locale is available or not.
+ *
+ * @returns Boolean specifying whether the locale is available or not.
+ */
+const isLocaleAvailable = (locale) => AVAILABLE_LOCALES.includes(locale.toLowerCase());
+/**
+ * Declares a card's translations, keeping every string's literal type so `localize` knows
+ * which `{placeholder}` values each key needs.
+ *
+ * @returns The table it was given.
+ */
+const defineLocales = (table) => table;
+/** `{name}` — a placeholder in a phrase. */
+const PLACEHOLDER = /\{(?<name>\w+)\}/g;
+/**
+ * Substitutes a phrase's `{name}` placeholders. Only the phrase is scanned, so a value
+ * that itself looks like a placeholder is left alone.
+ *
+ * @returns The wording as the card draws it.
+ */
+const interpolate = (phrase, key, values) => phrase.replace(PLACEHOLDER, (_placeholder, name) => {
+    const value = values?.[name];
+    if (value === undefined) {
+        throw new Error(`'${key}' needs a value for '{${name}}'`);
+    }
+    return String(value);
+});
+const pluralRules = new Map();
+/**
+ * The plural rules of the locale that supplied the phrase. Several of the locale names
+ * here are not language tags `Intl` knows (`cn`, `kr`, `np`), and resolve to the runtime's
+ * own locale — which only matters once such a locale writes plural forms of its own.
+ *
+ * @returns The rules, built once per locale.
+ */
+const rulesFor = (locale) => {
+    const cached = pluralRules.get(locale);
+    if (cached) {
+        return cached;
+    }
+    const rules = new Intl.PluralRules(locale);
+    pluralRules.set(locale, rules);
+    return rules;
+};
+/**
+ * Picks the form a count calls for, by the rules of the locale the phrase came from.
+ *
+ * @returns The chosen form, or `other` for a category that locale has not written.
+ */
+const selectPlural = (forms, locale, key, values) => {
+    const count = values?.['count'];
+    if (typeof count !== 'number') {
+        throw new TypeError(`'${key}' has plural forms and needs a numeric 'count'`);
+    }
+    return forms[rulesFor(locale).select(count)] ?? forms.other;
+};
+/**
+ * Reads a wording in the locale asked for, falling back to English when that locale has
+ * no entry for it.
+ *
+ * @returns The wording, and the locale it actually came from.
+ */
+const readPhrase = (phrases, key, locale) => {
+    const written = phrases[locale];
+    if (written !== undefined) {
+        return { phrase: written, locale };
+    }
+    // The english wording the type requires can still be missing at runtime: a card can pass
+    // a table it built, and `i18n.test.ts` covers exactly that.
+    const english = phrases[FALLBACK_LOCALE];
+    // oxlint-disable-next-line typescript/no-unnecessary-condition
+    if (english === undefined) {
+        throw new Error(`'${key}' translation not found for locale '${locale}'`);
+    }
+    return { phrase: english, locale: FALLBACK_LOCALE };
+};
+/**
+ * Draws a key's wording: the locale's own if it has one and English otherwise, in the
+ * plural form its count calls for, with its `{name}` placeholders substituted.
+ *
+ * @returns The wording as the card draws it.
+ */
+const draw = (phrases, key, locale, values) => {
+    const { phrase, locale: from } = readPhrase(phrases, key, locale);
+    const wording = typeof phrase === 'string' ? phrase : selectPlural(phrase, from, key, values);
+    return interpolate(wording, key, values);
+};
+/**
+ * Binds a card's translations to one locale, so a card names a wording where it draws it
+ * — `t.title({ login })` — rather than naming a key. That is what lets an editor follow a
+ * wording to where it is written, and why a key carries no card name in front of it.
+ *
+ * @returns One function per key the table declares.
+ */
+const localize = (table, locale) => {
+    const asked = locale || FALLBACK_LOCALE;
+    const wordings = {};
+    for (const [key, phrases] of Object.entries(table)) {
+        wordings[key] = (values) => draw(phrases, key, asked, values);
+    }
+    // A mapped type over a table known only as a type parameter needs the assertion.
+    return wordings;
+};
+export { defineLocales, isLocaleAvailable, localize };

package/build/fetchers/index.d.ts

@@ -1,10 +1,11 @@
 export { fetchContributedTo } from './contributed-to.ts';
 export { fetchGist } from './gist.ts';
+export { fetchOrganization } from './organization.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 { ContributedRepo, ContributedToData, GistData, Lang, RepoUserStats, RepositoryData, StatsData, TopLangData, WakaTimeData, WakaTimeLang, } from './types.ts';
+export type { ContributedRepo, ContributedToData, GistData, Lang, OrganizationData, 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';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetchers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,aAAa,EACb,cAAc,EACd,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetchers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/build/fetchers/index.js

@@ -1,5 +1,6 @@
 export { fetchContributedTo } from './contributed-to.js';
 export { fetchGist } from './gist.js';
+export { fetchOrganization } from './organization.js';
 export { fetchRepo } from './repo.js';
 export { fetchRepoUserStats, fetchStats } from './stats.js';
 export { fetchTopLanguages } from './top-languages.js';

package/build/fetchers/organization.d.ts

@@ -0,0 +1,15 @@
+import type { CardConfig } from '../common/config.ts';
+import type { OrganizationData } from './types.ts';
+/**
+ * Fetch an organization and the totals of its public repositories.
+ *
+ * Only public, non-fork repositories are counted, most-starred first,
+ * and at most five pages of 100 — `truncated` says when the walk stopped early.
+ *
+ * @returns The organization data.
+ */
+declare const fetchOrganization: ({ org }: {
+    org: string | undefined;
+}, config: CardConfig) => Promise<OrganizationData>;
+export { fetchOrganization };
+//# sourceMappingURL=organization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../../src/fetchers/organization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAatD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkDnD;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,YACZ;IAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,UAC5B,UAAU,KACjB,OAAO,CAAC,gBAAgB,CA4E1B,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/build/fetchers/organization.js

@@ -0,0 +1,115 @@
+import { GITHUB_USERNAME_PATTERN } from '../common/constants.js';
+import { CardError, ORGANIZATION_NOT_FOUND } from '../common/error.js';
+import { createGraphQLFetcher } from '../common/http.js';
+import { retryer } from '../common/retryer.js';
+import { GetOrganizationDocument } from '../graphql/generated/organization.js';
+import { graphqlError } from './graphql-error.js';
+const fetcher = createGraphQLFetcher(GetOrganizationDocument, 'token');
+const urlExample = '/api/org?org=ORG_NAME';
+const ORGANIZATION_ERROR = 'Something went wrong while trying to retrieve the organization data using the GraphQL API.';
+/**
+ * Pages of repositories the walk asks for, 100 each.
+ * Named in the doc comments below as the number it is, so the constant stays internal.
+ * The totals are sums over what it saw and the repositories arrive most-starred first,
+ * so the cap costs an organization past it the tail of its list rather than its headline figures.
+ */
+const MAX_REPO_PAGES = 5;
+/**
+ * @returns The language most of those repositories name as their primary one, `null` when none do.
+ */
+const topLanguage = (repos) => {
+    const counts = new Map();
+    for (const { primaryLanguage } of repos) {
+        if (primaryLanguage) {
+            const seen = counts.get(primaryLanguage.name);
+            counts.set(primaryLanguage.name, {
+                color: primaryLanguage.color,
+                count: (seen?.count ?? 0) + 1,
+            });
+        }
+    }
+    let top = null;
+    let max = 0;
+    for (const [name, { color, count }] of counts) {
+        if (count > max) {
+            max = count;
+            top = { name, color };
+        }
+    }
+    return top;
+};
+/**
+ * Fetch an organization and the totals of its public repositories.
+ *
+ * Only public, non-fork repositories are counted, most-starred first,
+ * and at most five pages of 100 — `truncated` says when the walk stopped early.
+ *
+ * @returns The organization data.
+ */
+const fetchOrganization = async ({ org }, config) => {
+    if (!org) {
+        throw CardError.missingParam(['org'], urlExample);
+    }
+    // `./fetchers` is a public export, so the login is checked here as well as at the api boundary.
+    if (!GITHUB_USERNAME_PATTERN.test(org)) {
+        throw new CardError('Invalid organization provided.', {
+            code: 'invalid_param',
+            param: 'org',
+        });
+    }
+    const repos = [];
+    let organization;
+    let after = null;
+    let pages = 0;
+    do {
+        // Annotated because the walk feeds its own cursor back in, which TypeScript reads as circular.
+        const res = await retryer(fetcher, { login: org, after }, config);
+        if (res.data.errors) {
+            // A login that is a user, or nothing at all, answers NOT_FOUND — which `graphqlError`
+            // words for a user query, so this endpoint's own wording is thrown instead.
+            if (res.data.errors[0]?.type === 'NOT_FOUND') {
+                throw new CardError('Organization not found', {
+                    code: 'not_found',
+                    secondaryMessage: ORGANIZATION_NOT_FOUND,
+                });
+            }
+            throw graphqlError(res.data.errors, res.statusText, ORGANIZATION_ERROR);
+        }
+        organization = res.data.data.organization ?? undefined;
+        if (!organization) {
+            throw new CardError('Organization not found', {
+                code: 'not_found',
+                secondaryMessage: ORGANIZATION_NOT_FOUND,
+            });
+        }
+        repos.push(...(organization.repositories.nodes ?? []).filter((node) => node !== null));
+        const { hasNextPage, endCursor } = organization.repositories.pageInfo;
+        after = hasNextPage ? endCursor : null;
+        pages += 1;
+    } while (after !== null && pages < MAX_REPO_PAGES);
+    const sum = (count) => repos.reduce((total, repo) => total + count(repo), 0);
+    return {
+        login: organization.login,
+        name: organization.name || organization.login,
+        description: organization.description,
+        createdAt: organization.createdAt,
+        publicRepos: organization.repositories.totalCount,
+        totalStars: sum((repo) => repo.stargazerCount),
+        totalForks: sum((repo) => repo.forkCount),
+        totalWatchers: sum((repo) => repo.watchers.totalCount),
+        openIssues: sum((repo) => repo.issues.totalCount),
+        openPRs: sum((repo) => repo.pullRequests.totalCount),
+        totalReleases: sum((repo) => repo.releases.totalCount),
+        // An empty repository has no default branch, and a branch pointing at a tag has no history.
+        totalCommits: sum((repo) => {
+            const target = repo.defaultBranchRef?.target;
+            return target !== null && target !== undefined && 'history' in target
+                ? target.history.totalCount
+                : 0;
+        }),
+        publicMembers: organization.membersWithRole.totalCount,
+        topLanguage: topLanguage(repos),
+        truncated: after !== null,
+    };
+};
+export { fetchOrganization };

package/build/fetchers/types.d.ts

@@ -27,6 +27,44 @@ export interface RepoUserStats {
     totalIssuesCommented?: number;
 }
 export type RepositoryData = RepoInfo & RepoUserStats;
+/**
+ * An organization, with its public repositories aggregated.
+ * Every total is summed over the repositories the walk saw — public, non-fork ones,
+ * most-starred first — so `truncated` says whether that was all of them.
+ */
+export interface OrganizationData {
+    login: string;
+    /** The organization's display name, or its login when it has none. */
+    name: string;
+    description: string | null;
+    /** When the organization was created, as GitHub's own ISO 8601 instant. */
+    createdAt: string;
+    /** Public, non-fork repositories: the whole count, whether or not the walk saw them all. */
+    publicRepos: number;
+    totalStars: number;
+    totalForks: number;
+    totalWatchers: number;
+    openIssues: number;
+    openPRs: number;
+    totalReleases: number;
+    /**
+     * Commits on the default branch of every repository counted: every author, merges included,
+     * and whatever history a repository was imported with.
+     */
+    totalCommits: number;
+    /**
+     * Members GitHub shows publicly.
+     * Membership is private by default, so this counts fewer people than the organization has.
+     */
+    publicMembers: number;
+    /** The language most of those repositories name as their primary one, `null` when none do. */
+    topLanguage: {
+        name: string;
+        color: string | null;
+    } | null;
+    /** Whether the repository walk stopped at its page cap, leaving the totals short. */
+    truncated: boolean;
+}
 export interface StatsData {
     name: string;
     totalPRs: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fetchers/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fetchers/types.ts"],"names":[],"mappings":"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"}

package/build/graphql/generated/organization.d.ts

@@ -0,0 +1,88 @@
+/** Internal type. DO NOT USE DIRECTLY. */
+type Exact<T extends {
+    [key: string]: unknown;
+}> = {
+    [K in keyof T]: T[K];
+};
+export type OrgRepoInfoFragment = {
+    stargazerCount: number;
+    forkCount: number;
+    primaryLanguage: {
+        color: string | null;
+        name: string;
+    } | null;
+    watchers: {
+        totalCount: number;
+    };
+    issues: {
+        totalCount: number;
+    };
+    pullRequests: {
+        totalCount: number;
+    };
+    releases: {
+        totalCount: number;
+    };
+    defaultBranchRef: {
+        target: {
+            history: {
+                totalCount: number;
+            };
+        } | Record<PropertyKey, never> | null;
+    } | null;
+};
+export type GetOrganizationQueryVariables = Exact<{
+    login: string;
+    after?: string | null | undefined;
+}>;
+export type GetOrganizationQuery = {
+    organization: {
+        login: string;
+        name: string | null;
+        description: string | null;
+        createdAt: string;
+        membersWithRole: {
+            totalCount: number;
+        };
+        repositories: {
+            totalCount: number;
+            pageInfo: {
+                hasNextPage: boolean;
+                endCursor: string | null;
+            };
+            nodes: Array<{
+                stargazerCount: number;
+                forkCount: number;
+                primaryLanguage: {
+                    color: string | null;
+                    name: string;
+                } | null;
+                watchers: {
+                    totalCount: number;
+                };
+                issues: {
+                    totalCount: number;
+                };
+                pullRequests: {
+                    totalCount: number;
+                };
+                releases: {
+                    totalCount: number;
+                };
+                defaultBranchRef: {
+                    target: {
+                        history: {
+                            totalCount: number;
+                        };
+                    } | Record<PropertyKey, never> | null;
+                } | null;
+            } | null> | null;
+        };
+    } | null;
+};
+export declare const GetOrganizationDocument: import("../graphqlDocument.ts").GraphQLDocument<GetOrganizationQuery, Exact<{
+    login: string;
+    after?: string | null | undefined;
+}>>;
+export {};
+//# sourceMappingURL=organization.d.ts.map

package/build/graphql/generated/organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../../../src/graphql/generated/organization.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,KAAK,KAAK,CAAC,CAAC,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAE5E,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/D,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,gBAAgB,EAAE;QAChB,MAAM,EAAE;YAAE,OAAO,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;KACjF,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,YAAY,EAAE;YACZ,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,EAAE;gBAAE,WAAW,EAAE,OAAO,CAAC;gBAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC;YAC7D,KAAK,EAAE,KAAK,CAAC;gBACX,cAAc,EAAE,MAAM,CAAC;gBACvB,SAAS,EAAE,MAAM,CAAC;gBAClB,eAAe,EAAE;oBAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,GAAG,IAAI,CAAC;gBAC/D,QAAQ,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACjC,MAAM,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAA;iBAAE,CAAC;gBAC/B,YAAY,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACrC,QAAQ,EAAE;oBAAE,UAAU,EAAE,MAAM,CAAA;iBAAE,CAAC;gBACjC,gBAAgB,EAAE;oBAChB,MAAM,EAAE;wBAAE,OAAO,EAAE;4BAAE,UAAU,EAAE,MAAM,CAAA;yBAAE,CAAA;qBAAE,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;iBACjF,GAAG,IAAI,CAAC;aACV,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;SAClB,CAAC;KACH,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,eAAO,MAAM,uBAAuB;WA9B3B,MAAM;YACL,MAAM,GAAG,IAAI,GAAG,SAAS;GAwFhC,CAAC"}

package/build/graphql/generated/organization.js

@@ -0,0 +1,59 @@
+// Generated file — see .github/CONTRIBUTING.md
+import { graphqlDocument } from '../graphqlDocument.js';
+export const GetOrganizationDocument = graphqlDocument(`
+query getOrganization($login: String!, $after: String) {
+  organization(login: $login) {
+    login
+    name
+    description
+    createdAt
+    membersWithRole {
+      totalCount
+    }
+    repositories(
+      first: 100
+      after: $after
+      privacy: PUBLIC
+      isFork: false
+      orderBy: {field: STARGAZERS, direction: DESC}
+    ) {
+      totalCount
+      pageInfo {
+        hasNextPage
+        endCursor
+      }
+      nodes {
+        ...OrgRepoInfo
+      }
+    }
+  }
+}
+fragment OrgRepoInfo on Repository {
+  stargazerCount
+  forkCount
+  primaryLanguage {
+    color
+    name
+  }
+  watchers {
+    totalCount
+  }
+  issues(states: OPEN) {
+    totalCount
+  }
+  pullRequests(states: OPEN) {
+    totalCount
+  }
+  releases {
+    totalCount
+  }
+  defaultBranchRef {
+    target {
+      ... on Commit {
+        history {
+          totalCount
+        }
+      }
+    }
+  }
+}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stats-forge/github-stats-forge-core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Dynamically generate stats for your GitHub readme",
   "keywords": [
     "card-generator",

package/src/api/contributed-to.ts

@@ -1,6 +1,6 @@
 import * as z from 'zod/mini';
 
-import { renderContributedToCard } from '../cards/contributed-to.ts';
+import { renderContributedToCard } from '../cards/contributed-to/index.ts';
 import { fetchContributedTo } from '../fetchers/contributed-to.ts';
 
 import { cardHandler } from './handler.ts';

package/src/api/gist.ts

@@ -1,6 +1,6 @@
 import * as z from 'zod/mini';
 
-import { renderGistCard } from '../cards/gist.ts';
+import { renderGistCard } from '../cards/gist/index.ts';
 import { fetchGist } from '../fetchers/gist.ts';
 
 import { cardHandler } from './handler.ts';

package/src/api/index.ts

@@ -1,5 +1,6 @@
 export { contributedTo } from './contributed-to.ts';
 export { gist } from './gist.ts';
+export { org } from './organization.ts';
 export { pin } from './pin.ts';
 export { stats } from './stats.ts';
 export { topLangs } from './top-langs.ts';

package/src/api/organization.ts

@@ -0,0 +1,90 @@
+import * as z from 'zod/mini';
+
+import { renderOrganizationCard } from '../cards/organization/index.ts';
+import { fetchOrganization } from '../fetchers/organization.ts';
+
+import { cardHandler } from './handler.ts';
+import {
+  booleanParam,
+  listParam,
+  localeParam,
+  looseIntParam,
+  numberParam,
+  rawParam,
+  usernameParam,
+} from './params.ts';
+
+/** What the organization endpoint accepts, on top of the shared color params. */
+const orgQuery = z.object({
+  org: usernameParam,
+  hide: listParam,
+  show: listParam,
+  show_icons: booleanParam,
+  hide_title: booleanParam,
+  hide_border: booleanParam,
+  hide_description: booleanParam,
+  card_width: looseIntParam,
+  line_height: rawParam,
+  custom_title: rawParam,
+  disable_animations: booleanParam,
+  number_format: rawParam,
+  text_bold: booleanParam,
+  locale: localeParam,
+  border_radius: numberParam,
+});
+
+/**
+ * Render the organization card for a set of query params.
+ *
+ * @returns The rendered card, or a rendered error.
+ */
+const renderOrg = cardHandler(
+  orgQuery,
+  async (
+    {
+      org,
+      hide,
+      show,
+      show_icons,
+      hide_title,
+      hide_border,
+      hide_description,
+      card_width,
+      line_height,
+      custom_title,
+      disable_animations,
+      number_format,
+      text_bold,
+      locale,
+      border_radius,
+    },
+    colors,
+    config,
+  ) => {
+    const organizationData = await fetchOrganization({ org }, config);
+
+    return renderOrganizationCard(organizationData, {
+      ...colors,
+      hide,
+      show,
+      show_icons,
+      hide_title,
+      hide_border,
+      hide_description,
+      card_width,
+      line_height,
+      custom_title,
+      disable_animations,
+      number_format,
+      text_bold,
+      locale,
+      border_radius,
+    });
+  },
+);
+
+/**
+ * The card, and the values each of its options accepts, keyed by the option's own name.
+ * A UI reads them off the function it calls: `org.OPTIONS.show`.
+ */
+export const org = Object.assign(renderOrg, { OPTIONS: renderOrganizationCard.OPTIONS });