/// 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:drift/drift.dart' show driftRuntimeOptions;
import 'package:photo_live/app/locale_controller.dart';
import 'package:photo_live/core/api_client.dart';
import 'package:photo_live/core/session_store.dart';
import 'package:photo_live/features/uploads/providers.dart';
import 'package:photo_live/features/uploads/task_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;
}

/// 内存语言偏好存储（测试替身，P3 Task 10）。
class FakeLocaleStore implements LocalePrefsStore {
  /// 当前持久值（read 返回）；null = 未设置（跟随系统）。
  String? value;

  /// 按序记录全部写入（断言持久化调用用）。
  final List<String> writes = <String>[];

  @override
  Future<String?> read() async => value;

  @override
  Future<void> write(String value) async {
    writes.add(value);
    this.value = value;
  }
}

/// Widget 测试通用 overrides（P3 Task 9 起，登录页/主壳会触达
/// sessionAccountProvider 与任务库 Provider——真实 flutter_secure_storage
/// 与 path_provider 的平台通道在测试环境挂起，凡 pump 到相关页面均需
/// 注入替身）。
///
/// 返回 [FakeSessionStore] + 内存 [TaskStore] + 可选 FakeAdapter ApiClient
/// 的 override 列表。Riverpod 3 已不公开 `Override` 类型（无法作签名注解），
/// 故元素类型为 dynamic——调用点以 spread 展开进 ProviderScope.overrides
/// （元素真实类型即 Override，展开本身类型安全）：
/// `ProviderScope(overrides: [...pageTestOverrides(...), 其他], ...)`。
List<dynamic> pageTestOverrides({
  FakeSessionStore? session,
  TaskStore? taskStore,
  ApiClient? client,
}) {
  // 每个测试各自 new 一块内存库（独立 QueryExecutor，随容器销毁），
  // drift 的“多实例同执行器”告警在此是误报——测试输出降噪。
  driftRuntimeOptions.dontWarnAboutMultipleDatabases = true;
  final store = taskStore ?? TaskStore.memory();
  return <dynamic>[
    if (session != null) sessionStoreProvider.overrideWithValue(session),
    taskStoreProvider.overrideWithValue(store),
    if (client != null) apiClientProvider.overrideWith((ref) => client),
  ];
}

/// 记录到适配器的请求快照。
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>>[],
  Map<String, dynamic>? cover,
}) => <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,
  'cover': cover,
};

/// 契约 `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 uploaderAccount = 'staff02',
  String uploaderName = 'Staff Two',
  Map<String, dynamic>? preview,
}) => <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': uploaderAccount,
    'displayName': uploaderName,
  },
  'preview': preview,
};

/// 契约 `PhotoPreview` 响应体（thumb/browse 签名 URL）。
Map<String, dynamic> photoPreviewJson({
  String thumbUrl = 'http://test.local/thumb.jpg',
  String browseUrl = 'http://test.local/browse.jpg',
}) => <String, dynamic>{
  'thumb': {
    'url': thumbUrl,
    'expiresAt': '2026-09-22T00:00:00Z',
  },
  'browse': {
    'url': browseUrl,
    'expiresAt': '2026-09-22T00:00:00Z',
  },
};

/// 契约游标分页响应体（hasMore 与 nextCursor 成对）。
Map<String, dynamic> cursorPageBody(
  List<Map<String, dynamic>> items, {
  String? nextCursor,
}) => <String, dynamic>{
  'items': items,
  'nextCursor': nextCursor,
  'hasMore': nextCursor != null,
};