// connection_provider.dart — 连接状态机（严格三态，状态由内核事件驱动）
//
// 设计约定：
//   - UI 调用 toggle()，控制器内部读取有效节点 + 认证令牌，调用 ConnectApi
//     并启动 VpnBridge 子进程。
//   - 严禁乐观翻转：VpnPhase.on 必须由 bridge.statusStream 确认后才置。
//   - 状态来源：bridge.statusStream（来自内核回调），非 Timer 模拟。
import 'dart:async';

import 'package:flutter/widgets.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

import '../bridge/log.dart';
import '../bridge/vpn_bridge.dart';
import '../bridge/vpn_bridge_provider.dart';
import '../l10n/app_text.dart';
import '../models/node.dart';
import '../services/api_config.dart';
import '../services/auth_api.dart';
import '../services/connect_api.dart';
import '../services/device_identity.dart';
import 'account_providers.dart';
import 'app_providers.dart';
import 'auth_provider.dart';
import 'nodes_provider.dart';
import 'quota_provider.dart';
import 'settings_provider.dart';

// 设备 ID 由 deviceIdentityProvider 提供(secure storage 持久化的稳定 UUID)。
// API base URL 统一用 api_config.dart 的 kApiBaseUrl(单一来源,勿再重复声明)。

// ── 连接阶段枚举 ──────────────────────────────────────────────────

/// 连接阶段。严格三态，与设计稿一致。
enum VpnPhase { off, connecting, on }

// ── 连接状态快照 ──────────────────────────────────────────────────

class ConnectionState {
  const ConnectionState({
    required this.phase,
    this.elapsed = Duration.zero,
    this.error,
    this.freeCountdown,
  });

  final VpnPhase phase;
  final Duration elapsed;

  /// 连接失败/中断原因(已本地化);null = 无错误。供 UI 提示,不再静默吞掉。
  final String? error;

  /// 免费版连接期剩余额度(倒计时);null = 不适用(会员/未连接/额度不限)。
  /// 由状态机按「连接时锁定的剩余额度 − 已用时长」本地推算,归零即自动切断。
  final Duration? freeCountdown;

  ConnectionState copyWith({VpnPhase? phase, Duration? elapsed, Duration? freeCountdown}) =>
      ConnectionState(
        phase: phase ?? this.phase,
        elapsed: elapsed ?? this.elapsed,
        freeCountdown: freeCountdown ?? this.freeCountdown,
      );

  @override
  bool operator ==(Object other) =>
      other is ConnectionState &&
      other.phase == phase &&
      other.elapsed == elapsed &&
      other.error == error &&
      other.freeCountdown == freeCountdown;

  @override
  int get hashCode => Object.hash(phase, elapsed, error, freeCountdown);
}

// ── 连通看门狗 ─────────────────────────────────────────────────────
//
// 已连接(本地 TUN 已起)≠ 远端节点数据面可用。三条路径发现节点异常,全平台一致:
//   A. urltest 陈旧(跨端统一主路径):内核 urltest 经 proxy 出站(REALITY→节点)探测,
//      节点死则探测失败、urltest 停更。看门狗发现「上次 urltest 成功超过 _kUrltestStale」
//      即判上游死 → _onNodeUnhealthy。urltest 四端都有(stats),不依赖各原生端的状态上报。
//   A'. 意外内核掉线:原生端真把「上游断」上报成 off/error 时(桌面子进程确认有),走
//      _onKernelStatus 的非用户主动 off → 节点异常提示。属 A 的快路径,有则更快、无则靠 A 兜底。
//   B. 服务端权威 down:看门狗连接态周期刷 /v1/nodes,所连节点被判 down(dp_healthy=0 /
//      agent 掉线 / 运维下线)即处理。覆盖「本地 TUN 还没断、但节点已被判不可用」。
// 注:不做客户端 TCP 探数据口——全局 TUN 下 App 的 socket 被本地 TUN 当场接住(假 1ms),
// 测不到真节点。判活针对「实际所连节点」(_connectedNode),非会随 ping 漂移的 effectiveNode。

