/** * 认证服务(规范 §131 services 层 / API_INVENTORY 认证域) * * 仅封装 auth/wechat/login、auth/phone/bind、auth/refresh、auth/logout 四个端点。 * Token 持久化、Session 失效回调由 utils/api.js 统一处理;本层不读写本地存储。 * 刷新 Token 在 401 自动重试由 AuthStore 协调(单飞锁),见 stores/authStore。 */ const api = require('../utils/api'); /** * 微信登录(API_INVENTORY 行 8) * @param {{ code: string }} payload wx.login 拿到的 code * @returns {Promise<{ accessToken: string, refreshToken: string, expiresIn: number, * userId: string, isNewUser: boolean }>} * 注意是 accessToken(不是 token)、isNewUser(不是 needPhone/needProfile)—— * 这两处字段名此前都写错,导致 token 落空与「误判已绑手机号」,见 authStore。 */ function wechatLogin(payload) { return api.post('/auth/wechat/login', payload, undefined, payload.code); } /** * 绑定手机号(API_INVENTORY 行 9) * @param {{ phoneCode: string }} payload wx.getPhoneNumber 拿到的 encryptedData/iv 或 phoneCode * @returns {Promise<{ bound: true }>} */ function bindPhone(payload) { return api.post('/auth/phone/bind', payload, undefined, payload.phoneCode || payload.encryptedData); } /** * 刷新 Token(API_INVENTORY 行 10) * 后端 /auth/refresh 只强制要求 refreshToken(userId 由令牌 subject 自证身份); * 这里仍传 userId,让后端校验它与令牌主体一致 —— 串号时能被提前拦下。 * @param {string} userId 当前登录用户 ID(来自 AuthStore.state.userId) * @returns {Promise<{ accessToken: string, refreshToken: string, expiresIn: number }>} */ function refresh(userId) { const refreshToken = api.getRefreshToken(); return api.post('/auth/refresh', { userId, refreshToken }); } /** * 登出(API_INVENTORY 行 11) * 幂等:键由 api 层托管,网络异常重试时复用同一把,避免后端重复记账。 * @returns {Promise} */ function logout() { return api.post('/auth/logout', {}, undefined, api.idempotencyKey('logout')); } module.exports = { wechatLogin, bindPhone, refresh, logout, };