1

src/services/puzzle-runtime/puzzleRuntimeClient.ts

@@ -3,6 +3,7 @@ import type {
   DragPuzzlePieceRequest,
   PuzzleRunResponse,
   StartPuzzleRunRequest,
+  SubmitPuzzleLeaderboardRequest,
   SwapPuzzlePiecesRequest,
 } from '../../../packages/shared/src/contracts/puzzleRuntimeSession';
 import { type ApiRetryOptions, requestJson } from '../apiClient';
@@ -112,6 +113,27 @@ export async function advancePuzzleNextLevel(runId: string) {
   );
 }
 
+/**
+ * 提交通关成绩并读取真实排行榜。
+ */
+export async function submitPuzzleLeaderboard(
+  runId: string,
+  payload: SubmitPuzzleLeaderboardRequest,
+) {
+  return requestJson<PuzzleRunResponse>(
+    `${PUZZLE_RUNTIME_API_BASE}/${encodeURIComponent(runId)}/leaderboard`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '提交拼图排行榜失败',
+    {
+      retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    },
+  );
+}
+
 /**
  * 单机运行态进入下一关，图片来源选择全部由后端裁决。
  */
@@ -137,6 +159,7 @@ export const puzzleRuntimeClient = {
   advanceNextLevel: advancePuzzleNextLevel,
   drag: dragPuzzlePieceOrGroup,
   getRun: getPuzzleRun,
+  submitLeaderboard: submitPuzzleLeaderboard,
   startRun: startPuzzleRun,
   swap: swapPuzzlePieces,
 };