const _kWatchdogInterval = Duration(seconds: 15);
// urltest 超过此时长未成功(连接态)即判上游(节点数据面)死。须 > 原生 urltest 探测间隔。
const _kUrltestStale = Duration(seconds: 45);
// stats 帧在此时长内到过即视为「在流」。超过(app 挂起/唤醒未恢复)时看门狗路径 A 不判活,
// 避免把 app 被挂起的空档错算成节点死。须 > 原生 stats 轮询间隔(~1s),留足余量。
const _kStatsLive = Duration(seconds: 10);
// 无备用节点时,弱网抖动判「节点异常」先自动重连当前节点的最大次数;超过才真报错。#18
const _kMaxAutoReconnect = 3;

// ── 状态机 ───────────────────────────────────────────────────────

class ConnectionController extends StateNotifier<ConnectionState> {
  ConnectionController(this._ref, this._bridge, {DateTime Function()? now})
      : _now = now ?? DateTime.now,
        super(const ConnectionState(phase: VpnPhase.off)) {
    // 订阅桥状态流：状态由内核事件驱动，严禁 UI 乐观翻转。
    _statusSub = _bridge.statusStream.listen(_onKernelStatus);
    // 订阅内核 stats:连接态把 urltest 实测回写连接节点的 ping,让连接页与节点列表同源一致。
    _statsSub = _bridge.statsStream.listen(_onStats);
    // 登出(主动退出 / 被强制下线 / 会话过期)→ 一律断开隧道:别让已登出/被踢的设备继续用
    // 数据面。一处监听 auth 覆盖所有登出路径。token 续期(仍登录)不触发。
    _authSub = _ref.listen<AuthState>(authProvider, (prev, next) {
      if ((prev?.isLoggedIn ?? false) && !next.isLoggedIn) {
        _userDisconnect = true; // 视为「非节点异常」的主动断开,不弹「节点异常」
        unawaited(_disconnect());
      }
    });
    // 生命周期闸:切后台停看门狗,回前台再开。原因:后台(尤其 Android Doze)会把 urltest
    // 的主动探测限流 → urltest 停更、但 speed 帧仍在流 → 路径 A 误判「上游死」把正常隧道断掉
    // (实测 Honor 后台 ~1min 必现:logcat「urltest stale 59s → upstream dead」)。后台无 UI 可
    // 响应,停掉最稳;回前台基准由 _onStats 首帧/gap 重置。真·内核掉线(路径 A',事件驱动)不受影响。
    _lifecycle = AppLifecycleListener(
      onStateChange: (s) {
        if (s == AppLifecycleState.resumed) {
          if (state.phase == VpnPhase.on) {
            if (_watchdog == null) _startWatchdog();
            _refreshElapsed(); // 回前台按墙上时钟补上后台漏计的时长
          }
        } else if (s == AppLifecycleState.paused || s == AppLifecycleState.hidden) {
          _stopWatchdog();
        }
      },
    );
  }

