1

src/services/puzzle-runtime/puzzleRuntimeClient.ts

@@ -5,6 +5,8 @@ import type {
   StartPuzzleRunRequest,
   SubmitPuzzleLeaderboardRequest,
   SwapPuzzlePiecesRequest,
+  UpdatePuzzleRuntimePauseRequest,
+  UsePuzzleRuntimePropRequest,
 } from '../../../packages/shared/src/contracts/puzzleRuntimeSession';
 import { type ApiRetryOptions, requestJson } from '../apiClient';
 
@@ -134,6 +136,48 @@ export async function submitPuzzleLeaderboard(
   );
 }
 
+/**
+ * 暂停或恢复正式拼图运行态计时。
+ */
+export async function updatePuzzleRunPause(
+  runId: string,
+  payload: UpdatePuzzleRuntimePauseRequest,
+) {
+  return requestJson<PuzzleRunResponse>(
+    `${PUZZLE_RUNTIME_API_BASE}/${encodeURIComponent(runId)}/pause`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '更新拼图计时状态失败',
+    {
+      retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    },
+  );
+}
+
+/**
+ * 使用正式拼图道具，服务端负责扣除陶泥币并更新运行态。
+ */
+export async function usePuzzleRuntimeProp(
+  runId: string,
+  payload: UsePuzzleRuntimePropRequest,
+) {
+  return requestJson<PuzzleRunResponse>(
+    `${PUZZLE_RUNTIME_API_BASE}/${encodeURIComponent(runId)}/props`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '使用拼图道具失败',
+    {
+      retry: PUZZLE_RUNTIME_WRITE_RETRY,
+    },
+  );
+}
+
 /**
  * 单机运行态进入下一关，图片来源选择全部由后端裁决。
  */
@@ -162,4 +206,6 @@ export const puzzleRuntimeClient = {
   submitLeaderboard: submitPuzzleLeaderboard,
   startRun: startPuzzleRun,
   swap: swapPuzzlePieces,
+  updatePause: updatePuzzleRunPause,
+  useProp: usePuzzleRuntimeProp,
 };