Add TTL cache for game version/loader APIs and enrich upload metadata

src/lib/curseforge/game.ts

@@ -5,31 +5,36 @@ import {
   type GameVersionType,
   type GameVersion,
 } from "@/types";
+import { createTtlCache } from "@/lib/utils/cache";
+
+const TTL = 3_600_000; // 1 hour
 
 /**
- * 获取 CurseForge 支持的 Game Version Type 列表。
+ * 获取 CurseForge 支持的 Game Version Type 列表（1h 缓存）。
  * GET /api/game/version-types
  */
-export async function getVersionTypes(
-  client: CurseForgeClient,
-): Promise<GameVersionType[]> {
-  const data = await client.uploadGet<unknown[]>(
-    "/api/game/version-types",
-  );
-  return GameVersionTypeSchema.array().parse(data);
-}
+export const getVersionTypes = createTtlCache(
+  async (client: CurseForgeClient): Promise<GameVersionType[]> => {
+    const data = await client.uploadGet<unknown[]>(
+      "/api/game/version-types",
+    );
+    return GameVersionTypeSchema.array().parse(data);
+  },
+  TTL,
+);
 
 /**
- * 获取 CurseForge 支持的 Game Version 列表。
+ * 获取 CurseForge 支持的 Game Version 列表（1h 缓存）。
  * 包含 Minecraft 版本、Mod Loader、Environment、Java 等。
  * 通过 gameVersionTypeID 区分类型。
  * GET /api/game/versions
  */
-export async function getGameVersions(
-  client: CurseForgeClient,
-): Promise<GameVersion[]> {
-  const data = await client.uploadGet<unknown[]>(
-    "/api/game/versions",
-  );
-  return GameVersionSchema.array().parse(data);
-}
+export const getGameVersions = createTtlCache(
+  async (client: CurseForgeClient): Promise<GameVersion[]> => {
+    const data = await client.uploadGet<unknown[]>(
+      "/api/game/versions",
+    );
+    return GameVersionSchema.array().parse(data);
+  },
+  TTL,
+);

src/lib/modrinth/tag.ts

@@ -5,25 +5,30 @@ import {
   type LoaderTag,
   type GameVersionTag,
 } from "@/types";
+import { createTtlCache } from "@/lib/utils/cache";
+
+const TTL = 3_600_000; // 1 hour
 
 /**
- * 获取 Modrinth 支持的全部模组加载器列表。
+ * 获取 Modrinth 支持的全部模组加载器列表（1h 缓存）。
  * GET /tag/loader
  */
-export async function getLoaders(
-  client: ModrinthClient,
-): Promise<LoaderTag[]> {
-  const data = await client.get<unknown[]>("/tag/loader");
-  return LoaderTagSchema.array().parse(data);
-}
+export const getLoaders = createTtlCache(
+  async (client: ModrinthClient): Promise<LoaderTag[]> => {
+    const data = await client.get<unknown[]>("/tag/loader");
+    return LoaderTagSchema.array().parse(data);
+  },
+  TTL,
+);
 
 /**
- * 获取 Modrinth 支持的全部 Minecraft 版本列表。
+ * 获取 Modrinth 支持的全部 Minecraft 版本列表（1h 缓存）。
  * GET /tag/game_version
  */
-export async function getGameVersions(
-  client: ModrinthClient,
-): Promise<GameVersionTag[]> {
-  const data = await client.get<unknown[]>("/tag/game_version");
-  return GameVersionTagSchema.array().parse(data);
-}
+export const getGameVersions = createTtlCache(
+  async (client: ModrinthClient): Promise<GameVersionTag[]> => {
+    const data = await client.get<unknown[]>("/tag/game_version");
+    return GameVersionTagSchema.array().parse(data);
+  },
+  TTL,
+);

src/lib/utils/cache.ts

@@ -0,0 +1,16 @@
+export function createTtlCache<T>(
+  factory: (...args: any[]) => Promise<T>,
+  ttlMs: number,
+  keyFn?: (...args: any[]) => string,
+): (...args: any[]) => Promise<T> {
+  const cache = new Map<string, { data: T; ts: number }>();
+
+  return async (...args) => {
+    const key = keyFn ? keyFn(...args) : "_";
+    const entry = cache.get(key);
+    if (entry && Date.now() - entry.ts < ttlMs) return entry.data;
+    const data = await factory(...args);
+    cache.set(key, { data, ts: Date.now() });
+    return data;
+  };
+}

src/services/platforms/curseforge.ts

@@ -1,5 +1,5 @@
 import { curseforgeClient } from "@/services/clients";
-import { uploadFile } from "@/lib/curseforge";
+import { uploadFile, getGameVersions } from "@/lib/curseforge";
 import { resolveVersionName, buildJarPath } from "@/lib/utils/format";
 import { readJarBlob } from "@/lib/utils/file";
 import type { UploadMetadata } from "@/types";
@@ -26,11 +26,24 @@ export async function publishCurseForgeVersion(
 
   const primaryBlob = readJarBlob(primaryPath);
 
+  const gameVersions = await getGameVersions(curseforgeClient);
+
+  const resolveId = (name: string): number => {
+    const found = gameVersions.find((v) => v.name === name);
+    if (!found) throw new Error(`Game version "${name}" not found in CurseForge`);
+    return found.id;
+  };
+
   const metadata: UploadMetadata = {
     changelog: input.changelog,
     changelogType: "markdown",
     displayName,
     releaseType: input.versionType,
+    gameVersions: [
+      resolveId(mcVersion),
+      ...config.curseforge.loaders.map(resolveId),
+      ...config.curseforge.environment.map(resolveId),
+    ],
     relations: config.curseforge.relations,
   };
 

src/services/platforms/modrinth.ts

@@ -47,6 +47,7 @@ export async function publishModrinthVersion(
     project_id: config.modrinth.project_id,
     name: versionName,
     version_number: versionNumber,
+    changelog: input.changelog,
     game_versions: [mcVersion],
     version_type: input.versionType,
     loaders: config.modrinth.loaders,