feat: add changelog button

vinnymac · vinnymac · commit 87a2f2aabfbc · 2026-02-02T12:29:51.000-05:00
diff --git a/app/composables/usePackageAnalysis.ts b/app/composables/usePackageAnalysis.ts
@@ -1,4 +1,5 @@
 import type { ModuleFormat, TypesStatus, CreatePackageInfo } from '#shared/utils/package-analysis'
+import type { ChangelogInfo } from '#shared/types'
 
 export interface PackageAnalysisResponse {
   package: string
@@ -10,6 +11,7 @@ export interface PackageAnalysisResponse {
     npm?: string
   }
   createPackage?: CreatePackageInfo
+  changelog?: ChangelogInfo
 }
 
 /**
diff --git a/app/pages/package/[...package].vue b/app/pages/package/[...package].vue
@@ -609,6 +609,26 @@ defineOgImageComponent('Package', {
                 {{ $t('package.links.issues') }}
               </a>
             </li>
+            <li v-if="packageAnalysis?.changelog">
+              <NuxtLink
+                v-if="packageAnalysis.changelog.source === 'file'"
+                :to="packageAnalysis.changelog.url"
+                class="link-subtle font-mono text-sm inline-flex items-center gap-1.5"
+              >
+                <span class="i-carbon:catalog w-4 h-4" aria-hidden="true" />
+                {{ $t('package.links.changelog') }}
+              </NuxtLink>
+              <a
+                v-else
+                :href="packageAnalysis.changelog.url"
+                target="_blank"
+                rel="noopener noreferrer"
+                class="link-subtle font-mono text-sm inline-flex items-center gap-1.5"
+              >
+                <span class="i-carbon:catalog w-4 h-4" aria-hidden="true" />
+                {{ $t('package.links.changelog') }}
+              </a>
+            </li>
             <li>
               <a
                 :href="`https://www.npmjs.com/package/${pkg.name}`"
diff --git a/i18n/locales/en.json b/i18n/locales/en.json
@@ -175,6 +175,7 @@
       "repo": "repo",
       "homepage": "homepage",
       "issues": "issues",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "code",
       "docs": "docs",
diff --git a/lunaria/files/ar-EG.json b/lunaria/files/ar-EG.json
@@ -175,6 +175,7 @@
       "repo": "المستودع",
       "homepage": "الصفحة الرئيسية",
       "issues": "المشكلات",
+      "changelog": "سجل التغييرات",
       "jsr": "jsr",
       "code": "الكود",
       "docs": "التوثيق",
diff --git a/lunaria/files/az.json b/lunaria/files/az.json
@@ -143,6 +143,7 @@
       "repo": "repo",
       "homepage": "ana səhifə",
       "issues": "xətalar",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "kod",
       "docs": "sənədlər",
diff --git a/lunaria/files/cs-CZ.json b/lunaria/files/cs-CZ.json
@@ -171,6 +171,7 @@
       "repo": "repozitář",
       "homepage": "domovská stránka",
       "issues": "úkoly",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "kód",
       "docs": "dokumentace",
diff --git a/lunaria/files/de-DE.json b/lunaria/files/de-DE.json
@@ -172,6 +172,7 @@
       "repo": "Repo",
       "homepage": "Homepage",
       "issues": "Issues",
+      "changelog": "Changelog",
       "jsr": "JSR",
       "code": "Code",
       "docs": "Doku",
diff --git a/lunaria/files/en-US.json b/lunaria/files/en-US.json
@@ -175,6 +175,7 @@
       "repo": "repo",
       "homepage": "homepage",
       "issues": "issues",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "code",
       "docs": "docs",
diff --git a/lunaria/files/es-419.json b/lunaria/files/es-419.json
@@ -144,6 +144,7 @@
       "repo": "repo",
       "homepage": "página de inicio",
       "issues": "problemas",
+      "changelog": "historial de cambios",
       "jsr": "jsr",
       "code": "código",
       "docs": "documentación",
diff --git a/lunaria/files/es-ES.json b/lunaria/files/es-ES.json
@@ -144,6 +144,7 @@
       "repo": "repo",
       "homepage": "página de inicio",
       "issues": "problemas",
+      "changelog": "historial de cambios",
       "jsr": "jsr",
       "code": "código",
       "docs": "documentación",
diff --git a/lunaria/files/fr-FR.json b/lunaria/files/fr-FR.json
@@ -151,6 +151,7 @@
       "repo": "dépôt",
       "homepage": "site web",
       "issues": "issues",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "code",
       "docs": "docs",
diff --git a/lunaria/files/hi-IN.json b/lunaria/files/hi-IN.json
@@ -171,6 +171,7 @@
       "repo": "रिपो",
       "homepage": "मुखपृष्ठ",
       "issues": "मसले",
+      "changelog": "परिवर्तन लॉग",
       "jsr": "jsr",
       "code": "कोड",
       "docs": "दस्तावेज़",
diff --git a/lunaria/files/hu-HU.json b/lunaria/files/hu-HU.json
@@ -143,6 +143,7 @@
       "repo": "repo",
       "homepage": "honlap",
       "issues": "hibák",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "kód",
       "docs": "dokumentáció",
diff --git a/lunaria/files/id-ID.json b/lunaria/files/id-ID.json
@@ -155,6 +155,7 @@
       "repo": "repo",
       "homepage": "beranda",
       "issues": "kendala",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "kode",
       "docs": "dokumen",
diff --git a/lunaria/files/it-IT.json b/lunaria/files/it-IT.json
@@ -128,6 +128,7 @@
       "repo": "repo",
       "homepage": "homepage",
       "issues": "issues",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "codice",
       "docs": "documenti",
diff --git a/lunaria/files/ja-JP.json b/lunaria/files/ja-JP.json
@@ -132,6 +132,7 @@
       "repo": "リポジトリ",
       "homepage": "ホームページ",
       "issues": "issues",
+      "changelog": "変更履歴",
       "jsr": "jsr",
       "code": "コード",
       "docs": "ドキュメント",
diff --git a/lunaria/files/ne-NP.json b/lunaria/files/ne-NP.json
@@ -155,6 +155,7 @@
       "repo": "रिपो",
       "homepage": "होमपेज",
       "issues": "इश्यूहरू",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "कोड",
       "docs": "डकुमेन्टेसन",
diff --git a/lunaria/files/pl-PL.json b/lunaria/files/pl-PL.json
@@ -171,6 +171,7 @@
       "repo": "repozytorium",
       "homepage": "strona",
       "issues": "zgłoszenia",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "kod źródłowy",
       "docs": "dokumentacja",
diff --git a/lunaria/files/pt-BR.json b/lunaria/files/pt-BR.json
@@ -172,6 +172,7 @@
       "repo": "repositório",
       "homepage": "página inicial",
       "issues": "problemas",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "código",
       "docs": "documentação",
diff --git a/lunaria/files/ru-RU.json b/lunaria/files/ru-RU.json
@@ -140,6 +140,7 @@
       "repo": "репозиторий",
       "homepage": "сайт",
       "issues": "issues",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "код",
       "docs": "доки",
diff --git a/lunaria/files/uk-UA.json b/lunaria/files/uk-UA.json
@@ -143,6 +143,7 @@
       "repo": "репозиторій",
       "homepage": "головна сторінка",
       "issues": "проблеми",
+      "changelog": "changelog",
       "jsr": "jsr",
       "code": "код",
       "docs": "документація",
diff --git a/lunaria/files/zh-CN.json b/lunaria/files/zh-CN.json
@@ -175,6 +175,7 @@
       "repo": "仓库",
       "homepage": "主页",
       "issues": "议题",
+      "changelog": "更新日志",
       "jsr": "jsr",
       "code": "代码",
       "docs": "文档",
diff --git a/server/api/registry/analysis/[...pkg].get.ts b/server/api/registry/analysis/[...pkg].get.ts
@@ -19,6 +19,10 @@ import {
 } from '#shared/utils/constants'
 import { parseRepoUrl } from '#shared/utils/git-providers'
 import { getLatestVersion, getLatestVersionBatch } from 'fast-npm-meta'
+import type { ChangelogInfo } from '#shared/types'
+import { findChangelogFile } from '#shared/utils/changelog'
+import { fetchFileTree } from '../../../utils/file-tree'
+import { checkReleaseTag } from '../../../utils/release-tag'
 
 export default defineCachedEventHandler(
   async event => {
@@ -52,12 +56,17 @@ export default defineCachedEventHandler(
       // Only show if the packages are actually associated (same maintainers or same org)
       const createPackage = await findAssociatedCreatePackage(packageName, pkg)
 
+      // Detect changelog: check release tag first (faster), then fall back to file tree
+      const resolvedVersion = pkg.version ?? version ?? 'latest'
+      const changelog = await detectChangelog(pkg, packageName, resolvedVersion)
+
       const analysis = analyzePackage(pkg, { typesPackage, createPackage })
 
       return {
         package: packageName,
-        version: pkg.version ?? version ?? 'latest',
+        version: resolvedVersion,
         ...analysis,
+        changelog,
       } satisfies PackageAnalysisResponse
     } catch (error: unknown) {
       handleApiError(error, {
@@ -71,7 +80,7 @@ export default defineCachedEventHandler(
     swr: true,
     getKey: event => {
       const pkg = getRouterParam(event, 'pkg') ?? ''
-      return `analysis:v1:${pkg.replace(/\/+$/, '').trim()}`
+      return `analysis:v2:${pkg.replace(/\/+$/, '').trim()}`
     },
   },
 )
@@ -216,3 +225,49 @@ export interface PackageAnalysisResponse extends PackageAnalysis {
   package: string
   version: string
 }
+
+/**
+ * Detect changelog for a package version.
+ * Priority: release tag (faster) > changelog file in tarball
+ */
+async function detectChangelog(
+  pkg: ExtendedPackageJson,
+  packageName: string,
+  version: string,
+): Promise<ChangelogInfo | undefined> {
+  // Step 1: Check for release tag (faster - single API call per tag format)
+  if (pkg.repository?.url) {
+    const repoRef = parseRepoUrl(pkg.repository.url)
+    if (repoRef) {
+      try {
+        const releaseInfo = await checkReleaseTag(repoRef, version, packageName)
+        if (releaseInfo.exists && releaseInfo.url) {
+          return {
+            source: 'releases',
+            url: releaseInfo.url,
+          }
+        }
+      } catch {
+        // Release tag check failed, continue to file tree check
+      }
+    }
+  }
+
+  // Step 2: Check for changelog file in tarball (fallback)
+  try {
+    const fileTreeResult = await fetchFileTree(packageName, version)
+    const changelogFile = findChangelogFile(fileTreeResult.files)
+    if (changelogFile) {
+      return {
+        source: 'file',
+        url: `/package-code/${packageName}/v/${version}/${changelogFile}`,
+        filename: changelogFile,
+      }
+    }
+  } catch {
+    // File tree fetch failed, no changelog available
+  }
+
+  // Neither release tag nor changelog file found
+  return undefined
+}
diff --git a/server/utils/release-tag.ts b/server/utils/release-tag.ts
diff --git a/shared/types/npm-registry.ts b/shared/types/npm-registry.ts
diff --git a/shared/utils/changelog.ts b/shared/utils/changelog.ts
diff --git a/shared/utils/package-analysis.ts b/shared/utils/package-analysis.ts

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`import type { ModuleFormat, TypesStatus, CreatePackageInfo } from '#shared/utils/package-analysis'`
	`2`	`+import type { ChangelogInfo } from '#shared/types'`
`2`	`3`
`3`	`4`	`export interface PackageAnalysisResponse {`
`4`	`5`	`package: string`
`@@ -10,6 +11,7 @@ export interface PackageAnalysisResponse {`
`10`	`11`	`npm?: string`
`11`	`12`	`}`
`12`	`13`	`createPackage?: CreatePackageInfo`
	`14`	`+ changelog?: ChangelogInfo`
`13`	`15`	`}`
`14`	`16`
`15`	`17`	`/**`