backendApi.ts 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430
  1. import { normalizeBackendBaseUrl } from './backendAuth'
  2. export interface BackendApiError {
  3. statusCode: number
  4. code: string
  5. message: string
  6. details?: unknown
  7. }
  8. export interface BackendAuthLoginResult {
  9. user?: {
  10. id?: string
  11. nickname?: string
  12. avatarUrl?: string
  13. }
  14. tokens: {
  15. accessToken: string
  16. refreshToken: string
  17. }
  18. }
  19. export interface BackendResolvedRelease {
  20. launchMode: string
  21. source: string
  22. eventId: string
  23. releaseId: string
  24. configLabel: string
  25. manifestUrl: string
  26. manifestChecksumSha256?: string | null
  27. routeCode?: string | null
  28. }
  29. export interface BackendCourseVariantSummary {
  30. id: string
  31. name: string
  32. description?: string | null
  33. routeCode?: string | null
  34. selectable?: boolean
  35. }
  36. export interface BackendLaunchVariantSummary {
  37. id: string
  38. name: string
  39. routeCode?: string | null
  40. assignmentMode?: string | null
  41. }
  42. export interface BackendRuntimeSummary {
  43. runtimeBindingId?: string | null
  44. placeId?: string | null
  45. placeName?: string | null
  46. mapId?: string | null
  47. mapName?: string | null
  48. tileReleaseId?: string | null
  49. courseSetId?: string | null
  50. courseVariantId?: string | null
  51. routeCode?: string | null
  52. }
  53. export interface BackendPresentationSummary {
  54. presentationId?: string | null
  55. templateKey?: string | null
  56. version?: string | null
  57. }
  58. export interface BackendContentBundleSummary {
  59. bundleId?: string | null
  60. bundleType?: string | null
  61. version?: string | null
  62. }
  63. export interface BackendEntrySessionSummary {
  64. id: string
  65. status: string
  66. eventId?: string
  67. eventName?: string
  68. releaseId?: string | null
  69. configLabel?: string | null
  70. routeCode?: string | null
  71. variantId?: string | null
  72. variantName?: string | null
  73. runtime?: BackendRuntimeSummary | null
  74. launchedAt?: string | null
  75. startedAt?: string | null
  76. endedAt?: string | null
  77. // 兼容前端旧字段名,避免联调过渡期多处判断
  78. sessionId?: string
  79. sessionStatus?: string
  80. eventDisplayName?: string
  81. }
  82. export interface BackendCardResult {
  83. id: string
  84. type: string
  85. title: string
  86. subtitle?: string | null
  87. coverUrl?: string | null
  88. displaySlot: string
  89. displayPriority: number
  90. event?: {
  91. id: string
  92. displayName: string
  93. summary?: string | null
  94. } | null
  95. htmlUrl?: string | null
  96. }
  97. export interface BackendEntryHomeResult {
  98. user: {
  99. id: string
  100. publicId: string
  101. status: string
  102. nickname?: string | null
  103. avatarUrl?: string | null
  104. }
  105. tenant: {
  106. id: string
  107. code: string
  108. name: string
  109. }
  110. channel: {
  111. id: string
  112. code: string
  113. type: string
  114. platformAppId?: string | null
  115. displayName: string
  116. status: string
  117. isDefault: boolean
  118. }
  119. cards: BackendCardResult[]
  120. ongoingSession?: BackendEntrySessionSummary | null
  121. recentSession?: BackendEntrySessionSummary | null
  122. }
  123. export interface BackendEventPlayResult {
  124. event: {
  125. id: string
  126. slug: string
  127. displayName: string
  128. summary?: string | null
  129. status: string
  130. }
  131. currentPresentation?: BackendPresentationSummary | null
  132. currentContentBundle?: BackendContentBundleSummary | null
  133. release?: {
  134. id: string
  135. configLabel: string
  136. manifestUrl: string
  137. manifestChecksumSha256?: string | null
  138. routeCode?: string | null
  139. } | null
  140. resolvedRelease?: BackendResolvedRelease | null
  141. play: {
  142. canLaunch: boolean
  143. primaryAction: string
  144. reason: string
  145. launchSource?: string
  146. assignmentMode?: string | null
  147. courseVariants?: BackendCourseVariantSummary[] | null
  148. ongoingSession?: BackendEntrySessionSummary | null
  149. recentSession?: BackendEntrySessionSummary | null
  150. }
  151. }
  152. export interface BackendLaunchResult {
  153. event: {
  154. id: string
  155. displayName: string
  156. }
  157. launch: {
  158. source: string
  159. resolvedRelease?: BackendResolvedRelease | null
  160. config: {
  161. configUrl: string
  162. configLabel: string
  163. configChecksumSha256?: string | null
  164. releaseId: string
  165. routeCode?: string | null
  166. }
  167. business: {
  168. source: string
  169. eventId: string
  170. sessionId: string
  171. sessionToken: string
  172. sessionTokenExpiresAt: string
  173. routeCode?: string | null
  174. }
  175. variant?: BackendLaunchVariantSummary | null
  176. runtime?: BackendRuntimeSummary | null
  177. presentation?: BackendPresentationSummary | null
  178. contentBundle?: BackendContentBundleSummary | null
  179. }
  180. }
  181. export interface BackendSessionFinishSummaryPayload {
  182. finalDurationSec?: number
  183. finalScore?: number
  184. completedControls?: number
  185. totalControls?: number
  186. distanceMeters?: number
  187. averageSpeedKmh?: number
  188. maxHeartRateBpm?: number
  189. }
  190. export interface BackendSessionResult {
  191. session: {
  192. id: string
  193. status: string
  194. clientType: string
  195. deviceKey: string
  196. routeCode?: string | null
  197. runtime?: BackendRuntimeSummary | null
  198. sessionTokenExpiresAt: string
  199. launchedAt: string
  200. startedAt?: string | null
  201. endedAt?: string | null
  202. }
  203. event: {
  204. id: string
  205. displayName: string
  206. }
  207. resolvedRelease?: BackendResolvedRelease | null
  208. }
  209. export interface BackendSessionResultView {
  210. session: BackendEntrySessionSummary
  211. result: {
  212. status: string
  213. finalDurationSec?: number
  214. finalScore?: number
  215. completedControls?: number
  216. totalControls?: number
  217. distanceMeters?: number
  218. averageSpeedKmh?: number
  219. maxHeartRateBpm?: number
  220. summary?: Record<string, unknown>
  221. }
  222. }
  223. type BackendEnvelope<T> = {
  224. data: T
  225. }
  226. type RequestOptions = {
  227. method: 'GET' | 'POST'
  228. baseUrl: string
  229. path: string
  230. authToken?: string
  231. body?: Record<string, unknown>
  232. }
  233. function requestBackend<T>(options: RequestOptions): Promise<T> {
  234. const url = `${normalizeBackendBaseUrl(options.baseUrl)}${options.path}`
  235. const header: Record<string, string> = {}
  236. if (options.body) {
  237. header['Content-Type'] = 'application/json'
  238. }
  239. if (options.authToken) {
  240. header.Authorization = `Bearer ${options.authToken}`
  241. }
  242. return new Promise<T>((resolve, reject) => {
  243. wx.request({
  244. url,
  245. method: options.method,
  246. header,
  247. data: options.body,
  248. success: (response) => {
  249. const statusCode = typeof response.statusCode === 'number' ? response.statusCode : 0
  250. const data = response.data as BackendEnvelope<T> | { error?: { code?: string; message?: string; details?: unknown } }
  251. if (statusCode >= 200 && statusCode < 300 && data && typeof data === 'object' && 'data' in data) {
  252. resolve((data as BackendEnvelope<T>).data)
  253. return
  254. }
  255. const errorPayload = data && typeof data === 'object' && 'error' in data
  256. ? (data as { error?: { code?: string; message?: string; details?: unknown } }).error
  257. : undefined
  258. reject({
  259. statusCode,
  260. code: errorPayload && errorPayload.code ? errorPayload.code : 'backend_error',
  261. message: errorPayload && errorPayload.message ? errorPayload.message : `request failed: ${statusCode}`,
  262. details: errorPayload && errorPayload.details ? errorPayload.details : response.data,
  263. } as BackendApiError)
  264. },
  265. fail: (error) => {
  266. reject({
  267. statusCode: 0,
  268. code: 'network_error',
  269. message: error && error.errMsg ? error.errMsg : 'network request failed',
  270. } as BackendApiError)
  271. },
  272. })
  273. })
  274. }
  275. export function loginWechatMini(input: {
  276. baseUrl: string
  277. code: string
  278. deviceKey: string
  279. clientType?: string
  280. }): Promise<BackendAuthLoginResult> {
  281. return requestBackend<BackendAuthLoginResult>({
  282. method: 'POST',
  283. baseUrl: input.baseUrl,
  284. path: '/auth/login/wechat-mini',
  285. body: {
  286. code: input.code,
  287. clientType: input.clientType || 'wechat',
  288. deviceKey: input.deviceKey,
  289. },
  290. })
  291. }
  292. export function getEventPlay(input: {
  293. baseUrl: string
  294. eventId: string
  295. accessToken: string
  296. }): Promise<BackendEventPlayResult> {
  297. return requestBackend<BackendEventPlayResult>({
  298. method: 'GET',
  299. baseUrl: input.baseUrl,
  300. path: `/events/${encodeURIComponent(input.eventId)}/play`,
  301. authToken: input.accessToken,
  302. })
  303. }
  304. export function getEntryHome(input: {
  305. baseUrl: string
  306. accessToken: string
  307. channelCode: string
  308. channelType: string
  309. }): Promise<BackendEntryHomeResult> {
  310. const query = `channelCode=${encodeURIComponent(input.channelCode)}&channelType=${encodeURIComponent(input.channelType)}`
  311. return requestBackend<BackendEntryHomeResult>({
  312. method: 'GET',
  313. baseUrl: input.baseUrl,
  314. path: `/me/entry-home?${query}`,
  315. authToken: input.accessToken,
  316. })
  317. }
  318. export function launchEvent(input: {
  319. baseUrl: string
  320. eventId: string
  321. accessToken: string
  322. releaseId?: string
  323. variantId?: string
  324. clientType: string
  325. deviceKey: string
  326. }): Promise<BackendLaunchResult> {
  327. const body: Record<string, unknown> = {
  328. clientType: input.clientType,
  329. deviceKey: input.deviceKey,
  330. }
  331. if (input.releaseId) {
  332. body.releaseId = input.releaseId
  333. }
  334. if (input.variantId) {
  335. body.variantId = input.variantId
  336. }
  337. return requestBackend<BackendLaunchResult>({
  338. method: 'POST',
  339. baseUrl: input.baseUrl,
  340. path: `/events/${encodeURIComponent(input.eventId)}/launch`,
  341. authToken: input.accessToken,
  342. body,
  343. })
  344. }
  345. export function startSession(input: {
  346. baseUrl: string
  347. sessionId: string
  348. sessionToken: string
  349. }): Promise<BackendSessionResult> {
  350. return requestBackend<BackendSessionResult>({
  351. method: 'POST',
  352. baseUrl: input.baseUrl,
  353. path: `/sessions/${encodeURIComponent(input.sessionId)}/start`,
  354. body: {
  355. sessionToken: input.sessionToken,
  356. },
  357. })
  358. }
  359. export function finishSession(input: {
  360. baseUrl: string
  361. sessionId: string
  362. sessionToken: string
  363. status: 'finished' | 'failed' | 'cancelled'
  364. summary: BackendSessionFinishSummaryPayload
  365. }): Promise<BackendSessionResult> {
  366. return requestBackend<BackendSessionResult>({
  367. method: 'POST',
  368. baseUrl: input.baseUrl,
  369. path: `/sessions/${encodeURIComponent(input.sessionId)}/finish`,
  370. body: {
  371. sessionToken: input.sessionToken,
  372. status: input.status,
  373. summary: input.summary,
  374. },
  375. })
  376. }
  377. export function getSessionResult(input: {
  378. baseUrl: string
  379. accessToken: string
  380. sessionId: string
  381. }): Promise<BackendSessionResultView> {
  382. return requestBackend<BackendSessionResultView>({
  383. method: 'GET',
  384. baseUrl: input.baseUrl,
  385. path: `/sessions/${encodeURIComponent(input.sessionId)}/result`,
  386. authToken: input.accessToken,
  387. })
  388. }
  389. export function getMyResults(input: {
  390. baseUrl: string
  391. accessToken: string
  392. limit?: number
  393. }): Promise<BackendSessionResultView[]> {
  394. const limit = typeof input.limit === 'number' ? input.limit : 20
  395. return requestBackend<BackendSessionResultView[]>({
  396. method: 'GET',
  397. baseUrl: input.baseUrl,
  398. path: `/me/results?limit=${encodeURIComponent(String(limit))}`,
  399. authToken: input.accessToken,
  400. })
  401. }