  final Ref _ref;
  final VpnBridge _bridge;
  StreamSubscription<VpnStatus>? _statusSub;
  StreamSubscription<VpnStatsEvent>? _statsSub;
  ProviderSubscription<AuthState>? _authSub;
  Timer? _elapsed;
  // 本次连接的起始时刻;连接时长按「now - _connectedAt」墙上时钟算,而非每秒 +1 累加 ——
  // 否则 app 切后台/锁屏 isolate 被挂起、Timer 停跳,后台那段时长会漏计(iOS 尤甚)。
  DateTime? _connectedAt;
  Timer? _watchdog;
  AppLifecycleListener? _lifecycle;
  bool _probing = false;
  // 最近一次 urltest 成功(经 proxy 真实可达)的时刻;路径 A 用其陈旧度判上游死。
  DateTime? _lastUrltestOk;
  // 最近收到任意 stats 帧的时刻;用于区分「节点死(stats 在流、urltest 停)」与
  // 「app 挂起/睡眠(stats 整体停)」,避免后台唤醒后看门狗用墙上时钟误判节点死→假重连。
  DateTime? _lastStatsAt;
  // 取「现在」的时钟(默认真实时钟,测试可注入以驱动 urltest 陈旧度/stats 在流判定)。
  final DateTime Function() _now;
  // 本次 off 的提示语(节点异常/自动切换);kernel off 与显式断开都读它,避免被互相覆盖。
  // 仅 _connect 开始时清空。用户主动断开则保持 null(无提示)。
  String? _offNotice;
  // 标记「用户主动断开」:其引发的 kernel off 不当作节点异常。
  bool _userDisconnect = false;
  ConnectApi? _api;
  // 实际所连节点(连接时锁定):看门狗探测/判活针对它,而非会随 ping 漂移的 effectiveNode。
  Node? _connectedNode;
  // 无备用节点时「先自动重连当前节点」的连续尝试计数;连接恢复健康(urltest 成功)或
  // 用户主动连接时清零,只有持续失败才耗尽额度后真报「节点异常」。#18
  int _autoReconnectAttempts = 0;
  // 免费版:连接时锁定的剩余额度(秒);连接期按「_freeRemainingSec − 已用秒」倒计时,
  // 归零即自动切断(_onFreeQuotaExhausted)。null = 会员/额度不限,不倒计时。
  int? _freeRemainingSec;

  // ── 公有 API ───────────────────────────────────────────────────

  /// 用户点击连接键：按当前状态决定动作，握手中忽略（禁乐观）。
  void toggle() {
    switch (state.phase) {
      case VpnPhase.off:
        _autoReconnectAttempts = 0; // 用户主动连接:重置弱网自动重连额度(#18)
        _connect();
      case VpnPhase.on:
        _userDisconnect = true; // 用户主动断开:其 kernel off 不当作节点异常
        _disconnect();
      case VpnPhase.connecting:
        break; // 握手进行中，不响应
    }
  }

  /// 节点切换时触发：已连接则重连。
  void onNodeChanged() {
    if (state.phase == VpnPhase.on || state.phase == VpnPhase.connecting) {
      _disconnect().then((_) => _connect());
    }
  }

  // ── 内部 ─────────────────────────────────────────────────────

  Future<void> _connect() async {
    _offNotice = null; // 新连接:清掉上次的中断提示
    _userDisconnect = false;
    _lastUrltestOk = null; // 重置 urltest 判活基准(连上后由 _onStats 首次成功置位)
    _lastStatsAt = null;   // 重置 stats 在流基准(连上后由 _onStats 首帧置位)
    // 免费版:锁定本次连接可用的剩余额度(账户共享,权威取自 me)。会员为 null 不倒计时。
    _freeRemainingSec = _ref.read(isFreePlanProvider)
        ? _ref.read(quotaProvider).remainingMinutes * 60
        : null;
    state = const ConnectionState(phase: VpnPhase.connecting);

    final node = _ref.read(effectiveNodeProvider);
    final zh = _ref.read(localeProvider) == AppLang.zh;
    logLine('Connect', '_connect node=${node.code} uuid=${node.uuid.isEmpty ? "EMPTY" : "ok"} '
        'selected=${_ref.read(selectedNodeCodeProvider)} nodes=${(_ref.read(nodesProvider).valueOrNull ?? const []).length}');

    // 节点未就绪(列表加载中/为空):不连接,提示用户。
    if (node.uuid.isEmpty) {
      if (mounted) {
        state = ConnectionState(
          phase: VpnPhase.off,
          error: zh ? '节点尚未就绪,请稍候重试' : 'Nodes not ready, please retry',
        );
      }
      return;
    }

    _connectedNode = node; // 锁定本次实际所连节点,供看门狗探测/判活
    try {
      final configJson = await _fetchConfigWithRefresh(node.uuid);
      // bridge.start() 不阻塞至连接建立；on 状态由 statusStream 回调驱动。
      await _bridge.start(configJson);
    } on ConnectApiException catch (e) {
      // 设备数超限(backstop):弹「移除设备」页(顶层路由据 deviceLimitProvider 切屏),
      // 兜住"已登录但超限"的设备——它们一连就被拦、被提示,无需重新登录。连接回 off。
      if (e.code == 'DEVICE_LIMIT_EXCEEDED') {
        _ref.read(deviceLimitProvider.notifier).state =
            DeviceLimit(maxDevices: e.maxDevices ?? 0, devices: const []);
        if (mounted) state = const ConnectionState(phase: VpnPhase.off);
        return;
      }
      // 免费额度已用完(服务端兜底):本地置耗尽 → 按钮灰化、点击弹广告/升级。回 off。
      if (e.code == 'QUOTA_EXHAUSTED') {
        _ref.read(quotaProvider.notifier).markExhausted();
        if (mounted) state = ConnectionState(phase: VpnPhase.off, error: zh ? e.messageZh : e.messageEn);
        return;
      }
      // 把后端/网络错误冒泡到 UI(原静默回 off,用户不知所以)。
      if (mounted) state = ConnectionState(phase: VpnPhase.off, error: zh ? e.messageZh : e.messageEn);
    } catch (e) {
      if (mounted) {
        state = ConnectionState(
          phase: VpnPhase.off,
          error: zh ? '连接失败,请重试' : 'Connection failed, please retry',
        );
      }
    }
  }

