@ossintel/github-normalizer 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 turboforge-dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# @ossintel/github-normalizer <img src="https://raw.githubusercontent.com/mayank1513/mayank1513/main/popper.png" style="height: 40px"/>
+
+<p className="flex gap-2">
+  <a href="https://github.com/mayank1513/ossintel/actions/workflows/ci.yml" rel="noopener noreferrer">
+    <img alt="CI" src="https://github.com/mayank1513/ossintel/actions/workflows/ci.yml/badge.svg" />
+  </a>
+  <a href="https://codecov.io/gh/mayank1513/ossintel/tree/main/packages/@ossintel/github-normalizer" rel="noopener noreferrer">
+    <img alt="codecov" src="https://codecov.io/gh/mayank1513/ossintel/graph/badge.svg?flag=@ossintel/github-normalizer" />
+  </a> 
+  <a href="https://npmjs.com/package/@ossintel/github-normalizer" rel="noopener noreferrer">
+    <img alt="npm version" src="https://img.shields.io/npm/v/@ossintel/github-normalizer" />
+  </a>
+  <a href="https://npmjs.com/package/@ossintel/github-normalizer" rel="noopener noreferrer">
+    <img alt="npm downloads" src="https://img.shields.io/npm/d18m/@ossintel/github-normalizer" />
+  </a>
+  <a href="https://npmjs.com/package/@ossintel/github-normalizer" rel="noopener noreferrer">
+    <img alt="npm bundle size" src="https://img.shields.io/bundlephobia/minzip/@ossintel/github-normalizer" />
+  </a>
+  <img alt="license" src="https://img.shields.io/npm/l/@ossintel/github-normalizer" />
+</p>
+
+> @ossintel/github-normalizer: Typed utilities for fetching and normalizing GitHub REST and GraphQL data into a consistent domain model for analytics and reporting.
+
+# @ossintel/github-normalizer
+
+Typed utilities for fetching and normalizing GitHub data.
+
+## Purpose
+
+GitHub's REST and GraphQL APIs expose excellent data but with inconsistent shapes and multiple endpoints.
+
+This package provides a stable domain model consumed by the rest of OSSIntel.
+
+## Responsibilities
+
+- Fetch GitHub data
+- Normalize responses
+- Hide API complexity
+- Handle pagination
+- Handle rate limits
+- Provide strongly typed models
+
+## Non-goals
+
+- Scoring
+- AI
+- Business logic
+- UI
+
+## Planned API
+
+```ts
+fetchDeveloper();
+
+fetchRepositories();
+
+fetchRepository();
+
+fetchOrganizations();
+
+fetchContributors();
+
+fetchLanguages();
+
+fetchReleases();
+```
+
+## Output
+
+Always returns normalized domain models.
+
+Never expose raw GitHub responses.
+
+## Design Principles
+
+- Pure TypeScript
+- Strong typing
+- Stable contracts
+- Easily replaceable backend
+
+---
+
+## ✨ Why @ossintel/github-normalizer?
+
+-
+-
+
+---
+
+## 📦 Installation
+
+```bash
+$ pnpm add @ossintel/github-normalizer
+```
+
+**_or_**
+
+```bash
+$ npm install @ossintel/github-normalizer
+```
+
+**_or_**
+
+```bash
+$ yarn add @ossintel/github-normalizer
+```
+
+## License
+
+This library is licensed under the MIT open-source license.
+
+<hr />
+
+<p align="center">with 💖 by <a href="https://mayankchaudhari.com" target="_blank">Mayank Kumar Chaudhari</a></p>

package/dist/index.d.mts

