perf: improve caching for code + docs

Author: danielroe

app/pages/code/[...path].vue

@@ -11,7 +11,6 @@ definePageMeta({
 })
 
 const route = useRoute('code')
-const router = useRouter()
 
 // Parse package name, version, and file path from URL
 // Patterns:

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

@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { setResponseHeader } from 'h3'
 import type { DocsResponse } from '#shared/types'
 import { assertValidPackageName } from '#shared/utils/npm'
 
@@ -38,6 +39,18 @@ const { data: pkg } = usePackage(packageName)
 
 const latestVersion = computed(() => pkg.value?.['dist-tags']?.latest ?? null)
 
+if (import.meta.server && !requestedVersion.value) {
+  const app = useNuxtApp()
+  const { data: pkg } = await usePackage(packageName)
+  const latest = pkg.value?.['dist-tags']?.latest
+  if (latest) {
+    setResponseHeader(useRequestEvent()!, 'Cache-Control', 'no-cache')
+    app.runWithContext(() =>
+      navigateTo('/docs/' + packageName.value + '/v/' + latest, { redirectCode: 302 }),
+    )
+  }
+}
+
 watch(
   [requestedVersion, latestVersion, packageName],
   ([version, latest, name]) => {

nuxt.config.ts

@@ -79,6 +79,11 @@ export default defineNuxtConfig({
     '/**': { isr: 60 },
     '/package/**': { isr: 60 },
     '/search': { isr: false, cache: false },
+    // infinite cache (versioned - doesn't change)
+    '/code/**': { isr: true, cache: { maxAge: 365 * 24 * 60 * 60 } },
+    '/api/registry/docs/**': { isr: true, cache: { maxAge: 365 * 24 * 60 * 60 } },
+    '/api/registry/file/**': { isr: true, cache: { maxAge: 365 * 24 * 60 * 60 } },
+    '/api/registry/files/**': { isr: true, cache: { maxAge: 365 * 24 * 60 * 60 } },
     // static pages
     '/about': { prerender: true },
     '/settings': { prerender: true },

server/api/registry/docs/[...pkg].get.ts

@@ -1,5 +1,4 @@
 import type { DocsResponse } from '#shared/types'
-import { fetchNpmPackage } from '#server/utils/npm'
 import { assertValidPackageName } from '#shared/utils/npm'
 import { parsePackageParam } from '#shared/utils/parse-package-param'
 import { generateDocsWithDeno } from '#server/utils/docs'
@@ -12,19 +11,17 @@ export default defineCachedEventHandler(
       throw createError({ statusCode: 404, message: 'Package name is required' })
     }
 
-    const { packageName, version: requestedVersion } = parsePackageParam(pkgParam)
+    const { packageName, version } = parsePackageParam(pkgParam)
 
     if (!packageName) {
       // TODO: throwing 404 rather than 400 as it's cacheable
       throw createError({ statusCode: 404, message: 'Package name is required' })
     }
     assertValidPackageName(packageName)
 
-    const packument = await fetchNpmPackage(packageName)
-    const version = requestedVersion ?? packument['dist-tags']?.latest
-
     if (!version) {
-      throw createError({ statusCode: 404, message: 'No latest version found' })
+      // TODO: throwing 404 rather than 400 as it's cacheable
+      throw createError({ statusCode: 404, message: 'Package version is required' })
     }
 
     let generated