  /// 取配置;access token 过期(401)时用 refresh token 续期后**重试一次**。
  /// 续期失败(refresh 也过期 / 被拒)由 authProvider.refresh() 触发登出 → UI 回登录页。
  Future<String> _fetchConfigWithRefresh(String nodeUuid) async {
    final deviceId = await _ref.read(deviceIdentityProvider).deviceId();
    Future<String> doFetch() {
      final token = _ref.read(authProvider).accessToken ?? '';
      _api?.dispose();
      _api = _ref.read(connectApiFactoryProvider)(token);
      return _api!.fetchConfig(
        nodeId: nodeUuid,
        deviceId: deviceId,
        // smartRoute 偏好 → 国内分流(#5):国内 IP/域名直连,不走隧道。
        splitCN: _ref.read(settingsProvider).smartRoute,
      );
    }

    try {
      return await doFetch();
    } on ConnectApiException catch (e) {
      if (e.statusCode == 401) {
        // token 过期 → 续期后重试一次;续期成功则用新 token 再取。
        final ok = await _ref.read(authProvider.notifier).refresh();
        if (ok) return await doFetch();
      }
      rethrow;
    }
  }

  Future<void> _disconnect() async {
    _stopElapsed();
    _stopWatchdog();
    try {
      await _bridge.stop();
    } catch (_) {}
    // 携带 _offNotice(节点异常/null);与 kernel off 读同一字段,不互相覆盖。
    if (mounted) state = ConnectionState(phase: VpnPhase.off, error: _offNotice);
    _refreshQuota(); // 会话结束 → 刷新「今日剩余」反映本次消耗
  }

  // 静默刷新 /me(不闪整页 spinner),让免费额度「今日剩余」跨会话/跨设备更新。
  void _refreshQuota() {
    if (_ref.read(authProvider).isLoggedIn && _ref.read(isFreePlanProvider)) {
      unawaited(_ref.read(meProvider.notifier).silentRefresh());
    }
  }