@@ -0,0 +1,231 @@
+interface GitHubFetchOptions {
+    token?: string;
+    baseUrl?: string;
+    perPage?: number;
+    page?: number;
+    allPages?: boolean;
+}
+declare class GitHubHttpError extends Error {
+    status: number;
+    statusText: string;
+    constructor(status: number, statusText: string, message: string);
+}
+declare class GitHubRateLimitError extends Error {
+    limit: number;
+    remaining: number;
+    resetTime: Date;
+    constructor(limit: number, remaining: number, resetTime: Date, message: string);
+}
+interface RawGitHubUser {
+    id: number;
+    login: string;
+    name: string | null;
+    avatar_url: string;
+    html_url: string;
+    type: string;
+    company?: string | null;
+    blog?: string | null;
+    location?: string | null;
+    email?: string | null;
+    bio?: string | null;
+    twitter_username?: string | null;
+    public_repos?: number;
+    public_gists?: number;
+    followers?: number;
+    following?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface RawGitHubRepository {
+    id: number;
+    name: string;
+    full_name: string;
+    owner?: {
+        login: string;
+        id: number;
+        avatar_url: string;
+        type: string;
+    };
+    html_url: string;
+    description?: string | null;
+    fork?: boolean;
+    created_at: string;
+    updated_at: string;
+    pushed_at: string;
+    homepage?: string | null;
+    size?: number;
+    stargazers_count?: number;
+    watchers_count?: number;
+    language?: string | null;
+    forks_count?: number;
+    open_issues_count?: number;
+    default_branch?: string;
+    topics?: string[];
+    archived?: boolean;
+}
+interface RawGitHubOrganization {
+    id: number;
+    login: string;
+    name?: string | null;
+    description?: string | null;
+    avatar_url: string;
+    html_url: string;
+    location?: string | null;
+    email?: string | null;
+    blog?: string | null;
+    twitter_username?: string | null;
+    public_repos?: number;
+    followers?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface RawGitHubContributor {
+    id: number;
+    login: string;
+    avatar_url: string;
+    html_url: string;
+    type?: string;
+    contributions?: number;
+}
+interface RawGitHubRelease {
+    id: number;
+    name?: string | null;
+    tag_name: string;
+    target_commitish: string;
+    body?: string | null;
+    draft?: boolean;
+    prerelease?: boolean;
+    created_at: string;
+    published_at?: string | null;
+    html_url: string;
+    author?: {
+        login: string;
+        id: number;
+        avatar_url: string;
+    } | null;
+}
+interface NormalizedDeveloper {
+    id: number;
+    login: string;
+    name: string | null;
+    avatarUrl: string;
+    htmlUrl: string;
+    type: string;
+    company: string | null;
+    blog: string | null;
+    location: string | null;
+    email: string | null;
+    bio: string | null;
+    twitterUsername: string | null;
+    publicRepos: number;
+    publicGists: number;
+    followers: number;
+    following: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface NormalizedRepository {
+    id: number;
+    name: string;
+    fullName: string;
+    owner: {
+        login: string;
+        id: number;
+        avatarUrl: string;
+        type: string;
+    };
+    htmlUrl: string;
+    description: string | null;
+    isFork: boolean;
+    createdAt: string;
+    updatedAt: string;
+    pushedAt: string;
+    homepage: string | null;
+    size: number;
+    stargazersCount: number;
+    watchersCount: number;
+    language: string | null;
+    forksCount: number;
+    openIssuesCount: number;
+    defaultBranch: string;
+    topics: string[];
+    isArchived: boolean;
+}
+interface NormalizedOrganization {
+    id: number;
+    login: string;
+    name: string | null;
+    description: string | null;
+    avatarUrl: string;
+    htmlUrl: string;
+    location: string | null;
+    email: string | null;
+    blog: string | null;
+    twitterUsername: string | null;
+    publicRepos: number;
+    followers: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface NormalizedContributor {
+    id: number;
+    login: string;
+    avatarUrl: string;
+    htmlUrl: string;
+    type: string;
+    contributions: number;
+}
+interface NormalizedLanguage {
+    name: string;
+    bytes: number;
+}
+interface NormalizedRelease {
+    id: number;
+    name: string | null;
+    tagName: string;
+    targetCommitish: string;
+    body: string | null;
+    draft: boolean;
+    prerelease: boolean;
+    createdAt: string;
+    publishedAt: string | null;
+    htmlUrl: string;
+    author: {
+        login: string;
+        id: number;
+        avatarUrl: string;
+    } | null;
+}
+interface InputDetectionResult {
+    platform: "github" | "npm" | "stackoverflow" | "unknown";
+    type: "user" | "org" | "repo" | "package" | "unknown";
+    owner?: string;
+    repo?: string;
+    name?: string;
+    profileId?: string;
+    rawInput: string;
+}
+interface LinkedIdentitySuggestions {
+    stackoverflow?: {
+        profileId: string;
+        displayName: string;
+        url: string;
+    };
+    npm?: {
+        username: string;
+        url: string;
+    };
+}
+
+declare function fetchDeveloper(username?: string, options?: GitHubFetchOptions): Promise<NormalizedDeveloper>;
+declare function fetchRepositories(owner?: string, options?: GitHubFetchOptions): Promise<NormalizedRepository[]>;
+declare function fetchRepository(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedRepository>;
+declare function fetchOrganizations(username?: string, options?: GitHubFetchOptions): Promise<NormalizedOrganization[]>;
+declare function fetchContributors(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedContributor[]>;
+declare function fetchLanguages(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedLanguage[]>;
+declare function fetchReleases(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedRelease[]>;
+declare function fetchOrganization(login: string, options?: GitHubFetchOptions): Promise<NormalizedOrganization>;
+declare function detectInput(input: string): InputDetectionResult;
+declare function suggestLinkedIdentities(developer: NormalizedDeveloper, _repositories: NormalizedRepository[]): LinkedIdentitySuggestions;
+
+export { type GitHubFetchOptions, GitHubHttpError, GitHubRateLimitError, type InputDetectionResult, type LinkedIdentitySuggestions, type NormalizedContributor, type NormalizedDeveloper, type NormalizedLanguage, type NormalizedOrganization, type NormalizedRelease, type NormalizedRepository, type RawGitHubContributor, type RawGitHubOrganization, type RawGitHubRelease, type RawGitHubRepository, type RawGitHubUser, detectInput, fetchContributors, fetchDeveloper, fetchLanguages, fetchOrganization, fetchOrganizations, fetchReleases, fetchRepositories, fetchRepository, suggestLinkedIdentities };

package/dist/index.d.ts

@@ -0,0 +1,231 @@
+interface GitHubFetchOptions {
+    token?: string;
+    baseUrl?: string;
+    perPage?: number;
+    page?: number;
+    allPages?: boolean;
+}
+declare class GitHubHttpError extends Error {
+    status: number;
+    statusText: string;
+    constructor(status: number, statusText: string, message: string);
+}
+declare class GitHubRateLimitError extends Error {
+    limit: number;
+    remaining: number;
+    resetTime: Date;
+    constructor(limit: number, remaining: number, resetTime: Date, message: string);
+}
+interface RawGitHubUser {
+    id: number;
+    login: string;
+    name: string | null;
+    avatar_url: string;
+    html_url: string;
+    type: string;
+    company?: string | null;
+    blog?: string | null;
+    location?: string | null;
+    email?: string | null;
+    bio?: string | null;
+    twitter_username?: string | null;
+    public_repos?: number;
+    public_gists?: number;
+    followers?: number;
+    following?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface RawGitHubRepository {
+    id: number;
+    name: string;
+    full_name: string;
+    owner?: {
+        login: string;
+        id: number;
+        avatar_url: string;
+        type: string;
+    };
+    html_url: string;
+    description?: string | null;
+    fork?: boolean;
+    created_at: string;
+    updated_at: string;
+    pushed_at: string;
+    homepage?: string | null;
+    size?: number;
+    stargazers_count?: number;
+    watchers_count?: number;
+    language?: string | null;
+    forks_count?: number;
+    open_issues_count?: number;
+    default_branch?: string;
+    topics?: string[];
+    archived?: boolean;
+}
+interface RawGitHubOrganization {
+    id: number;
+    login: string;
+    name?: string | null;
+    description?: string | null;
+    avatar_url: string;
+    html_url: string;
+    location?: string | null;
+    email?: string | null;
+    blog?: string | null;
+    twitter_username?: string | null;
+    public_repos?: number;
+    followers?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface RawGitHubContributor {
+    id: number;
+    login: string;
+    avatar_url: string;
+    html_url: string;
+    type?: string;
+    contributions?: number;
+}
+interface RawGitHubRelease {
+    id: number;
+    name?: string | null;
+    tag_name: string;
+    target_commitish: string;
+    body?: string | null;
+    draft?: boolean;
+    prerelease?: boolean;
+    created_at: string;
+    published_at?: string | null;
+    html_url: string;
+    author?: {
+        login: string;
+        id: number;
+        avatar_url: string;
+    } | null;
+}
+interface NormalizedDeveloper {
+    id: number;
+    login: string;
+    name: string | null;
+    avatarUrl: string;
+    htmlUrl: string;
+    type: string;
+    company: string | null;
+    blog: string | null;
+    location: string | null;
+    email: string | null;
+    bio: string | null;
+    twitterUsername: string | null;
+    publicRepos: number;
+    publicGists: number;
+    followers: number;
+    following: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface NormalizedRepository {
+    id: number;
+    name: string;
+    fullName: string;
+    owner: {
+        login: string;
+        id: number;
+        avatarUrl: string;
+        type: string;
+    };
+    htmlUrl: string;
+    description: string | null;
+    isFork: boolean;
+    createdAt: string;
+    updatedAt: string;
+    pushedAt: string;
+    homepage: string | null;
+    size: number;
+    stargazersCount: number;
+    watchersCount: number;
+    language: string | null;
+    forksCount: number;
+    openIssuesCount: number;
+    defaultBranch: string;
+    topics: string[];
+    isArchived: boolean;
+}
+interface NormalizedOrganization {
+    id: number;
+    login: string;
+    name: string | null;
+    description: string | null;
+    avatarUrl: string;
+    htmlUrl: string;
+    location: string | null;
+    email: string | null;
+    blog: string | null;
+    twitterUsername: string | null;
+    publicRepos: number;
+    followers: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface NormalizedContributor {
+    id: number;
+    login: string;
+    avatarUrl: string;
+    htmlUrl: string;
+    type: string;
+    contributions: number;
+}
+interface NormalizedLanguage {
+    name: string;
+    bytes: number;
+}
+interface NormalizedRelease {
+    id: number;
+    name: string | null;
+    tagName: string;
+    targetCommitish: string;
+    body: string | null;
+    draft: boolean;
+    prerelease: boolean;
+    createdAt: string;
+    publishedAt: string | null;
+    htmlUrl: string;
+    author: {
+        login: string;
+        id: number;
+        avatarUrl: string;
+    } | null;
+}
+interface InputDetectionResult {
+    platform: "github" | "npm" | "stackoverflow" | "unknown";
+    type: "user" | "org" | "repo" | "package" | "unknown";
+    owner?: string;
+    repo?: string;
+    name?: string;
+    profileId?: string;
+    rawInput: string;
+}
+interface LinkedIdentitySuggestions {
+    stackoverflow?: {
+        profileId: string;
+        displayName: string;
+        url: string;
+    };
+    npm?: {
+        username: string;
+        url: string;
+    };
+}
+
+declare function fetchDeveloper(username?: string, options?: GitHubFetchOptions): Promise<NormalizedDeveloper>;
+declare function fetchRepositories(owner?: string, options?: GitHubFetchOptions): Promise<NormalizedRepository[]>;
+declare function fetchRepository(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedRepository>;
+declare function fetchOrganizations(username?: string, options?: GitHubFetchOptions): Promise<NormalizedOrganization[]>;
+declare function fetchContributors(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedContributor[]>;
+declare function fetchLanguages(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedLanguage[]>;
+declare function fetchReleases(owner: string, repo: string, options?: GitHubFetchOptions): Promise<NormalizedRelease[]>;
+declare function fetchOrganization(login: string, options?: GitHubFetchOptions): Promise<NormalizedOrganization>;
+declare function detectInput(input: string): InputDetectionResult;
+declare function suggestLinkedIdentities(developer: NormalizedDeveloper, _repositories: NormalizedRepository[]): LinkedIdentitySuggestions;
+
+export { type GitHubFetchOptions, GitHubHttpError, GitHubRateLimitError, type InputDetectionResult, type LinkedIdentitySuggestions, type NormalizedContributor, type NormalizedDeveloper, type NormalizedLanguage, type NormalizedOrganization, type NormalizedRelease, type NormalizedRepository, type RawGitHubContributor, type RawGitHubOrganization, type RawGitHubRelease, type RawGitHubRepository, type RawGitHubUser, detectInput, fetchContributors, fetchDeveloper, fetchLanguages, fetchOrganization, fetchOrganizations, fetchReleases, fetchRepositories, fetchRepository, suggestLinkedIdentities };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var H=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var U=(t,e)=>{for(var n in e)d(t,n,{get:e[n],enumerable:!0})},O=(t,e,n,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of G(e))!x.call(t,r)&&r!==n&&d(t,r,{get:()=>e[r],enumerable:!(i=H(e,r))||i.enumerable});return t};var k=t=>O(d({},"__esModule",{value:!0}),t);var E={};U(E,{GitHubHttpError:()=>p,GitHubRateLimitError:()=>c,detectInput:()=>B,fetchContributors:()=>F,fetchDeveloper:()=>A,fetchLanguages:()=>D,fetchOrganization:()=>W,fetchOrganizations:()=>T,fetchReleases:()=>L,fetchRepositories:()=>P,fetchRepository:()=>C,suggestLinkedIdentities:()=>j});module.exports=k(E);var p=class extends Error{status;statusText;constructor(e,n,i){super(i),this.name="GitHubHttpError",this.status=e,this.statusText=n}},c=class extends Error{limit;remaining;resetTime;constructor(e,n,i,r){super(r),this.name="GitHubRateLimitError",this.limit=e,this.remaining=n,this.resetTime=i}};function _(t){let e=t?.token??process.env.GITHUB_TOKEN??process.env.GITHUB_PAT,n=t?.baseUrl??"https://api.github.com",i={Accept:"application/vnd.github+json","X-GitHub-Api-Version":"2022-11-28"};return e&&(i.Authorization=`Bearer ${e}`),{baseUrl:n,headers:i}}async function R(t,e){let n=await fetch(t,{headers:e}),i=n.headers.get("x-ratelimit-limit"),r=n.headers.get("x-ratelimit-remaining"),s=n.headers.get("x-ratelimit-reset");if((n.status===403||n.status===429)&&r==="0"&&s){let a=i?Number.parseInt(i,10):0,g=Number.parseInt(r,10),o=new Date(Number.parseInt(s,10)*1e3);throw new c(a,g,o,`GitHub API Rate Limit Exceeded. Resets at ${o.toISOString()}`)}if(!n.ok){let a=await n.text().catch(()=>"");throw new p(n.status,n.statusText,`GitHub API request failed with status ${n.status}: ${a||n.statusText}`)}return n}async function u(t,e){let{baseUrl:n,headers:i}=_(e),r=t.startsWith("http://")||t.startsWith("https://")?t:`${n}${t.startsWith("/")?"":"/"}${t}`;return(await R(r,i)).json()}async function m(t,e){let{baseUrl:n,headers:i}=_(e),r=[],s=null,a=e?.perPage??100,g=e?.page,o=t;if(!o.startsWith("http://")&&!o.startsWith("https://")){let b=o.includes("?")?"&":"?",l=[];a!==void 0&&l.push(`per_page=${a}`),g!==void 0&&l.push(`page=${g}`),l.length>0&&(o=`${o}${b}${l.join("&")}`)}do{let b=s??(o.startsWith("http://")||o.startsWith("https://")?o:`${n}${o.startsWith("/")?"":"/"}${o}`),l=await R(b,i),h=await l.json();if(Array.isArray(h))r.push(...h);else break;if(e?.allPages===!1||g!==void 0)break;let f=l.headers.get("link");if(f){let y=f.match(/<([^>]+)>;\s*rel="next"/);s=y?y[1]:null}else s=null}while(s);return r}function N(t){return{id:t.id,login:t.login,name:t.name??null,avatarUrl:t.avatar_url,htmlUrl:t.html_url,type:t.type,company:t.company??null,blog:t.blog??null,location:t.location??null,email:t.email??null,bio:t.bio??null,twitterUsername:t.twitter_username??null,publicRepos:t.public_repos??0,publicGists:t.public_gists??0,followers:t.followers??0,following:t.following??0,createdAt:t.created_at,updatedAt:t.updated_at}}function z(t){return{id:t.id,name:t.name,fullName:t.full_name,owner:{login:t.owner?.login??"",id:t.owner?.id??0,avatarUrl:t.owner?.avatar_url??"",type:t.owner?.type??""},htmlUrl:t.html_url,description:t.description??null,isFork:t.fork??!1,createdAt:t.created_at,updatedAt:t.updated_at,pushedAt:t.pushed_at,homepage:t.homepage??null,size:t.size??0,stargazersCount:t.stargazers_count??0,watchersCount:t.watchers_count??0,language:t.language??null,forksCount:t.forks_count??0,openIssuesCount:t.open_issues_count??0,defaultBranch:t.default_branch??"main",topics:t.topics??[],isArchived:t.archived??!1}}function w(t){return{id:t.id,login:t.login,name:t.name??null,description:t.description??null,avatarUrl:t.avatar_url,htmlUrl:t.html_url,location:t.location??null,email:t.email??null,blog:t.blog??null,twitterUsername:t.twitter_username??null,publicRepos:t.public_repos??0,followers:t.followers??0,createdAt:t.created_at,updatedAt:t.updated_at}}function $(t){return{id:t.id,login:t.login,avatarUrl:t.avatar_url,htmlUrl:t.html_url,type:t.type??"User",contributions:t.contributions??0}}function v(t){return{id:t.id,name:t.name??null,tagName:t.tag_name,targetCommitish:t.target_commitish,body:t.body??null,draft:t.draft??!1,prerelease:t.prerelease??!1,createdAt:t.created_at,publishedAt:t.published_at??null,htmlUrl:t.html_url,author:t.author?{login:t.author.login,id:t.author.id,avatarUrl:t.author.avatar_url}:null}}async function I(t,e){try{return(await u(`/users/${t}`,e)).type==="Organization"?"Organization":"User"}catch{return"User"}}async function A(t,e){let n=t?`/users/${t}`:"/user",i=await u(n,e);if(i.type==="Organization")throw new Error(`Requested entity '${t||"authenticated user"}' is an Organization, not a User.`);return N(i)}async function P(t,e){let n;return t?n=await I(t,e)==="Organization"?`/orgs/${t}/repos`:`/users/${t}/repos`:n="/user/repos",(await m(n,e)).map(z)}async function C(t,e,n){let i=await u(`/repos/${t}/${e}`,n);return z(i)}async function T(t,e){let n=t?`/users/${t}/orgs`:"/user/orgs",i=await m(n,e);return(await Promise.all(i.map(s=>u(`/orgs/${s.login}`,e)))).map(w)}async function F(t,e,n){return(await m(`/repos/${t}/${e}/contributors`,n)).map($)}async function D(t,e,n){let i=await u(`/repos/${t}/${e}/languages`,n);return Object.entries(i).map(([r,s])=>({name:r,bytes:s}))}async function L(t,e,n){return(await m(`/repos/${t}/${e}/releases`,n)).map(v)}async function W(t,e){let n=await u(`/orgs/${t}`,e);return w(n)}function B(t){let e=t.trim();try{let n=new URL(e.startsWith("http")?e:`https://${e}`),i=n.hostname.toLowerCase();if(i.includes("github.com")){let r=n.pathname.split("/").filter(Boolean);if(r.length===1)return{platform:"github",type:"unknown",owner:r[0],rawInput:e};if(r.length>=2)return{platform:"github",type:"repo",owner:r[0],repo:r[1],rawInput:e}}if(i.includes("npmjs.com")){let r=n.pathname.split("/").filter(Boolean);if(r[0]==="package")return{platform:"npm",type:"package",name:r.slice(1).join("/"),rawInput:e};if(r[0].startsWith("~"))return{platform:"npm",type:"user",name:r[0].slice(1),rawInput:e};if(r[0].startsWith("@"))return r.length===1?{platform:"npm",type:"org",name:r[0],rawInput:e}:{platform:"npm",type:"package",name:`${r[0]}/${r[1]}`,rawInput:e}}if(i.includes("stackoverflow.com")){let r=n.pathname.split("/").filter(Boolean);if(r[0]==="users"&&r[1])return{platform:"stackoverflow",type:"user",profileId:r[1],name:r[2]||void 0,rawInput:e}}}catch{}if(e.includes("/")){let n=e.split("/");return{platform:"github",type:"repo",owner:n[0],repo:n[1],rawInput:e}}return{platform:"github",type:"unknown",owner:e,rawInput:e}}function j(t,e){let n={},i=[t.blog,t.bio,t.company].filter(Boolean),r=/stackoverflow\.com\/users\/(\d+)\/([a-zA-Z0-9_-]+)?/;for(let s of i){let a=s.match(r);if(a){n.stackoverflow={profileId:a[1],displayName:a[2]||t.login,url:`https://stackoverflow.com/users/${a[1]}/${a[2]||""}`};break}}return n.npm={username:t.login,url:`https://www.npmjs.com/~${t.login}`},n}0&&(module.exports={GitHubHttpError,GitHubRateLimitError,detectInput,fetchContributors,fetchDeveloper,fetchLanguages,fetchOrganization,fetchOrganizations,fetchReleases,fetchRepositories,fetchRepository,suggestLinkedIdentities});

package/dist/index.mjs

@@ -0,0 +1 @@
+var c=class extends Error{status;statusText;constructor(n,e,i){super(i),this.name="GitHubHttpError",this.status=n,this.statusText=e}},m=class extends Error{limit;remaining;resetTime;constructor(n,e,i,r){super(r),this.name="GitHubRateLimitError",this.limit=n,this.remaining=e,this.resetTime=i}};function y(t){let n=t?.token??process.env.GITHUB_TOKEN??process.env.GITHUB_PAT,e=t?.baseUrl??"https://api.github.com",i={Accept:"application/vnd.github+json","X-GitHub-Api-Version":"2022-11-28"};return n&&(i.Authorization=`Bearer ${n}`),{baseUrl:e,headers:i}}async function _(t,n){let e=await fetch(t,{headers:n}),i=e.headers.get("x-ratelimit-limit"),r=e.headers.get("x-ratelimit-remaining"),s=e.headers.get("x-ratelimit-reset");if((e.status===403||e.status===429)&&r==="0"&&s){let a=i?Number.parseInt(i,10):0,g=Number.parseInt(r,10),o=new Date(Number.parseInt(s,10)*1e3);throw new m(a,g,o,`GitHub API Rate Limit Exceeded. Resets at ${o.toISOString()}`)}if(!e.ok){let a=await e.text().catch(()=>"");throw new c(e.status,e.statusText,`GitHub API request failed with status ${e.status}: ${a||e.statusText}`)}return e}async function u(t,n){let{baseUrl:e,headers:i}=y(n),r=t.startsWith("http://")||t.startsWith("https://")?t:`${e}${t.startsWith("/")?"":"/"}${t}`;return(await _(r,i)).json()}async function p(t,n){let{baseUrl:e,headers:i}=y(n),r=[],s=null,a=n?.perPage??100,g=n?.page,o=t;if(!o.startsWith("http://")&&!o.startsWith("https://")){let b=o.includes("?")?"&":"?",l=[];a!==void 0&&l.push(`per_page=${a}`),g!==void 0&&l.push(`page=${g}`),l.length>0&&(o=`${o}${b}${l.join("&")}`)}do{let b=s??(o.startsWith("http://")||o.startsWith("https://")?o:`${e}${o.startsWith("/")?"":"/"}${o}`),l=await _(b,i),d=await l.json();if(Array.isArray(d))r.push(...d);else break;if(n?.allPages===!1||g!==void 0)break;let h=l.headers.get("link");if(h){let f=h.match(/<([^>]+)>;\s*rel="next"/);s=f?f[1]:null}else s=null}while(s);return r}function w(t){return{id:t.id,login:t.login,name:t.name??null,avatarUrl:t.avatar_url,htmlUrl:t.html_url,type:t.type,company:t.company??null,blog:t.blog??null,location:t.location??null,email:t.email??null,bio:t.bio??null,twitterUsername:t.twitter_username??null,publicRepos:t.public_repos??0,publicGists:t.public_gists??0,followers:t.followers??0,following:t.following??0,createdAt:t.created_at,updatedAt:t.updated_at}}function R(t){return{id:t.id,name:t.name,fullName:t.full_name,owner:{login:t.owner?.login??"",id:t.owner?.id??0,avatarUrl:t.owner?.avatar_url??"",type:t.owner?.type??""},htmlUrl:t.html_url,description:t.description??null,isFork:t.fork??!1,createdAt:t.created_at,updatedAt:t.updated_at,pushedAt:t.pushed_at,homepage:t.homepage??null,size:t.size??0,stargazersCount:t.stargazers_count??0,watchersCount:t.watchers_count??0,language:t.language??null,forksCount:t.forks_count??0,openIssuesCount:t.open_issues_count??0,defaultBranch:t.default_branch??"main",topics:t.topics??[],isArchived:t.archived??!1}}function z(t){return{id:t.id,login:t.login,name:t.name??null,description:t.description??null,avatarUrl:t.avatar_url,htmlUrl:t.html_url,location:t.location??null,email:t.email??null,blog:t.blog??null,twitterUsername:t.twitter_username??null,publicRepos:t.public_repos??0,followers:t.followers??0,createdAt:t.created_at,updatedAt:t.updated_at}}function H(t){return{id:t.id,login:t.login,avatarUrl:t.avatar_url,htmlUrl:t.html_url,type:t.type??"User",contributions:t.contributions??0}}function G(t){return{id:t.id,name:t.name??null,tagName:t.tag_name,targetCommitish:t.target_commitish,body:t.body??null,draft:t.draft??!1,prerelease:t.prerelease??!1,createdAt:t.created_at,publishedAt:t.published_at??null,htmlUrl:t.html_url,author:t.author?{login:t.author.login,id:t.author.id,avatarUrl:t.author.avatar_url}:null}}async function x(t,n){try{return(await u(`/users/${t}`,n)).type==="Organization"?"Organization":"User"}catch{return"User"}}async function $(t,n){let e=t?`/users/${t}`:"/user",i=await u(e,n);if(i.type==="Organization")throw new Error(`Requested entity '${t||"authenticated user"}' is an Organization, not a User.`);return w(i)}async function v(t,n){let e;return t?e=await x(t,n)==="Organization"?`/orgs/${t}/repos`:`/users/${t}/repos`:e="/user/repos",(await p(e,n)).map(R)}async function I(t,n,e){let i=await u(`/repos/${t}/${n}`,e);return R(i)}async function A(t,n){let e=t?`/users/${t}/orgs`:"/user/orgs",i=await p(e,n);return(await Promise.all(i.map(s=>u(`/orgs/${s.login}`,n)))).map(z)}async function P(t,n,e){return(await p(`/repos/${t}/${n}/contributors`,e)).map(H)}async function C(t,n,e){let i=await u(`/repos/${t}/${n}/languages`,e);return Object.entries(i).map(([r,s])=>({name:r,bytes:s}))}async function T(t,n,e){return(await p(`/repos/${t}/${n}/releases`,e)).map(G)}async function F(t,n){let e=await u(`/orgs/${t}`,n);return z(e)}function D(t){let n=t.trim();try{let e=new URL(n.startsWith("http")?n:`https://${n}`),i=e.hostname.toLowerCase();if(i.includes("github.com")){let r=e.pathname.split("/").filter(Boolean);if(r.length===1)return{platform:"github",type:"unknown",owner:r[0],rawInput:n};if(r.length>=2)return{platform:"github",type:"repo",owner:r[0],repo:r[1],rawInput:n}}if(i.includes("npmjs.com")){let r=e.pathname.split("/").filter(Boolean);if(r[0]==="package")return{platform:"npm",type:"package",name:r.slice(1).join("/"),rawInput:n};if(r[0].startsWith("~"))return{platform:"npm",type:"user",name:r[0].slice(1),rawInput:n};if(r[0].startsWith("@"))return r.length===1?{platform:"npm",type:"org",name:r[0],rawInput:n}:{platform:"npm",type:"package",name:`${r[0]}/${r[1]}`,rawInput:n}}if(i.includes("stackoverflow.com")){let r=e.pathname.split("/").filter(Boolean);if(r[0]==="users"&&r[1])return{platform:"stackoverflow",type:"user",profileId:r[1],name:r[2]||void 0,rawInput:n}}}catch{}if(n.includes("/")){let e=n.split("/");return{platform:"github",type:"repo",owner:e[0],repo:e[1],rawInput:n}}return{platform:"github",type:"unknown",owner:n,rawInput:n}}function L(t,n){let e={},i=[t.blog,t.bio,t.company].filter(Boolean),r=/stackoverflow\.com\/users\/(\d+)\/([a-zA-Z0-9_-]+)?/;for(let s of i){let a=s.match(r);if(a){e.stackoverflow={profileId:a[1],displayName:a[2]||t.login,url:`https://stackoverflow.com/users/${a[1]}/${a[2]||""}`};break}}return e.npm={username:t.login,url:`https://www.npmjs.com/~${t.login}`},e}export{c as GitHubHttpError,m as GitHubRateLimitError,D as detectInput,P as fetchContributors,$ as fetchDeveloper,C as fetchLanguages,F as fetchOrganization,A as fetchOrganizations,T as fetchReleases,v as fetchRepositories,I as fetchRepository,L as suggestLinkedIdentities};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ossintel/github-normalizer",
+  "author": "Mayank Kumar Chaudhari <https://mayankchaudhari.com>",
+  "private": false,
+  "version": "0.0.0",
+  "description": "Typed utilities for fetching and normalizing GitHub REST and GraphQL data into a consistent domain model for analytics and reporting.",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mayank1513/ossintel",
+    "directory": "packages/github-normalizer"
+  },
+  "bugs": "https://github.com/mayank1513/ossintel/issues",
+  "homepage": "https://github.com/mayank1513/ossintel/blob/main/packages/github-normalizer/README.md",
+  "sideEffects": false,
+  "files": [
+    "dist/**"
+  ],
+  "devDependencies": {
+    "@types/node": "latest",
+    "tsup": "latest",
+    "typescript": "latest"
+  },
+  "forge": {
+    "aliases": [],
+    "icon": "LibraryBig",
+    "description": ""
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/mayank1513"
+    },
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/mayank1513"
+    }
+  ],
+  "keywords": [
+    "@ossintel/github-normalizer",
+    "turboforge"
+  ],
+  "scripts": {
+    "build": "tsup && gzip -c dist/index.js | wc -c",
+    "clean": "rm -rf dist",
+    "dev": "tsup --watch"
+  }
+}