feat: add GitHub contributors fixture

Author: danielroe

modules/runtime/server/cache.ts

@@ -25,6 +25,7 @@ const FIXTURE_PATHS = {
   user: 'users',
   esmHeaders: 'esm-sh:headers',
   esmTypes: 'esm-sh:types',
+  githubContributors: 'github:contributors.json',
 } as const
 
 type FixtureType = keyof typeof FIXTURE_PATHS
@@ -156,6 +157,13 @@ function getMockForUrl(url: string): MockResult | null {
     return { data: null }
   }
 
+  // GitHub API - handled via fixtures, return null to use fixture system
+  // Note: The actual fixture loading is handled in fetchFromFixtures via special case
+  if (host === 'api.github.com') {
+    // Return null here so it goes through fetchFromFixtures which handles the fixture loading
+    return null
+  }
+
   // esm.sh is handled specially via $fetch.raw override, not here
   // Return null to indicate no mock available at the cachedFetch level
 
@@ -273,6 +281,39 @@ async function handleFastNpmMeta(
   return { data: result }
 }
 
+/**
+ * Handle GitHub API requests using fixtures.
+ */
+async function handleGitHubApi(
+  url: string,
+  storage: ReturnType<typeof useStorage>,
+): Promise<MockResult | null> {
+  let urlObj: URL
+  try {
+    urlObj = new URL(url)
+  } catch {
+    return null
+  }
+
+  const { host, pathname } = urlObj
+
+  if (host !== 'api.github.com') return null
+
+  // Contributors endpoint: /repos/{owner}/{repo}/contributors
+  const contributorsMatch = pathname.match(/^\/repos\/([^/]+)\/([^/]+)\/contributors$/)
+  if (contributorsMatch) {
+    const contributors = await storage.getItem<unknown[]>(FIXTURE_PATHS.githubContributors)
+    if (contributors) {
+      return { data: contributors }
+    }
+    // Return empty array if no fixture exists
+    return { data: [] }
+  }
+
+  // Other GitHub API endpoints can be added here as needed
+  return null
+}
+
 interface FixtureMatchWithVersion extends FixtureMatch {
   version?: string // 'latest', a semver version, or undefined for full packument
 }
@@ -385,6 +426,13 @@ async function fetchFromFixtures<T>(
     return { data: fastNpmMetaResult.data as T, isStale: false, cachedAt: Date.now() }
   }
 
+  // Check for GitHub API
+  const githubResult = await handleGitHubApi(url, storage)
+  if (githubResult) {
+    if (VERBOSE) process.stdout.write(`[test-fixtures] GitHub API: ${url}\n`)
+    return { data: githubResult.data as T, isStale: false, cachedAt: Date.now() }
+  }
+
   const match = matchUrlToFixture(url)
 
   if (!match) {

test/e2e/test-utils.ts

@@ -322,6 +322,48 @@ async function handleGravatarApi(route: Route): Promise<boolean> {
   return true
 }
 
+/**
+ * Handle GitHub API requests.
+ * Returns mock contributor data for the contributors endpoint.
+ */
+async function handleGitHubApi(route: Route): Promise<boolean> {
+  const url = new URL(route.request().url())
+  const pathname = url.pathname
+
+  // Contributors endpoint: /repos/{owner}/{repo}/contributors
+  const contributorsMatch = pathname.match(/^\/repos\/([^/]+)\/([^/]+)\/contributors$/)
+  if (contributorsMatch) {
+    await route.fulfill({
+      json: [
+        {
+          login: 'danielroe',
+          id: 28706372,
+          avatar_url: 'https://avatars.githubusercontent.com/u/28706372?v=4',
+          html_url: 'https://github.com/danielroe',
+          contributions: 150,
+        },
+        {
+          login: 'antfu',
+          id: 11247099,
+          avatar_url: 'https://avatars.githubusercontent.com/u/11247099?v=4',
+          html_url: 'https://github.com/antfu',
+          contributions: 120,
+        },
+        {
+          login: 'pi0',
+          id: 5158436,
+          avatar_url: 'https://avatars.githubusercontent.com/u/5158436?v=4',
+          html_url: 'https://github.com/pi0',
+          contributions: 100,
+        },
+      ],
+    })
+    return true
+  }
+
+  return false
+}
+
 /**
  * Fail the test with a clear error message when an external API request isn't mocked.
  */
@@ -402,6 +444,12 @@ async function setupRouteMocking(page: Page): Promise<void> {
     const handled = await handleGravatarApi(route)
     if (!handled) failUnmockedRequest(route, 'Gravatar API')
   })
+
+  // GitHub API for contributors, etc.
+  await page.route('https://api.github.com/**', async route => {
+    const handled = await handleGitHubApi(route)
+    if (!handled) failUnmockedRequest(route, 'GitHub API')
+  })
 }
 
 /**

test/fixtures/github/contributors.json

@@ -0,0 +1,37 @@
+[
+  {
+    "login": "danielroe",
+    "id": 28706372,
+    "avatar_url": "https://avatars.githubusercontent.com/u/28706372?v=4",
+    "html_url": "https://github.com/danielroe",
+    "contributions": 150
+  },
+  {
+    "login": "antfu",
+    "id": 11247099,
+    "avatar_url": "https://avatars.githubusercontent.com/u/11247099?v=4",
+    "html_url": "https://github.com/antfu",
+    "contributions": 120
+  },
+  {
+    "login": "pi0",
+    "id": 5158436,
+    "avatar_url": "https://avatars.githubusercontent.com/u/5158436?v=4",
+    "html_url": "https://github.com/pi0",
+    "contributions": 100
+  },
+  {
+    "login": "qwerzl",
+    "id": 73090488,
+    "avatar_url": "https://avatars.githubusercontent.com/u/73090488?v=4",
+    "html_url": "https://github.com/qwerzl",
+    "contributions": 80
+  },
+  {
+    "login": "harlan-zw",
+    "id": 5326365,
+    "avatar_url": "https://avatars.githubusercontent.com/u/5326365?v=4",
+    "html_url": "https://github.com/harlan-zw",
+    "contributions": 60
+  }
+]