  void _onKernelStatus(VpnStatus s) {
    if (!mounted) return;
    switch (s) {
      case VpnStatus.on:
        // 免费版:若本次「on」不是经 _connect 而来(如 Android 常驻隧道、app 重启后
        // 自动同步到已在跑的隧道),_freeRemainingSec 还是 null → 倒计时不启。这里兜底
        // 按当前额度补锁定,保证连接页显示的是倒计时(会变)而非静态「今日剩余」。
        if (_freeRemainingSec == null && _ref.read(isFreePlanProvider)) {
          _freeRemainingSec = _ref.read(quotaProvider).remainingMinutes * 60;
        }
        state = state.copyWith(phase: VpnPhase.on);
        _startElapsed();
        _startWatchdog();
      case VpnStatus.connecting:
        state = state.copyWith(phase: VpnPhase.connecting);
        _stopElapsed();
        _stopWatchdog();
      case VpnStatus.off:
      case VpnStatus.error:
        // 路径 A:仅「真正连上过(on)再非用户主动掉线」才判节点异常(数据面死/REALITY 断)。
        // 必须排除 connecting 握手期的瞬态 off——macOS NE 连接序列是 off→connecting→off→
        // connecting→on,connecting 期的 off 是握手抖动、不是异常(否则一连接就误报「节点异常」)。
        final wasConnected = state.phase == VpnPhase.on;
        _stopElapsed();
        _stopWatchdog();
        if (!_userDisconnect && wasConnected && _offNotice == null) {
          // 意外掉线(非用户主动、曾连上;弱网抖动最常见的就是这条 kernel off)。先自动重连
          // **当前节点**(不换节点——弱网是本地网络问题,换节点无益还会来回横跳),重试用尽才
          // 报「节点异常」。(wasConnected 闸:重连握手期再掉线时 phase 已非 on,不自我循环触发。)#18
          logLine('Watchdog', 'unexpected kernel ${s.name} after connected → node interrupted');
          _userDisconnect = false;
          unawaited(_handleUnexpectedOff());
          return;
        }
        state = ConnectionState(phase: VpnPhase.off, error: _offNotice);
        _userDisconnect = false;
        _refreshQuota(); // 内核掉线也算会话结束 → 刷新「今日剩余」
    }
  }

  // 连接态:取内核 urltest 最小正延迟,回写连接节点 ping。全局 TUN 下 App 直接探测节点不可行,
  // 内核(经 REALITY 真实直连数据面)是唯一能实测的;回写到 node.ping → 连接页/节点列表同源。
  void _onStats(VpnStatsEvent e) {
    if (state.phase != VpnPhase.on) return;
    final now = _now();
    // stats 出现长间断(app 挂起/睡眠唤醒)→ 此前的 urltest 时刻已不可信(墙上时钟空转期间
    // 没有探测)。把判活基准前移到现在,给节点一个新的 _kUrltestStale 窗口自证,避免误判假重连。
    if (_lastStatsAt != null && now.difference(_lastStatsAt!) > _kStatsLive) {
      _lastUrltestOk = now;
    }
    _lastStatsAt = now;
    // 自动连接/重连到已在跑的隧道时不会走 _connect → _connectedNode 为 null;回退到
    // effectiveNode(当前/智能所选),否则 urltest 实测无处回写、连接页延迟一直显示 —。
    final Node node = _connectedNode ?? _ref.read(effectiveNodeProvider);
    if (node.uuid.isEmpty) return;
    final ds = e.urltestResults.where((r) => r.delayMs > 0).map((r) => r.delayMs);
    if (ds.isEmpty) return;
    // urltest 成功:经 proxy 出站(REALITY 到节点)真实可达 → 记录时刻(供路径 A 判活)+ 回写延迟。
    _lastUrltestOk = now;
    _autoReconnectAttempts = 0; // 节点已恢复健康 → 清零自动重连计数,下次抖动重获满额重试。#18
    final best = ds.reduce((a, b) => a < b ? a : b);
    _ref.read(nodesProvider.notifier).setLivePing(node.uuid, best);
  }

  // ── 连通看门狗(路径 B:服务端权威 down 轮询)───────────────────────
  void _startWatchdog() {
    _watchdog?.cancel();
    _watchdog = Timer.periodic(_kWatchdogInterval, (_) => _checkHealth());
    unawaited(_checkHealth()); // 立即查一次,早发现「TUN 未断但节点已被判 down」
  }

  void _stopWatchdog() {
    _watchdog?.cancel();
    _watchdog = null;
    _probing = false;
  }

