backendApi.ts 9.1 KB

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