feat: utilize edge-type fetching information for workers

Author: darbyjack

AGENTS.md

@@ -1 +1 @@
-README.md
+README.md

bun.lock

@@ -30,6 +30,7 @@
     "typescript": "^5.9.3"
   },
   "devDependencies": {
+    "@cloudflare/workers-types": "^4.20251011.0",
     "@types/node": "^24.8.1",
     "@typescript-eslint/eslint-plugin": "^8.46.1",
     "@typescript-eslint/parser": "^8.46.1",

package.json

@@ -3,32 +3,36 @@ import type { Build, Project } from "@/utils/types";
 const API_ENDPOINT = "https://fill.papermc.io/v3";
 const BSTATS_URL = "https://bstats.org/api/v1/plugins/580/charts/players/data/?maxElements=1";
 
-export async function getProject(project: string): Promise<Project> {
-  const res = await fetch(`${API_ENDPOINT}/projects/${project}`);
+const edgeFetch = (url: string, ttlSeconds = 300): Promise<Response> => {
+  return fetch(url, {
+    cf: {
+      cacheTtl: ttlSeconds,
+      cacheEverything: true,
+    },
+  });
+};
 
+export async function getProject(project: string): Promise<Project> {
+  const res = await edgeFetch(`${API_ENDPOINT}/projects/${project}`, 600);
   if (!res.ok) {
     throw new Error(`getProject(${project}) failed: ${res.status}`);
   }
-  return res.json();
+  return res.json() as Promise<Project>;
 }
 
 export async function getVersionBuilds(project: string, version: string): Promise<Build[]> {
-  const res = await fetch(`${API_ENDPOINT}/projects/${project}/versions/${version}/builds`);
-
+  const res = await edgeFetch(`${API_ENDPOINT}/projects/${project}/versions/${version}/builds`, 300);
   if (!res.ok) {
     throw new Error(`getVersionBuilds(${project}, ${version}) failed: ${res.status}`);
   }
-  return res.json();
+  return res.json() as Promise<Build[]>;
 }
 
-export async function getBStats(): Promise<{
-  servers: number;
-  players: number;
-}> {
+export async function getBStats(): Promise<{ servers: number; players: number }> {
   try {
-    const response = await fetch(BSTATS_URL);
-    const data = await response.json();
-    const players = data[0]?.[1] || 0;
+    const res = await edgeFetch(BSTATS_URL, 300);
+    const data = (await res.json()) as Array<[number, number]> | null | undefined;
+    const players = data?.[0]?.[1] ?? 0;
     return { servers: Math.round(players / 20), players };
   } catch (error) {
     console.error("Failed to fetch bStats:", error);

src/utils/fill.ts

@@ -6,6 +6,7 @@
     "paths": {
       "*": ["./*"],
       "@/*": ["./src/*"]
-    }
+    },
+    "types": ["@cloudflare/workers-types"]
   }
 }