ts-github-trending

A TypeScript package for fetching and parsing GitHub trending repositories and developers.

Features

• Fetch trending repositories and developers from GitHub
• Parse trending data into structured TypeScript objects
• Support for different time periods (daily, weekly, monthly)
• Support for language-specific trending
• Type-safe API

Installation

pnpm add ts-github-trending

Usage

import { getTrendingRepos, getTrendingDevelopers } from 'ts-github-trending';

// Get trending repositories
const repos = await getTrendingRepos({
  since: 'daily',  // 'daily' | 'weekly' | 'monthly'
  language: 'typescript'  // optional
});

// Get trending developers
const developers = await getTrendingDevelopers({
  since: 'weekly'
});

API

getTrendingRepos(options)

Fetches trending repositories from GitHub.

Options

• since: Time period ('daily' | 'weekly' | 'monthly')
• language: Programming language (optional)
• spokenLanguage: Repository's spoken language (optional)

Returns

Array of repository objects with the following structure:

interface Repository {
  author: string;
  name: string;
  description: string;
  url: string;
  language: string;
  languageColor: string;
  stars: number;
  forks: number;
  starsInPeriod: number;
}

getTrendingDevelopers(options)

Fetches trending developers from GitHub.

Options

• since: Time period ('daily' | 'weekly' | 'monthly')
• language: Programming language (optional)

Returns

Array of developer objects with the following structure:

interface Developer {
  username: string;
  name: string;
  avatar: string;
  url: string;
  popularRepository: {
    name: string;
    description: string;
    url: string;
  };
}

License

MIT