Add public work read model and smooth puzzle transitions

src/services/puzzle-runtime/puzzleRuntimeClient.ts

@@ -30,6 +30,9 @@ const PUZZLE_RUNTIME_WRITE_RETRY: ApiRetryOptions = {
   maxDelayMs: 360,
   retryUnsafeMethods: true,
 };
+const PUZZLE_RUNTIME_LEADERBOARD_RETRY: ApiRetryOptions = {
+  maxRetries: 0,
+};
 type PuzzleRuntimeRequestOptions = RuntimeGuestRequestOptions;
 
 /**
@@ -125,16 +128,22 @@ export async function advancePuzzleNextLevel(
 ) {
   const requestOptions = buildRuntimeGuestAuthOptions(options);
   const targetProfileId = payload.targetProfileId?.trim() ?? '';
+  const preferSimilarWork = payload.preferSimilarWork === true;
+  const requestPayload = {
+    ...(targetProfileId ? { targetProfileId } : {}),
+    ...(preferSimilarWork ? { preferSimilarWork: true } : {}),
+  };
+  const hasRequestPayload = Object.keys(requestPayload).length > 0;
   return requestJson<PuzzleRunResponse>(
     `${PUZZLE_RUNTIME_API_BASE}/${encodeURIComponent(runId)}/next-level`,
     {
       method: 'POST',
-      ...(targetProfileId
+      ...(hasRequestPayload
         ? {
             headers: buildRuntimeGuestHeaders(options, {
               'Content-Type': 'application/json',
             }),
-            body: JSON.stringify({ targetProfileId }),
+            body: JSON.stringify(requestPayload),
           }
         : {
             headers: buildRuntimeGuestHeaders(options),
@@ -156,20 +165,20 @@ export async function submitPuzzleLeaderboard(
   payload: SubmitPuzzleLeaderboardRequest,
   options: PuzzleRuntimeRequestOptions = {},
 ) {
+  const requestOptions = buildRuntimeGuestAuthOptions(options);
   return requestJson<PuzzleRunResponse>(
     `${PUZZLE_RUNTIME_API_BASE}/${encodeURIComponent(runId)}/leaderboard`,
     {
       method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
+      headers: buildRuntimeGuestHeaders(options, {
+        'Content-Type': 'application/json',
+      }),
       body: JSON.stringify(payload),
     },
     '提交拼图排行榜失败',
     {
-      retry: PUZZLE_RUNTIME_WRITE_RETRY,
-      authImpact: options.authImpact,
-      skipRefresh: options.skipRefresh,
-      notifyAuthStateChange: options.notifyAuthStateChange,
-      clearAuthOnUnauthorized: options.clearAuthOnUnauthorized,
+      retry: PUZZLE_RUNTIME_LEADERBOARD_RETRY,
+      ...requestOptions,
     },
   );
 }

src/services/recommendedRuntimeGuestLaunch.test.ts

@@ -17,7 +17,11 @@ import { startBigFishRun } from './big-fish-runtime/bigFishRuntimeClient';
 import { startBarkBattleRun } from './bark-battle-runtime/barkBattleRuntimeClient';
 import { startJumpHopRuntimeRun } from './jump-hop/jumpHopClient';
 import { startMatch3DRun } from './match3d-runtime/match3dRuntimeClient';
-import { startPuzzleRun } from './puzzle-runtime/puzzleRuntimeClient';
+import {
+  advancePuzzleNextLevel,
+  startPuzzleRun,
+  submitPuzzleLeaderboard,
+} from './puzzle-runtime/puzzleRuntimeClient';
 import { startSquareHoleRun } from './square-hole-runtime/squareHoleRuntimeClient';
 import { startVisualNovelRun } from './visual-novel-runtime/visualNovelRuntimeClient';
 
@@ -87,6 +91,21 @@ describe('recommended runtime guest launch clients', () => {
         ),
       expectedUrl: '/api/runtime/puzzle/runs',
     },
+    {
+      name: 'puzzle leaderboard',
+      start: () =>
+        submitPuzzleLeaderboard(
+          'run-puzzle-1',
+          {
+            profileId: 'puzzle-profile-1',
+            gridSize: 3,
+            elapsedMs: 18_000,
+            nickname: '玩家',
+          },
+          { runtimeGuestToken: 'runtime-guest-token' },
+        ),
+      expectedUrl: '/api/runtime/puzzle/runs/run-puzzle-1/leaderboard',
+    },
   ])(
     '$name start request uses the runtime guest bearer token without touching login auth',
     async ({ start, expectedUrl }) => {
@@ -110,4 +129,63 @@ describe('recommended runtime guest launch clients', () => {
       );
     },
   );
+
+  it('puzzle next level can carry preferSimilarWork through the runtime guest request', async () => {
+    await advancePuzzleNextLevel(
+      'run-puzzle-1',
+      { preferSimilarWork: true },
+      { runtimeGuestToken: 'runtime-guest-token' },
+    );
+
+    const [url, init, , options] = apiClientMocks.requestJson.mock.calls[0];
+    expect(url).toBe('/api/runtime/puzzle/runs/run-puzzle-1/next-level');
+    expect(init).toEqual(
+      expect.objectContaining({
+        method: 'POST',
+        headers: expect.objectContaining({
+          Authorization: 'Bearer runtime-guest-token',
+          'Content-Type': 'application/json',
+        }),
+        body: JSON.stringify({ preferSimilarWork: true }),
+      }),
+    );
+    expect(options).toEqual(
+      expect.objectContaining({
+        skipAuth: true,
+        skipRefresh: true,
+      }),
+    );
+  });
+
+  it('puzzle leaderboard submission does not retry unsafe writes', async () => {
+    await submitPuzzleLeaderboard(
+      'run-puzzle-1',
+      {
+        profileId: 'puzzle-profile-1',
+        gridSize: 3,
+        elapsedMs: 18_000,
+        nickname: '玩家',
+      },
+      { runtimeGuestToken: 'runtime-guest-token' },
+    );
+
+    const [url, init, , options] = apiClientMocks.requestJson.mock.calls[0];
+    expect(url).toBe('/api/runtime/puzzle/runs/run-puzzle-1/leaderboard');
+    expect(init).toEqual(
+      expect.objectContaining({
+        method: 'POST',
+        headers: expect.objectContaining({
+          Authorization: 'Bearer runtime-guest-token',
+          'Content-Type': 'application/json',
+        }),
+      }),
+    );
+    expect(options).toEqual(
+      expect.objectContaining({
+        retry: expect.objectContaining({
+          maxRetries: 0,
+        }),
+      }),
+    );
+  });
 });