RepoResponse.kt

package zed.rainxch.githubstore.model

import kotlinx.serialization.Serializable

@Serializable
data class RepoOwner(
    val login: String,
    val avatarUrl: String?,
)

// Nested form of the GitHub-detected license. Same data as the flat
// `licenseSpdxId` / `licenseName` fields below; this shape matches the
// upstream GitHub object so a client doing direct-GitHub fallback can use
// one DTO. Prefer this nested form on new client code; the flat fields
// are kept for back-compat with shipped client builds.
@Serializable
data class RepoLicense(
    val spdxId: String? = null,
    val name: String? = null,
)

@Serializable
data class RepoResponse(
    val id: Long,
    val name: String,
    val fullName: String,
    val owner: RepoOwner,
    val description: String?,
    val defaultBranch: String?,
    val htmlUrl: String,
    val stargazersCount: Int,
    val forksCount: Int,
    // Mirrors GitHub's open_issues_count -- includes both open issues AND
    // open PRs (GitHub treats PRs as a kind of issue). Same value as the
    // GitHub website's Issues tab badge.
    val openIssuesCount: Int = 0,
    // GitHub-detected license. Null when the repo has no LICENSE file or
    // when GitHub couldn't classify it. spdxId is the short tag for chip
    // display ("MIT", "GPL-3.0", "Apache-2.0"); name is the human-readable
    // version ("MIT License").
    val licenseSpdxId: String? = null,
    val licenseName: String? = null,
    // Nested form of the same data, matching upstream GitHub's shape.
    // Clients should prefer this; the flat fields above will be removed
    // after the next client release migrates.
    val license: RepoLicense? = null,
    val language: String?,
    val topics: List<String>,
    // Canonical topic codes derived from raw topics via TopicCodeMapper.
    // 15 possible codes (ai, privacy, security, networking, messaging, browser,
    // social, launcher, notes, reader, audio, video, photo, backup, self-hosted).
    // Empty when no raw topic matches the canonical set. Frontend renders up to 3
    // as TopicGlyph icons. Never stored in DB or Meili — computed at response time.
    val topicCodes: List<String> = emptyList(),
    val releasesUrl: String?,
    val updatedAt: String?,
    val createdAt: String?,
    // R5/R13: last commit timestamp (GitHub pushed_at = default-branch HEAD).
    // Distinct from updatedAt (last metadata change). Null for Meili-served
    // search results until meili_sync.py backfills the field.
    val pushedAt: String? = null,
    val latestReleaseDate: String? = null,
    val latestReleaseTag: String? = null,
    val releaseRecency: Int? = null,
    val releaseRecencyText: String? = null,
    val downloadCount: Long = 0,
    val trendingScore: Double? = null,
    val popularityScore: Double? = null,
    val hasInstallersAndroid: Boolean = false,
    val hasInstallersWindows: Boolean = false,
    val hasInstallersMacos: Boolean = false,
    val hasInstallersLinux: Boolean = false,
    // null for GitHub-sourced repos (preserves the byte-identical pre-1.9.0
    // wire shape); the forge host ("codeberg.org" etc.) when this response
    // comes from the host-keyed /v1/repo proxy or the /v1/search source=...
    // fan-out. Client routes downstream calls (releases, README, asset
    // download) at the forge when this field is non-null.
    @kotlinx.serialization.SerialName("source_host") val sourceHost: String? = null,
    // Comma-separated list of host short-names that ship the same logical
    // app (3.6 cross-forge dedup). e.g. `["github.com", "codeberg.org"]`
    // when a project mirrors between forges. Empty list = single-source
    // result; pre-1.9.0 clients ignore the field. The first entry is the
    // canonical home (whichever side has the higher star count today).
    @kotlinx.serialization.SerialName("available_on") val availableOn: List<String> = emptyList(),
)