From e8b7ba49ce7069658f163706f9bfc96870c2bec8 Mon Sep 17 00:00:00 2001
From: Tanner Linsley <tannerlinsley@gmail.com>
Date: Wed, 19 Aug 2026 08:07:21 -0600
Subject: [PATCH] Avoid caching docs fallbacks

---
 src/utils/docs.functions.ts | 36 ++++++++++++++++++++++++++----------
 1 file changed, 26 insertions(+), 10 deletions(-)

diff --git a/src/utils/docs.functions.ts b/src/utils/docs.functions.ts
index 77b85a33d..71969bf16 100644
--- a/src/utils/docs.functions.ts
+++ b/src/utils/docs.functions.ts
@@ -161,13 +161,19 @@ async function readRepoFileOrFallback(
     await loadDocumentsServerModule()
 
   try {
-    return await fetchRepoFile(repo, branch, filePath)
+    return {
+      file: await fetchRepoFile(repo, branch, filePath),
+      isFallback: false,
+    }
   } catch (error) {
     if (!isRecoverableGitHubContentError(error)) {
       throw error
     }
 
-    return buildUnavailableFile(filePath)
+    return {
+      file: buildUnavailableFile(filePath),
+      isFallback: true,
+    }
   }
 }
 
@@ -423,19 +429,24 @@ export const fetchDocs = createServerFn({ method: 'GET' })
   .validator(repoFileInput)
   .handler(async ({ data }: { data: RepoFileRequest }) => {
     const { repo, branch, filePath } = data
-    const file = await readRepoFileOrFallback(repo, branch, filePath)
+    const result = await readRepoFileOrFallback(repo, branch, filePath)
 
-    if (!file) {
+    if (!result.file) {
       throw notFound()
     }
 
     const { extractFrontMatter } = await loadDocumentsServerModule()
-    const frontMatter = extractFrontMatter(file)
+    const frontMatter = extractFrontMatter(result.file)
     const description =
       frontMatter.userDescription ?? removeMarkdown(frontMatter.excerpt ?? '')
     const keywords = extractFrontMatterKeywords(frontMatter.data.keywords)
 
-    setDocsCacheHeaders('public, max-age=3600, stale-while-revalidate=86400')
+    setDocsCacheHeaders(
+      result.isFallback
+        ? 'no-store'
+        : 'public, max-age=3600, stale-while-revalidate=86400',
+    )
+    if (result.isFallback) setResponseHeader('Cache-Control', 'no-store')
 
     return {
       content: frontMatter.content,
@@ -470,15 +481,20 @@ export const fetchFile = createServerFn({ method: 'GET' })
   .validator(repoFileInput)
   .handler(async ({ data }: { data: RepoFileRequest }) => {
     const { repo, branch, filePath } = data
-    const file = await readRepoFileOrFallback(repo, branch, filePath)
+    const result = await readRepoFileOrFallback(repo, branch, filePath)
 
-    if (!file) {
+    if (!result.file) {
       throw notFound()
     }
 
-    setDocsCacheHeaders('public, max-age=300, stale-while-revalidate=300')
+    setDocsCacheHeaders(
+      result.isFallback
+        ? 'no-store'
+        : 'public, max-age=300, stale-while-revalidate=300',
+    )
+    if (result.isFallback) setResponseHeader('Cache-Control', 'no-store')
 
-    return file
+    return result.file
   })
 
 export const fetchRepoDirectoryContents = createServerFn({