  Future<void> _checkHealth() async {
    if (_probing || !mounted || state.phase != VpnPhase.on) return;
    // 实际所连节点(测试态直接 emit on 时未走 _connect → 回退 effectiveNode)。
    final Node node = _connectedNode ?? _ref.read(effectiveNodeProvider);
    if (node.uuid.isEmpty) return;
    _probing = true;
    var serverDown = false;
    try {
      await _ref.read(nodesProvider.notifier).refresh();
      final cur = (_ref.read(nodesProvider).valueOrNull ?? const <Node>[])
          .where((n) => n.uuid == node.uuid);
      if (cur.isNotEmpty) serverDown = cur.first.isDown;
    } catch (_) {
      // 拉取失败保留旧列表,不误判;等下一轮。
    }
    _probing = false;
    if (!mounted || state.phase != VpnPhase.on) return;
    if (serverDown) {
      logLine('Watchdog', 'server marked node ${node.code} down → unhealthy');
      _stopWatchdog();
      await _onNodeUnhealthy();
      return;
    }
    // 路径 A(跨端统一):urltest 曾成功过、但已超过 _kUrltestStale 未再成功 → 上游(节点
    // 数据面)死。urltest 经 proxy 出站探测,四端都有;不依赖原生端把「上游断」报成 off/error。
    final lastOk = _lastUrltestOk;
    // stats 必须确实在流才判活:否则(app 刚挂起/唤醒、stats 还没恢复)看门狗会拿冻住的
    // 旧时刻误判。stats 未恢复时跳过本轮,等 _onStats 重置基准后再判。
    final now = _now();
    final statsLive = _lastStatsAt != null && now.difference(_lastStatsAt!) < _kStatsLive;
    if (statsLive && lastOk != null && now.difference(lastOk) > _kUrltestStale) {
      logLine('Watchdog', 'urltest stale ${now.difference(lastOk).inSeconds}s → upstream dead → unhealthy');
      _stopWatchdog();
      await _onNodeUnhealthy();
    }
  }

  /// 所连节点被服务端判 down:智能 → 切到其他最优可用节点重连;手动 → 断开并提示。
  Future<void> _onNodeUnhealthy() async {
    final t = _ref.read(appTextProvider);
    final Node node = _connectedNode ?? _ref.read(effectiveNodeProvider);
    final smart = _ref.read(selectedNodeCodeProvider) == kSmartNodeCode;
    final altCode = smart ? _pickAlternativeCode(node.code) : null;
    if (smart && altCode != null) {
      _ref.read(selectedNodeCodeProvider.notifier).select(altCode);
      await _disconnect();
      await _connect();
      // 重连进行中给出「已自动切换」提示(connecting 态显示,连上后随 copyWith 清除)。
      if (mounted && state.phase != VpnPhase.off) {
        state = ConnectionState(phase: state.phase, error: t.nodeUnhealthySwitched);
      }
      return;
    }
    // 无备用节点(手动选定节点 / 智能但无其他可用):弱网抖动别一判死就断开+要用户手动重连。
    // 先自动重连**当前节点**,连续失败超过上限再真报「节点异常」。#18
    if (await _tryAutoReconnectCurrent()) return;
    // 重试用尽:断开并提示「节点异常」。提示走 _offNotice,由 _disconnect/_onKernelStatus 应用。
    _offNotice = t.nodeUnhealthyError;
    await _disconnect();
  }

  /// 弱网抖动:自动重连**当前节点**(不换节点、不改 selectedNode),bounded。
  /// 返回 true = 已发起重连(额度内);false = 已用尽额度,调用方应改报「节点异常」。#18
  /// urltest 成功(_onStats)或用户主动连接(toggle)会把计数清零 → 只有持续失败才耗尽。
  Future<bool> _tryAutoReconnectCurrent() async {
    if (_autoReconnectAttempts >= _kMaxAutoReconnect) return false;
    _autoReconnectAttempts++;
    final Node node = _connectedNode ?? _ref.read(effectiveNodeProvider);
    logLine('Watchdog', 'auto-reconnect current node ${node.code} (attempt $_autoReconnectAttempts/$_kMaxAutoReconnect)');
    await _disconnect();
    await _connect();
    // 重连握手中给「网络波动,正在重连…」瞬态提示(连上后随 copyWith 清除)。
    if (mounted && state.phase != VpnPhase.off) {
      state = ConnectionState(phase: state.phase, error: _ref.read(appTextProvider).nodeReconnecting);
    }
    return true;
  }

