浅念
251 lines
7.0 KiB
Dart
251 lines
7.0 KiB
Dart
/// Widget/单元测试共用替身（P3 计划 Task 3）。
|
||
///
|
||
/// 与 test/core/api_client_test.dart 中的手写打桩同款：FakeAdapter 为
|
||
/// dio HttpClientAdapter，按路由分发预设响应并记录全部请求；未引入
|
||
/// http_mock_adapter（零额外 dev 依赖，打桩面完全可控）。
|
||
library;
|
||
|
||
import 'dart:async';
|
||
import 'dart:convert';
|
||
|
||
import 'package:dio/dio.dart';
|
||
import 'package:photo_live/core/session_store.dart';
|
||
|
||
/// 内存会话存储（测试替身）。
|
||
class FakeSessionStore implements SessionStore {
|
||
Session? session;
|
||
|
||
@override
|
||
Future<Session?> read() async => session;
|
||
|
||
@override
|
||
Future<void> save(Session value) async => session = value;
|
||
|
||
@override
|
||
Future<void> clear() async => session = null;
|
||
}
|
||
|
||
/// 记录到适配器的请求快照。
|
||
class RecordedRequest {
|
||
const RecordedRequest({
|
||
required this.method,
|
||
required this.path,
|
||
required this.uri,
|
||
required this.headers,
|
||
required this.body,
|
||
});
|
||
|
||
final String method;
|
||
final String path;
|
||
|
||
/// 完整 URI（含 query，游标/过滤参数断言用）。
|
||
final Uri uri;
|
||
final Map<String, dynamic> headers;
|
||
final Object? body;
|
||
}
|
||
|
||
/// 手写 dio 打桩适配器：按路由分发预设响应并记录全部请求。
|
||
///
|
||
/// [router] 返回 `(status, body)`（可为 async 以模拟慢响应/加载态）；
|
||
/// body 为 null 表示无响应体（204）。
|
||
class FakeAdapter implements HttpClientAdapter {
|
||
FakeAdapter(this.router);
|
||
|
||
final FutureOr<(int, Object?)> Function(RequestOptions options) router;
|
||
|
||
final List<RecordedRequest> requests = <RecordedRequest>[];
|
||
|
||
@override
|
||
Future<ResponseBody> fetch(
|
||
RequestOptions options,
|
||
Stream? requestStream,
|
||
Future? cancelFuture,
|
||
) async {
|
||
requests.add(
|
||
RecordedRequest(
|
||
method: options.method,
|
||
path: options.path,
|
||
uri: options.uri,
|
||
headers: Map<String, dynamic>.from(options.headers),
|
||
body: options.data,
|
||
),
|
||
);
|
||
if (requestStream != null) {
|
||
// 消费请求流（真实服务端会读 body；上传引擎的进度计数流由此驱动）。
|
||
await requestStream.drain<Object?>();
|
||
}
|
||
final (status, body) = await router(options);
|
||
if (body == null) {
|
||
// 204 等：空体且不带 JSON content-type（transformer 不解码）。
|
||
return ResponseBody.fromString('', status);
|
||
}
|
||
return ResponseBody.fromString(
|
||
jsonEncode(body),
|
||
status,
|
||
headers: {
|
||
Headers.contentTypeHeader: [Headers.jsonContentType],
|
||
},
|
||
);
|
||
}
|
||
|
||
@override
|
||
void close({bool force = false}) {}
|
||
}
|
||
|
||
/// 常用响应体：登录成功（openapi LoginResponse 形状）。
|
||
Map<String, dynamic> loginOkBody({
|
||
String token = 'tok-new',
|
||
String expiresAt = '2026-09-20T12:00:00Z',
|
||
}) => <String, dynamic>{
|
||
'sessionToken': token,
|
||
'expiresAt': expiresAt,
|
||
};
|
||
|
||
/// 常用响应体：契约 Error 形状。
|
||
Map<String, dynamic> errorBody(String code) => <String, dynamic>{
|
||
'code': code,
|
||
'message': 'stub message',
|
||
'requestId': 'req-stub',
|
||
};
|
||
|
||
// ── 相册域 fixtures（P3 计划 Task 4；形状对齐 openapi.yaml schemas）──
|
||
|
||
/// 契约 `Album` 响应体（GET/POST /albums、PATCH /albums/{id}）。
|
||
Map<String, dynamic> albumJson({
|
||
String id = 'alb-1',
|
||
String publicToken = 'sharetoken000000000001',
|
||
String ownerId = 'u-owner',
|
||
String status = 'active',
|
||
String defaultLocale = 'zh-CN',
|
||
String timezone = 'Asia/Shanghai',
|
||
String startAt = '2026-09-18T06:30:00Z', // 上海墙钟 14:30
|
||
String? endAt,
|
||
bool uploadEnabled = true,
|
||
bool publicEnabled = true,
|
||
bool downloadEnabled = true,
|
||
bool originalDownloadEnabled = false,
|
||
List<Map<String, dynamic>>? translations,
|
||
List<Map<String, dynamic>> categories = const <Map<String, dynamic>>[],
|
||
}) =>
|
||
<String, dynamic>{
|
||
'id': id,
|
||
'publicToken': publicToken,
|
||
'ownerId': ownerId,
|
||
'status': status,
|
||
'defaultLocale': defaultLocale,
|
||
'timezone': timezone,
|
||
'startAt': startAt,
|
||
'endAt': endAt,
|
||
'uploadEnabled': uploadEnabled,
|
||
'publicEnabled': publicEnabled,
|
||
'downloadEnabled': downloadEnabled,
|
||
'originalDownloadEnabled': originalDownloadEnabled,
|
||
'watermarkVersion': 0,
|
||
'translations': translations ??
|
||
<Map<String, dynamic>>[
|
||
<String, dynamic>{
|
||
'locale': 'zh-CN',
|
||
'title': '开幕晚宴',
|
||
'description': null,
|
||
'venue': '大宴会厅',
|
||
'address': null,
|
||
},
|
||
<String, dynamic>{
|
||
'locale': 'en',
|
||
'title': 'Opening Gala',
|
||
'description': null,
|
||
'venue': null,
|
||
'address': null,
|
||
},
|
||
],
|
||
'categories': categories,
|
||
'createdAt': '2026-09-01T00:00:00Z',
|
||
'updatedAt': '2026-09-01T00:00:00Z',
|
||
'statsSyncedAt': null,
|
||
};
|
||
|
||
/// 契约 `Category` 响应体。
|
||
Map<String, dynamic> categoryJson({
|
||
String id = 'cat-1',
|
||
String albumId = 'alb-1',
|
||
int sortOrder = 0,
|
||
List<Map<String, dynamic>>? translations,
|
||
}) =>
|
||
<String, dynamic>{
|
||
'id': id,
|
||
'albumId': albumId,
|
||
'sortOrder': sortOrder,
|
||
'translations': translations ??
|
||
<Map<String, dynamic>>[
|
||
<String, dynamic>{'locale': 'zh-CN', 'name': '仪式'},
|
||
<String, dynamic>{'locale': 'en', 'name': 'Ceremony'},
|
||
],
|
||
};
|
||
|
||
/// 契约 `Member` 响应体。
|
||
Map<String, dynamic> memberJson({
|
||
String userId = 'u-2',
|
||
String account = 'staff02',
|
||
String displayName = 'Staff Two',
|
||
String role = 'collaborator',
|
||
}) =>
|
||
<String, dynamic>{
|
||
'userId': userId,
|
||
'account': account,
|
||
'displayName': displayName,
|
||
'role': role,
|
||
'status': 'active',
|
||
};
|
||
|
||
/// 契约 `AdminUserLookupItem` 响应体。
|
||
Map<String, dynamic> lookupUserJson({
|
||
String id = 'u-9',
|
||
String account = 'staff09',
|
||
String displayName = 'Staff Nine',
|
||
}) =>
|
||
<String, dynamic>{
|
||
'id': id,
|
||
'account': account,
|
||
'displayName': displayName,
|
||
};
|
||
|
||
/// 契约 `AdminPhoto` 响应体。
|
||
Map<String, dynamic> adminPhotoJson({
|
||
String photoId = 'ph-00000001',
|
||
String albumId = 'alb-1',
|
||
String visibility = 'published',
|
||
String processingState = 'ready',
|
||
int bytes = 123456,
|
||
}) =>
|
||
<String, dynamic>{
|
||
'photoId': photoId,
|
||
'albumId': albumId,
|
||
'categoryId': null,
|
||
'uploaderId': 'u-2',
|
||
'visibility': visibility,
|
||
'processingState': processingState,
|
||
'bytes': bytes,
|
||
'width': 4000,
|
||
'height': 3000,
|
||
'shotAt': null,
|
||
'uploadedAt': '2026-09-18T07:00:00Z',
|
||
'publishedAt': '2026-09-18T07:05:00Z',
|
||
'likeCount': 0,
|
||
'uploader': <String, dynamic>{
|
||
'userId': 'u-2',
|
||
'account': 'staff02',
|
||
'displayName': 'Staff Two',
|
||
},
|
||
};
|
||
|
||
/// 契约游标分页响应体（hasMore 与 nextCursor 成对）。
|
||
Map<String, dynamic> cursorPageBody(
|
||
List<Map<String, dynamic>> items, {
|
||
String? nextCursor,
|
||
}) =>
|
||
<String, dynamic>{
|
||
'items': items,
|
||
'nextCursor': nextCursor,
|
||
'hasMore': nextCursor != null,
|
||
};
|