refactor: 收口 runtime client 请求骨架

src/services/match3d-runtime/match3dRuntimeClient.ts

@@ -10,14 +10,11 @@ import type {
 } from '../../../packages/shared/src/contracts/match3dRuntime';
 import {
   type ApiRetryOptions,
-  requestJson,
 } from '../apiClient';
-import {
-  buildRuntimeGuestAuthOptions,
-  buildRuntimeGuestHeaders,
-  type RuntimeGuestRequestOptions,
-} from '../runtimeGuestAuth';
+import { type RuntimeGuestRequestOptions } from '../runtimeGuestAuth';
+import { buildRuntimeApiPath, requestRuntimeJson } from '../runtimeRequest';
 
+const MATCH3D_RUNTIME_API_BASE = '/api/runtime/match3d';
 const MATCH3D_RUNTIME_READ_RETRY: ApiRetryOptions = {
   maxRetries: 1,
   baseDelayMs: 120,
@@ -74,39 +71,30 @@ export function startMatch3DRun(
   profileId: string,
   options: Match3DRuntimeRequestOptions = {},
 ) {
-  const requestOptions = buildRuntimeGuestAuthOptions(options);
   const payload: StartMatch3DRunRequest = {
     profileId,
     itemTypeCountOverride: options.itemTypeCountOverride ?? null,
   };
 
-  return requestJson<Match3DRunResponse>(
-    `/api/runtime/match3d/works/${encodeURIComponent(profileId)}/runs`,
-    {
-      method: 'POST',
-      headers: buildRuntimeGuestHeaders(options, {
-        'Content-Type': 'application/json',
-      }),
-      body: JSON.stringify(payload),
-    },
-    '启动抓大鹅玩法失败',
-    {
-      retry: MATCH3D_RUNTIME_WRITE_RETRY,
-      ...requestOptions,
-    },
-  );
+  return requestRuntimeJson<Match3DRunResponse>({
+    url: buildRuntimeApiPath(MATCH3D_RUNTIME_API_BASE, 'works', profileId, 'runs'),
+    method: 'POST',
+    jsonBody: payload,
+    fallbackMessage: '启动抓大鹅玩法失败',
+    retry: MATCH3D_RUNTIME_WRITE_RETRY,
+    requestOptions: options,
+  });
 }
 
 /**
  * 读取抓大鹅运行态快照。
  */
 export function getMatch3DRun(runId: string) {
-  return requestJson<Match3DRunResponse>(
-    `/api/runtime/match3d/runs/${encodeURIComponent(runId)}`,
-    { method: 'GET' },
-    '读取抓大鹅运行快照失败',
-    { retry: MATCH3D_RUNTIME_READ_RETRY },
-  );
+  return requestRuntimeJson<Match3DRunResponse>({
+    url: buildRuntimeApiPath(MATCH3D_RUNTIME_API_BASE, 'runs', runId),
+    fallbackMessage: '读取抓大鹅运行快照失败',
+    retry: MATCH3D_RUNTIME_READ_RETRY,
+  });
 }
 
 /**
@@ -116,19 +104,16 @@ export async function clickMatch3DItem(
   runId: string,
   payload: Match3DClickItemRequest,
 ) {
-  const response = await requestJson<Match3DClickResponse>(
-    `/api/runtime/match3d/runs/${encodeURIComponent(runId)}/click`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        ...payload,
-        runId: payload.runId ?? runId,
-      }),
+  const response = await requestRuntimeJson<Match3DClickResponse>({
+    url: buildRuntimeApiPath(MATCH3D_RUNTIME_API_BASE, 'runs', runId, 'click'),
+    method: 'POST',
+    jsonBody: {
+      ...payload,
+      runId: payload.runId ?? runId,
     },
-    '确认抓大鹅点击失败',
-    { retry: MATCH3D_RUNTIME_WRITE_RETRY },
-  );
+    fallbackMessage: '确认抓大鹅点击失败',
+    retry: MATCH3D_RUNTIME_WRITE_RETRY,
+  });
 
   return mapClickConfirmation(payload, response.confirmation);
 }
@@ -142,40 +127,37 @@ export function stopMatch3DRun(
     clientActionId: `match3d-stop-${Date.now()}`,
   },
 ) {
-  return requestJson<Match3DRunResponse>(
-    `/api/runtime/match3d/runs/${encodeURIComponent(runId)}/stop`,
-    {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    },
-    '停止抓大鹅玩法失败',
-    { retry: MATCH3D_RUNTIME_WRITE_RETRY },
-  );
+  return requestRuntimeJson<Match3DRunResponse>({
+    url: buildRuntimeApiPath(MATCH3D_RUNTIME_API_BASE, 'runs', runId, 'stop'),
+    method: 'POST',
+    jsonBody: payload,
+    fallbackMessage: '停止抓大鹅玩法失败',
+    retry: MATCH3D_RUNTIME_WRITE_RETRY,
+  });
 }
 
 /**
  * 基于当前 run 重开一局。
  */
 export function restartMatch3DRun(runId: string) {
-  return requestJson<Match3DRunResponse>(
-    `/api/runtime/match3d/runs/${encodeURIComponent(runId)}/restart`,
-    { method: 'POST' },
-    '重新开始抓大鹅玩法失败',
-    { retry: MATCH3D_RUNTIME_WRITE_RETRY },
-  );
+  return requestRuntimeJson<Match3DRunResponse>({
+    url: buildRuntimeApiPath(MATCH3D_RUNTIME_API_BASE, 'runs', runId, 'restart'),
+    method: 'POST',
+    fallbackMessage: '重新开始抓大鹅玩法失败',
+    retry: MATCH3D_RUNTIME_WRITE_RETRY,
+  });
 }
 
 /**
  * 前端倒计时归零后通知后端确认失败状态。
  */
 export function finishMatch3DTimeUp(runId: string) {
-  return requestJson<Match3DRunResponse>(
-    `/api/runtime/match3d/runs/${encodeURIComponent(runId)}/time-up`,
-    { method: 'POST' },
-    '同步抓大鹅倒计时失败',
-    { retry: MATCH3D_RUNTIME_WRITE_RETRY },
-  );
+  return requestRuntimeJson<Match3DRunResponse>({
+    url: buildRuntimeApiPath(MATCH3D_RUNTIME_API_BASE, 'runs', runId, 'time-up'),
+    method: 'POST',
+    fallbackMessage: '同步抓大鹅倒计时失败',
+    retry: MATCH3D_RUNTIME_WRITE_RETRY,
+  });
 }
 
 export const match3dRuntimeClient = {