fix: use fast-npm-meta to get latest versions (#664)

Author: danielroe

app/pages/package-docs/[...path].vue

@@ -51,7 +51,7 @@ if (import.meta.server && !requestedVersion.value && packageName.value) {
       navigateTo(
         { name: 'docs', params: { path: pathSegments as [string, ...string[]] } },
         { redirectCode: 302 },
-      ),
+      )
     )
   }
 }

server/utils/npm.ts

@@ -1,7 +1,7 @@
 import type { Packument, NpmSearchResponse } from '#shared/types'
 import { encodePackageName, fetchLatestVersion } from '#shared/utils/npm'
 import { maxSatisfying, prerelease } from 'semver'
-import { CACHE_MAX_AGE_FIVE_MINUTES } from '#shared/utils/constants'
+import { CACHE_MAX_AGE_FIVE_MINUTES, CACHE_MAX_AGE_ONE_DAY } from '#shared/utils/constants'
 
 const NPM_REGISTRY = 'https://registry.npmjs.org'
 

shared/utils/npm.ts

@@ -33,6 +33,34 @@ export async function fetchLatestVersion(name: string): Promise<string | null> {
   }
 }
 
+/**
+ * Encode package name for URL usage.
+ * Scoped packages need special handling (@scope/name → @scope%2Fname)
+ */
+export function encodePackageName(name: string): string {
+  if (name.startsWith('@')) {
+    return `@${encodeURIComponent(name.slice(1))}`
+  }
+  return encodeURIComponent(name)
+}
+
+/**
+ * Fetch the latest version of a package using fast-npm-meta API.
+ * This is a lightweight alternative to fetching the full packument.
+ *
+ * @param name Package name
+ * @returns Latest version string or null if not found
+ * @see https://github.com/antfu/fast-npm-meta
+ */
+export async function fetchLatestVersion(name: string): Promise<string | null> {
+  try {
+    const meta = await getLatestVersion(name)
+    return meta.version
+  } catch {
+    return null
+  }
+}
+
 /**
  * Validate an npm package name and throw an HTTP error if invalid.
  * Uses validate-npm-package-name to check against npm naming rules.