Preserve partial creation replies on stream failure

src/services/square-hole-runtime/index.ts

@@ -0,0 +1,9 @@
+export {
+  dropSquareHoleShape,
+  finishSquareHoleTimeUp,
+  getSquareHoleRun,
+  restartSquareHoleRun,
+  squareHoleRuntimeClient,
+  startSquareHoleRun,
+  stopSquareHoleRun,
+} from './squareHoleRuntimeClient';

src/services/square-hole-runtime/squareHoleRuntimeClient.ts

@@ -0,0 +1,123 @@
+import type {
+  DropSquareHoleShapeRequest,
+  SquareHoleDropResponse,
+  SquareHoleRunResponse,
+  StopSquareHoleRunRequest,
+} from '../../../packages/shared/src/contracts/squareHoleRuntime';
+import { type ApiRetryOptions, requestJson } from '../apiClient';
+
+const SQUARE_HOLE_RUNTIME_READ_RETRY: ApiRetryOptions = {
+  maxRetries: 1,
+  baseDelayMs: 120,
+  maxDelayMs: 360,
+};
+const SQUARE_HOLE_RUNTIME_WRITE_RETRY: ApiRetryOptions = {
+  maxRetries: 1,
+  baseDelayMs: 120,
+  maxDelayMs: 360,
+  retryUnsafeMethods: true,
+};
+
+/**
+ * 基于作品启动一局方洞挑战正式 run。
+ */
+export function startSquareHoleRun(profileId: string) {
+  return requestJson<SquareHoleRunResponse>(
+    `/api/runtime/square-hole/works/${encodeURIComponent(profileId)}/runs`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ profileId }),
+    },
+    '启动方洞挑战失败',
+    { retry: SQUARE_HOLE_RUNTIME_WRITE_RETRY },
+  );
+}
+
+/**
+ * 读取方洞挑战运行态快照。
+ */
+export function getSquareHoleRun(runId: string) {
+  return requestJson<SquareHoleRunResponse>(
+    `/api/runtime/square-hole/runs/${encodeURIComponent(runId)}`,
+    { method: 'GET' },
+    '读取方洞挑战运行快照失败',
+    { retry: SQUARE_HOLE_RUNTIME_READ_RETRY },
+  );
+}
+
+/**
+ * 提交一次洞口选择，由后端做权威确认。
+ */
+export function dropSquareHoleShape(
+  runId: string,
+  payload: DropSquareHoleShapeRequest,
+) {
+  return requestJson<SquareHoleDropResponse>(
+    `/api/runtime/square-hole/runs/${encodeURIComponent(runId)}/drop`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        ...payload,
+        runId: payload.runId ?? runId,
+      }),
+    },
+    '确认方洞挑战投入失败',
+    { retry: SQUARE_HOLE_RUNTIME_WRITE_RETRY },
+  );
+}
+
+/**
+ * 停止当前方洞挑战运行态。
+ */
+export function stopSquareHoleRun(
+  runId: string,
+  payload: StopSquareHoleRunRequest = {
+    clientActionId: `square-hole-stop-${Date.now()}`,
+  },
+) {
+  return requestJson<SquareHoleRunResponse>(
+    `/api/runtime/square-hole/runs/${encodeURIComponent(runId)}/stop`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    },
+    '停止方洞挑战失败',
+    { retry: SQUARE_HOLE_RUNTIME_WRITE_RETRY },
+  );
+}
+
+/**
+ * 基于当前 run 重开一局。
+ */
+export function restartSquareHoleRun(runId: string) {
+  return requestJson<SquareHoleRunResponse>(
+    `/api/runtime/square-hole/runs/${encodeURIComponent(runId)}/restart`,
+    { method: 'POST' },
+    '重新开始方洞挑战失败',
+    { retry: SQUARE_HOLE_RUNTIME_WRITE_RETRY },
+  );
+}
+
+/**
+ * 前端倒计时归零后通知后端确认失败状态。
+ */
+export function finishSquareHoleTimeUp(runId: string) {
+  return requestJson<SquareHoleRunResponse>(
+    `/api/runtime/square-hole/runs/${encodeURIComponent(runId)}/time-up`,
+    { method: 'POST' },
+    '同步方洞挑战倒计时失败',
+    { retry: SQUARE_HOLE_RUNTIME_WRITE_RETRY },
+  );
+}
+
+export const squareHoleRuntimeClient = {
+  dropShape: dropSquareHoleShape,
+  finishTimeUp: finishSquareHoleTimeUp,
+  getRun: getSquareHoleRun,
+  restartRun: restartSquareHoleRun,
+  startRun: startSquareHoleRun,
+  stopRun: stopSquareHoleRun,
+};