feat: add multi-strategy version fetchers, disable auto-fetch by default

- Add 4 version-fetch strategies (UpToDateCheck API, Store Page Scrape, Community Hub Scrape, Store API Heuristic) — no Steam API key needed - Create orchestrator that tries all strategies, prefers named version over build ID - Add test page at /test-version-fetchers for comparing strategies - Add standalone /api/version-test endpoint (direct Steam App ID, no DB) - Update /api/games/:id/steamdb-version to use new strategies - Disable auto-fetch on submit page by default (NEXT_PUBLIC_VERSION_AUTO_FETCH=true to enable) - SteamDB scraping blocked by Cloudflare; strategies preserved for later enablement
2026-05-16 20:13:23 +08:00
parent 88a098f387
commit e5f671a992
13 changed files with 1356 additions and 37 deletions
@@ -0,0 +1,133 @@
+/**
+ * Strategy 4: Steam Store API (appdetails) + Heuristics
+ *
+ * Uses the public store.steampowered.com/api/appdetails endpoint (no API key).
+ * While it doesn't directly contain version/build IDs, we can extract:
+ * - The ?t= cache-busting timestamp from image URLs (changes with updates)
+ * - Release date information
+ * - Any version hints in the game description
+ */
+import type { VersionFetchResult } from "./types"
+
+const APPDETAILS_URL = "https://store.steampowered.com/api/appdetails"
+
+interface AppDetailsResponse {
+  [appId: string]: {
+    success: boolean
+    data?: {
+      name: string
+      header_image?: string
+      release_date?: {
+        coming_soon: boolean
+        date: string
+      }
+      detailed_description?: string
+      about_the_game?: string
+      // Steam may include additional fields
+      [key: string]: unknown
+    }
+  }
+}
+
+export async function fetchStoreApi(
+  steamAppId: number,
+): Promise<VersionFetchResult> {
+  const source = "Store API Heuristic"
+
+  try {
+    const res = await fetch(
+      `${APPDETAILS_URL}?appids=${steamAppId}`,
+      {
+        headers: {
+          "User-Agent":
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
+          Accept: "application/json",
+        },
+        signal: AbortSignal.timeout(10000),
+      },
+    )
+
+    if (!res.ok) {
+      return {
+        versionString: null,
+        buildId: null,
+        source,
+        success: false,
+        error: `HTTP ${res.status}`,
+      }
+    }
+
+    const data: AppDetailsResponse = await res.json()
+    const appData = data[String(steamAppId)]
+
+    if (!appData?.success || !appData.data) {
+      return {
+        versionString: null,
+        buildId: null,
+        source,
+        success: false,
+        error: "App not found or not available",
+      }
+    }
+
+    const { data: details } = appData
+
+    let versionString: string | null = null
+    let buildId: string | null = null
+
+    // ── Extract timestamp from header_image URL ────────────────
+    // e.g. header.jpg?t=1749053861 — changes with every game update
+    if (details.header_image) {
+      const tsMatch = details.header_image.match(/\?t=(\d{9,10})/)
+      if (tsMatch) {
+        buildId = tsMatch[1]
+      }
+    }
+
+    // ── Search description for version mentions ────────────────
+    const textToSearch = [
+      details.about_the_game,
+      details.detailed_description,
+    ]
+      .filter(Boolean)
+      .join(" ")
+
+    if (textToSearch) {
+      // Strip HTML tags
+      const cleanText = textToSearch.replace(/<[^>]+>/g, " ")
+
+      // Look for version patterns in description
+      const versionPatterns = [
+        /(?:version|patch|update)\s*[:#]?\s*(\d+\.\d+(?:\.\d+)?(?:[a-z]\d*)?)/i,
+        /v?(\d+\.\d+\.\d+(?:[a-z]\d*)?)/i,
+      ]
+
+      for (const pattern of versionPatterns) {
+        const match = cleanText.match(pattern)
+        if (match) {
+          versionString = match[1]
+          break
+        }
+      }
+    }
+
+    const success = !!(versionString || buildId)
+    return {
+      versionString,
+      buildId,
+      source,
+      success,
+      error: success
+        ? undefined
+        : "No version hints found in store API data",
+    }
+  } catch (err) {
+    return {
+      versionString: null,
+      buildId: null,
+      source,
+      success: false,
+      error: err instanceof Error ? err.message : "Unknown error",
+    }
+  }
+}