import 'package:json_annotation/json_annotation.dart'; import 'package:networks_sdk/networks_sdk.dart'; import '../../../core/foundation/api_paths.dart'; import '../../../domain/entities/user.dart'; part 'login_request.g.dart'; /// # /auth/login — 登录接口 /// /// ## 数据流位置 /// /// ``` /// AuthRepositoryImpl.login(email, password) /// → _client.executeRequest( ★ LoginRequest ★ ) ← 你在这里 /// → 服务端 POST /auth/login /// → 响应 JSON → ★ LoginResponse ★ ← 也在这里 /// → LoginResponse.toEntity() → User /// ``` // ───────────────────────────────────────────── // Response DTO // ───────────────────────────────────────────── @JsonSerializable(createToJson: false) class LoginProfile { final int uid; final String uuid; @JsonKey(name: 'last_online') final int lastOnline; @JsonKey(name: 'profile_pic') final String profilePic; @JsonKey(name: 'profile_pic_gaussian') final String profilePicGaussian; final String nickname; final String contact; @JsonKey(name: 'country_code') final String countryCode; final String email; @JsonKey(name: 'recovery_email') final String recoveryEmail; final String username; final String bio; final int relationship; @JsonKey(name: 'user_alias') final String? userAlias; @JsonKey(name: 'channel_id') final int channelId; @JsonKey(name: 'channel_group_id') final int channelGroupId; final String hint; const LoginProfile({ required this.uid, required this.uuid, required this.lastOnline, required this.profilePic, required this.profilePicGaussian, required this.nickname, required this.contact, required this.countryCode, required this.email, required this.recoveryEmail, required this.username, required this.bio, required this.relationship, this.userAlias, required this.channelId, required this.channelGroupId, required this.hint, }); factory LoginProfile.fromJson(Map json) => _$LoginProfileFromJson(json); User toEntity() => User( uid: uid, uuid: uuid, lastOnline: lastOnline, profilePic: profilePic, profilePicGaussian: profilePicGaussian, nickname: nickname, contact: contact, countryCode: countryCode, email: email, recoveryEmail: recoveryEmail, username: username, bio: bio, relationship: relationship, userAlias: userAlias, channelId: channelId, channelGroupId: channelGroupId, hint: hint, ); } @JsonSerializable(createToJson: false, explicitToJson: true) class LoginData { @JsonKey(name: 'account_id') final String accountId; final LoginProfile profile; final String nonce; @JsonKey(name: 'access_token') final String accessToken; @JsonKey(name: 'refresh_token') final String refreshToken; @JsonKey(name: 'device_id') final String deviceId; @JsonKey(name: 'login_data') final String loginData; const LoginData({ required this.accountId, required this.profile, required this.nonce, required this.accessToken, required this.refreshToken, required this.deviceId, required this.loginData, }); factory LoginData.fromJson(Map json) => _$LoginDataFromJson(json); User toEntity() => profile.toEntity(); } /// Top-level envelope: { "code": 0, "message": "OK", "data": { ... } } @JsonSerializable(createToJson: false, explicitToJson: true) class LoginResponse { final int code; final String message; final LoginData data; const LoginResponse({ required this.code, required this.message, required this.data, }); factory LoginResponse.fromJson(Map json) => _$LoginResponseFromJson(json); User toEntity() => data.toEntity(); } // ───────────────────────────────────────────── // Request // ───────────────────────────────────────────── /// 登录请求 /// /// `@ApiRequest` 一个注解搞定一切: /// - mixin 自动生成 path / method / requestType / includeToken / toJson /// - toJson 只序列化类自身字段(email, password),不含继承属性 /// - Response 的 fromJson 在 parameters getter 中自动注册 /// - 无需 @JsonSerializable,无需手写 fromJson / toJson @ApiRequest( path: ApiPaths.authLogin, method: HttpMethod.post, responseType: LoginResponse, requestType: ApiRequestType.login, ) class LoginRequest extends ApiRequestable with _$LoginRequestApi { final String email; final String password; LoginRequest({required this.email, required this.password}); }