Domain Types: TypeScript Interfaces for Portfolio Data

interface SocialLink {
  kind: 'github' | 'linkedin' | 'x' | 'instagram' | 'facebook' | 'youtube' | 'website' | 'blog' | 'email';
  label: string;
  url: string;
}

interface Profile {
  login: string;
  name: string;
  avatarUrl: string;
  bio: string | null;
  location: string | null;
  company: string | null;
  blog: string | null;
  email: string | null;
  publicRepos: number;
  followers: number;
  following: number;
  createdAt: string; // ISO 8601
  htmlUrl: string;
  socials: SocialLink[];
}

interface ReleaseInfo {
  name: string;         // release title or tag_name if no title
  tag: string;          // git tag (e.g. 'v1.2.0')
  publishedAt: string | null; // ISO 8601 or null
  url: string;          // GitHub release page URL
}

interface Repository {
  id: number;
  name: string;
  description: string | null;
  htmlUrl: string;
  homepage: string | null;
  language: string | null;       // primary language
  languages: Record<string, number>; // language -> bytes
  technologies: string[];         // detected frameworks/tools
  stars: number;
  forks: number;
  watchers: number;
  openIssues: number;
  archived: boolean;
  visibility: string;             // 'public' | 'private' | 'internal'
  createdAt: string;
  updatedAt: string;
  pushedAt: string;
  topics: string[];
  hasPages: boolean;
  license: string | null;        // SPDX identifier
  release: ReleaseInfo | null;
}

interface LanguageSlice {
  name: string;
  bytes: number;
  percentage: number;   // 0-100, 1 decimal
  repoCount: number;
  color: string;        // hex color
}

interface PortfolioStats {
  totalRepos: number;
  totalStars: number;
  totalForks: number;
  totalReleases: number;
  activeRepos: number;
  archivedRepos: number;
  languages: LanguageSlice[];
  lastSyncedAt: string; // ISO 8601
}

interface ActivityItem {
  id: string;
  type: string;         // GitHub event type (e.g. 'PushEvent')
  repoName: string;     // 'owner/repo' format
  repoUrl: string;
  branch: string | null;
  createdAt: string;
  summary: string;      // human-readable description
}

interface PortfolioSnapshot {
  profile: Profile;
  repositories: Repository[];
  stats: PortfolioStats;
  activity: ActivityItem[];
  degraded: boolean;    // true when GitHub API was unreachable
}