# -*- coding: utf-8 -*-
"""
GetUserCharge.py —— 取用户票券（GetUserChargeApi）
================================================================================

取玩家的票券持有情况（真机 3 条）。

对应接口：GetUserChargeApi
请求体  ：UserIdRequestVO
响应    ：{userId, length, userChargeList:[{chargeId,stock,purchaseDate,validDate,extNum1}]}
依据    ：source/Assembly-CSharp/Net.VO.Mai2/UserChargeRequestVO.cs

★ 回传 Upsert 时要丢掉 extNum1（真机 Upsert 报文里没有这个字段）。

★ 调用本接口会**登记一次「票券已查询」**（见 api/ChargeGuard.py）。
  UpsertUserChargelog 发包前会检查这笔登记 —— 没查过票就买票会被直接拒绝。

调用示例：
    from api import GetUserCharge
"""

from __future__ import annotations

from typing import Any, Dict, Optional

from config import CLIENT_ID, TIMEOUT_MS

from .ChargeGuard import note_user_charge_read
from .LogSetup import log_info
from .MaimaiNet import MaimaiNetClient
from .UserGetterCommon import _get, UserIdRequestVO


def GetUserCharge(
    user_id: int,
    *,
    client_id: str = CLIENT_ID,
    timeout_ms: Optional[int] = None,
    client: Optional[MaimaiNetClient] = None,
) -> Dict[str, Any]:
    """
    取用户票券（对应 GetUserChargeApi）。

    返回：
        原始响应 dict，含 userChargeList
    """
    log_info("取用户票券：user_id=" + str(user_id))
    raw = _get("GetUserChargeApi", UserIdRequestVO(userId=user_id), user_id,
               client_id=client_id, timeout_ms=timeout_ms, client=client)

    # ★ 记一笔「这个账号刚查过票券」——
    #   UpsertUserChargelog 发包前会检查这笔记录，没查过就拒绝购买。
    #   见 api/ChargeGuard.py 的说明。
    lst = (raw.get("userChargeList") if isinstance(raw, dict) else None) or []
    note_user_charge_read(user_id, lst)
    held = [c for c in lst if isinstance(c, dict) and int(c.get("stock", 0) or 0) > 0]
    if held:
        log_info("★ 该账号当前持有 " + str(len(held)) + " 张功能票："
                 + "、".join("chargeId=" + str(c.get("chargeId"))
                             + " stock=" + str(c.get("stock")) for c in held))
    else:
        log_info("该账号当前没有持有功能票")
    return raw