  /// 意外内核掉线(弱网)的处理:先自动重连当前节点,额度用尽才断开并报「节点异常」。#18
  Future<void> _handleUnexpectedOff() async {
    if (await _tryAutoReconnectCurrent()) return;
    _offNotice = _ref.read(appTextProvider).nodeUnhealthyError;
    await _disconnect();
  }

  /// 选延迟最优、可用(status up)、非当前节点的 code;无则 null。
  String? _pickAlternativeCode(String excludeCode) {
    final nodes = (_ref.read(nodesProvider).valueOrNull ?? const [])
        .where((n) => !n.isDown && n.uuid.isNotEmpty && n.code != excludeCode)
        .toList();
    if (nodes.isEmpty) return null;
    nodes.sort((a, b) {
      final pa = a.ping > 0 ? a.ping : 1 << 30;
      final pb = b.ping > 0 ? b.ping : 1 << 30;
      return pa.compareTo(pb);
    });
    return nodes.first.code;
  }

  void _startElapsed() {
    _elapsed?.cancel();
    _connectedAt ??= _now();               // 同一会话保留起点(on 被重复上报也不重置);断开时清空
    _refreshElapsed();                     // 立即刷新,避免等 1s
    _elapsed = Timer.periodic(const Duration(seconds: 1), (_) => _refreshElapsed());
  }

  /// 按墙上时钟把 elapsed 刷成 now - _connectedAt(切后台回来也准);免费版顺带推算
  /// 倒计时,归零即自动切断。倒计时用墙上时钟,后台/锁屏漏跳也会在回前台补上、准时切。
  void _refreshElapsed() {
    final at = _connectedAt;
    if (!mounted || state.phase != VpnPhase.on || at == null) return;
    final elapsed = _now().difference(at);

    Duration? countdown;
    final capSec = _freeRemainingSec;
    if (capSec != null) {
      final leftSec = capSec - elapsed.inSeconds;
      if (leftSec <= 0) {
        unawaited(_onFreeQuotaExhausted());
        return;
      }
      countdown = Duration(seconds: leftSec);
    }
    state = ConnectionState(phase: VpnPhase.on, elapsed: elapsed, freeCountdown: countdown);
  }

  /// 免费额度耗尽:主动切断隧道(不报节点异常),本地置耗尽让按钮灰化,并拉 me 校准。
  Future<void> _onFreeQuotaExhausted() async {
    _freeRemainingSec = null;
    _userDisconnect = true; // 视为主动断开,不触发「节点异常」
    _offNotice = _ref.read(appTextProvider).quotaExhaustedNotice;
    _ref.read(quotaProvider.notifier).markExhausted();
    logLine('Quota', 'free daily minutes used up → auto disconnect');
    await _disconnect();
  }

  void _stopElapsed() {
    _elapsed?.cancel();
    _elapsed = null;
    _connectedAt = null;
    _freeRemainingSec = null;
  }

  @override
  void dispose() {
    _statusSub?.cancel();
    _statsSub?.cancel();
    _authSub?.close();
    _stopElapsed();
    _stopWatchdog();
    _lifecycle?.dispose();
    _api?.dispose();
    super.dispose();
  }
}

// ── Provider ──────────────────────────────────────────────────────

final connectionProvider =
    StateNotifierProvider<ConnectionController, ConnectionState>(
  (ref) => ConnectionController(ref, ref.watch(vpnBridgeProvider)),
);

/// 内核实时统计流(上/下行瞬时速率、字节数)。连接页速度行的真实数据源。
final vpnStatsProvider = StreamProvider<VpnStatsEvent>(
  (ref) => ref.watch(vpnBridgeProvider).statsStream,
);

/// 按 authToken 造 ConnectApi 的工厂(支柱 1:接缝即接口)。默认走真控制面;
/// 测试 override 注入 MockClient,即可驱动「连接成功」路径而不打真网络。
typedef ConnectApiFactory = ConnectApi Function(String authToken);

final connectApiFactoryProvider = Provider<ConnectApiFactory>(
  (_) => (authToken) => ConnectApi(baseUrl: kApiBaseUrl, authToken: authToken),
);