feat: enrich game cards with bestFps, raw/poor performer badges, and battery estimates (Tasks 5.1-5.6)

lib/api/games-listing.ts

@@ -358,6 +358,71 @@ export const gamesListingRoutes = new Elysia({ prefix: "/games/listing" }).get(
       }
     }
 
+    // ── Performance stats: best FPS, raw performer, poor performance ──
+    const rawPerformerMap = new Map<string, boolean>()
+    const poorPerformerMap = new Map<string, boolean>()
+    const bestFpsMap = new Map<string, number>()
+    const batteryMinMap = new Map<string, number>()
+
+    if (gameIds.length > 0) {
+      const perfStats = await db
+        .select({
+          gameId: gameVersions.gameId,
+          bestFps: sql<number>`MAX(${performanceEntries.fpsAvg})::real`,
+          isRawPerformer: sql<boolean>`BOOL_OR(
+            ${performanceEntries.fpsAvg} >= 60
+            AND ${performanceEntries.upscalerType} = 'none'
+            AND ${performanceEntries.frameGenMethod} = 'none'
+          )`,
+          isPoorPerformance: sql<boolean>`BOOL_OR(${performanceEntries.fpsAvg} < 30)`,
+        })
+        .from(performanceEntries)
+        .innerJoin(gameVersions, eq(performanceEntries.versionId, gameVersions.id))
+        .where(
+          and(
+            inArray(gameVersions.gameId, gameIds),
+            eq(performanceEntries.isRemoved, false),
+          ),
+        )
+        .groupBy(gameVersions.gameId)
+
+      for (const row of perfStats) {
+        bestFpsMap.set(row.gameId, row.bestFps)
+        rawPerformerMap.set(row.gameId, row.isRawPerformer)
+        poorPerformerMap.set(row.gameId, row.isPoorPerformance)
+      }
+
+      // Battery estimate for handheld devices
+      const batteryStats = await db
+        .select({
+          gameId: gameVersions.gameId,
+          estimatedBatteryMin: sql<number>`ROUND(
+            (${hardware.wattHours}::real / ${performanceEntries.tdpWatts}) * 60
+          )::int`,
+        })
+        .from(performanceEntries)
+        .innerJoin(gameVersions, eq(performanceEntries.versionId, gameVersions.id))
+        .innerJoin(hardware, eq(performanceEntries.hardwareSlug, hardware.slug))
+        .where(
+          and(
+            inArray(gameVersions.gameId, gameIds),
+            eq(performanceEntries.isRemoved, false),
+            eq(hardware.deviceType, "handheld"),
+            sql`${performanceEntries.tdpWatts} IS NOT NULL AND ${performanceEntries.tdpWatts} > 0`,
+            sql`${hardware.wattHours} IS NOT NULL`,
+          ),
+        )
+        .orderBy(desc(performanceEntries.fpsAvg))
+
+      const seenGames = new Set<string>()
+      for (const row of batteryStats) {
+        if (!seenGames.has(row.gameId)) {
+          seenGames.add(row.gameId)
+          batteryMinMap.set(row.gameId, row.estimatedBatteryMin)
+        }
+      }
+    }
+
     const enrichedData = data.map((g) => ({
       id: g.id,
       steamAppId: g.steamAppId,
@@ -377,6 +442,10 @@ export const gamesListingRoutes = new Elysia({ prefix: "/games/listing" }).get(
       deckStatus: platformMap.get(g.id) ?? null,
       antiCheatRelevant: antiCheatMap.get(g.id)?.antiCheatRelevant ?? false,
       antiCheatStatus: antiCheatMap.get(g.id)?.antiCheatStatus ?? null,
+      bestFps: bestFpsMap.get(g.id) ?? null,
+      isRawPerformer: rawPerformerMap.get(g.id) ?? false,
+      isPoorPerformance: poorPerformerMap.get(g.id) ?? false,
+      estimatedBatteryMin: batteryMinMap.get(g.id) ?? null,
     }))
 
     // If sorting by benchmarks, re-sort the enriched data

lib/api/search-unified.ts

@@ -6,7 +6,7 @@ import {
   performanceEntries,
   gameComments,
 } from "@/lib/db/schema"
-import { ilike, or, sql, eq, inArray, and, gte } from "drizzle-orm"
+import { ilike, or, sql, eq, inArray, and, gte, desc } from "drizzle-orm"
 import { fuzzySearchTerm } from "@/lib/db/search"
 
 interface SteamSearchItem {
@@ -323,6 +323,43 @@ export const searchUnifiedRoutes = new Elysia({ prefix: "/search" }).get(
       }
     }
 
+    // ── 2b2. Battery estimate for handheld devices ────────────────────
+    const batteryMinMap = new Map<string, number>()
+
+    if (finalIds.length > 0) {
+      const { hardware: hardwareTable } = await import("@/lib/db/schema")
+
+      const batteryStats = await db
+        .select({
+          gameId: gameVersions.gameId,
+          estimatedBatteryMin: sql<number>`ROUND(
+            (${hardwareTable.wattHours}::real / ${performanceEntries.tdpWatts}) * 60
+          )::int`,
+        })
+        .from(performanceEntries)
+        .innerJoin(gameVersions, eq(performanceEntries.versionId, gameVersions.id))
+        .innerJoin(hardwareTable, eq(performanceEntries.hardwareSlug, hardwareTable.slug))
+        .where(
+          and(
+            inArray(gameVersions.gameId, finalIds),
+            eq(performanceEntries.isRemoved, false),
+            eq(hardwareTable.deviceType, "handheld"),
+            sql`${performanceEntries.tdpWatts} IS NOT NULL AND ${performanceEntries.tdpWatts} > 0`,
+            sql`${hardwareTable.wattHours} IS NOT NULL`,
+          ),
+        )
+        .orderBy(desc(performanceEntries.fpsAvg))
+
+      // Deduplicate — keep only the first (best fps) entry per game
+      const seenGames = new Set<string>()
+      for (const row of batteryStats) {
+        if (!seenGames.has(row.gameId)) {
+          seenGames.add(row.gameId)
+          batteryMinMap.set(row.gameId, row.estimatedBatteryMin)
+        }
+      }
+    }
+
     // ── 2c. Latest version ──────────────────────────────────────────
     const latestVersionMap = new Map<string, string>()
 
@@ -432,6 +469,7 @@ export const searchUnifiedRoutes = new Elysia({ prefix: "/search" }).get(
         isRawPerformer: rawPerformerMap.get(g.id) ?? false,
         isPoorPerformance: poorPerformerMap.get(g.id) ?? false,
         bestFps: bestFpsMap.get(g.id) ?? null,
+        estimatedBatteryMin: batteryMinMap.get(g.id) ?? null,
         latestVersion: latestVersionMap.get(g.id) ?? null,
         playabilityStatus: g.playabilityStatus,
         steamReviewScore: g.steamReviewScore,