11

src/services/storageService.ts

@@ -1,6 +1,4 @@
-import type {
-  ListCustomWorldWorksResponse,
-} from '../../packages/shared/src/contracts/customWorldAgent';
+import type { ListCustomWorldWorksResponse } from '../../packages/shared/src/contracts/customWorldAgent';
 import type {
   BasicOkResult,
   CustomWorldGalleryDetailResponse,
@@ -8,15 +6,20 @@ import type {
   CustomWorldLibraryEntry,
   CustomWorldLibraryMutationResponse,
   CustomWorldLibraryResponse,
+  PlatformBrowseHistoryBatchSyncRequest,
+  PlatformBrowseHistoryEntry,
+  PlatformBrowseHistoryResponse,
+  PlatformBrowseHistoryWriteEntry,
+  ProfileDashboardSummary,
+  ProfilePlayStatsResponse,
+  ProfileWalletLedgerResponse,
   RuntimeSettings,
 } from '../../packages/shared/src/contracts/runtime';
-import type {
-  SavedGameSnapshotInput,
-} from '../persistence/gameSaveStorage';
+import type { SavedGameSnapshotInput } from '../persistence/gameSaveStorage';
 import { rehydrateSavedSnapshot } from '../persistence/runtimeSnapshot';
 import type { HydratedSavedGameSnapshot } from '../persistence/runtimeSnapshotTypes';
 import type { CustomWorldProfile } from '../types';
-import { type ApiRetryOptions,requestJson } from './apiClient';
+import { type ApiRetryOptions, requestJson } from './apiClient';
 
 const RUNTIME_API_BASE = '/api/runtime';
 const RUNTIME_READ_RETRY: ApiRetryOptions = {
@@ -58,6 +61,28 @@ function requestRuntimeJson<T>(
   );
 }
 
+function requestProfileJson<T>(
+  path: string,
+  init: RequestInit,
+  fallbackMessage: string,
+  options: RuntimeRequestOptions = {},
+) {
+  const method = (init.method ?? 'GET').toUpperCase();
+  const retry =
+    options.retry ??
+    (method === 'GET' ? RUNTIME_READ_RETRY : RUNTIME_WRITE_RETRY);
+
+  return requestJson<T>(
+    `/api/profile${path}`,
+    {
+      ...init,
+      signal: options.signal,
+    },
+    fallbackMessage,
+    { retry },
+  );
+}
+
 export async function getSaveSnapshot(options: RuntimeRequestOptions = {}) {
   const snapshot = await requestRuntimeJson<HydratedSavedGameSnapshot | null>(
     '/save/snapshot',
@@ -105,6 +130,35 @@ export async function getSettings(options: RuntimeRequestOptions = {}) {
   );
 }
 
+export async function getProfileDashboard(options: RuntimeRequestOptions = {}) {
+  return requestRuntimeJson<ProfileDashboardSummary>(
+    '/profile/dashboard',
+    { method: 'GET' },
+    '读取个人看板失败',
+    options,
+  );
+}
+
+export async function getProfileWalletLedger(
+  options: RuntimeRequestOptions = {},
+) {
+  return requestRuntimeJson<ProfileWalletLedgerResponse>(
+    '/profile/wallet-ledger',
+    { method: 'GET' },
+    '读取资产流水失败',
+    options,
+  );
+}
+
+export async function getProfilePlayStats(options: RuntimeRequestOptions = {}) {
+  return requestRuntimeJson<ProfilePlayStatsResponse>(
+    '/profile/play-stats',
+    { method: 'GET' },
+    '读取游玩统计失败',
+    options,
+  );
+}
+
 export async function putSettings(
   settings: RuntimeSettings,
   options: RuntimeRequestOptions = {},
@@ -121,8 +175,12 @@ export async function putSettings(
   );
 }
 
-export async function listCustomWorldLibrary(options: RuntimeRequestOptions = {}) {
-  const response = await requestRuntimeJson<CustomWorldLibraryResponse<CustomWorldProfile>>(
+export async function listCustomWorldLibrary(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestRuntimeJson<
+    CustomWorldLibraryResponse<CustomWorldProfile>
+  >(
     '/custom-world-library',
     { method: 'GET' },
     '读取自定义世界库失败',
@@ -132,7 +190,9 @@ export async function listCustomWorldLibrary(options: RuntimeRequestOptions = {}
   return Array.isArray(response?.entries) ? response.entries : [];
 }
 
-export async function listCustomWorldWorks(options: RuntimeRequestOptions = {}) {
+export async function listCustomWorldWorks(
+  options: RuntimeRequestOptions = {},
+) {
   const response = await requestRuntimeJson<ListCustomWorldWorksResponse>(
     '/custom-world/works',
     { method: 'GET' },
@@ -147,7 +207,9 @@ export async function upsertCustomWorldProfile(
   profile: CustomWorldProfile,
   options: RuntimeRequestOptions = {},
 ) {
-  const response = await requestRuntimeJson<CustomWorldLibraryMutationResponse<CustomWorldProfile>>(
+  const response = await requestRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
     `/custom-world-library/${encodeURIComponent(profile.id)}`,
     {
       method: 'PUT',
@@ -170,7 +232,9 @@ export async function deleteCustomWorldProfile(
   profileId: string,
   options: RuntimeRequestOptions = {},
 ) {
-  const response = await requestRuntimeJson<CustomWorldLibraryResponse<CustomWorldProfile>>(
+  const response = await requestRuntimeJson<
+    CustomWorldLibraryResponse<CustomWorldProfile>
+  >(
     `/custom-world-library/${encodeURIComponent(profileId)}`,
     { method: 'DELETE' },
     '删除自定义世界失败',
@@ -184,7 +248,9 @@ export async function publishCustomWorldProfile(
   profileId: string,
   options: RuntimeRequestOptions = {},
 ) {
-  const response = await requestRuntimeJson<CustomWorldLibraryMutationResponse<CustomWorldProfile>>(
+  const response = await requestRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
     `/custom-world-library/${encodeURIComponent(profileId)}/publish`,
     { method: 'POST' },
     '发布自定义世界失败',
@@ -201,7 +267,9 @@ export async function unpublishCustomWorldProfile(
   profileId: string,
   options: RuntimeRequestOptions = {},
 ) {
-  const response = await requestRuntimeJson<CustomWorldLibraryMutationResponse<CustomWorldProfile>>(
+  const response = await requestRuntimeJson<
+    CustomWorldLibraryMutationResponse<CustomWorldProfile>
+  >(
     `/custom-world-library/${encodeURIComponent(profileId)}/unpublish`,
     { method: 'POST' },
     '下架自定义世界失败',
@@ -214,7 +282,9 @@ export async function unpublishCustomWorldProfile(
   };
 }
 
-export async function listCustomWorldGallery(options: RuntimeRequestOptions = {}) {
+export async function listCustomWorldGallery(
+  options: RuntimeRequestOptions = {},
+) {
   const response = await requestRuntimeJson<CustomWorldGalleryResponse>(
     '/custom-world-gallery',
     { method: 'GET' },
@@ -230,7 +300,9 @@ export async function getCustomWorldGalleryDetail(
   profileId: string,
   options: RuntimeRequestOptions = {},
 ) {
-  const response = await requestRuntimeJson<CustomWorldGalleryDetailResponse<CustomWorldProfile>>(
+  const response = await requestRuntimeJson<
+    CustomWorldGalleryDetailResponse<CustomWorldProfile>
+  >(
     `/custom-world-gallery/${encodeURIComponent(ownerUserId)}/${encodeURIComponent(profileId)}`,
     { method: 'GET' },
     '读取作品详情失败',
@@ -240,12 +312,79 @@ export async function getCustomWorldGalleryDetail(
   return response.entry;
 }
 
+export async function listProfileBrowseHistory(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestProfileJson<PlatformBrowseHistoryResponse>(
+    '/browse-history',
+    { method: 'GET' },
+    '读取浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function upsertProfileBrowseHistory(
+  entry: PlatformBrowseHistoryWriteEntry,
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestProfileJson<PlatformBrowseHistoryResponse>(
+    '/browse-history',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(entry),
+    },
+    '写入浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function syncProfileBrowseHistory(
+  entries: PlatformBrowseHistoryWriteEntry[],
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestProfileJson<PlatformBrowseHistoryResponse>(
+    '/browse-history',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        entries,
+      } satisfies PlatformBrowseHistoryBatchSyncRequest),
+    },
+    '同步浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
+export async function clearProfileBrowseHistory(
+  options: RuntimeRequestOptions = {},
+) {
+  const response = await requestProfileJson<PlatformBrowseHistoryResponse>(
+    '/browse-history',
+    { method: 'DELETE' },
+    '清空浏览历史失败',
+    options,
+  );
+
+  return Array.isArray(response?.entries) ? response.entries : [];
+}
+
 export const runtimeStorageClient = {
   getSaveSnapshot,
   putSaveSnapshot,
   deleteSaveSnapshot,
   getSettings,
   putSettings,
+  getProfileDashboard,
+  getProfileWalletLedger,
+  getProfilePlayStats,
   listCustomWorldLibrary,
   listCustomWorldWorks,
   upsertCustomWorldProfile,
@@ -254,6 +393,11 @@ export const runtimeStorageClient = {
   unpublishCustomWorldProfile,
   listCustomWorldGallery,
   getCustomWorldGalleryDetail,
+  listProfileBrowseHistory,
+  upsertProfileBrowseHistory,
+  syncProfileBrowseHistory,
+  clearProfileBrowseHistory,
 };
 
 export type { CustomWorldLibraryEntry };
+export type { PlatformBrowseHistoryEntry };