# 批量信封。缺 data、空数组、超过 100 条：整包 422，一条都不落。
#
# 单条字段错误不走这里，由各收件函数逐条 REJECTED，HTTP 仍 200。

MAX_BATCH = 100


# 信封不合法，对应 HTTP 422。
class EnvelopeError(Exception):
    # 记下对外文案。
    def __init__(self, message: str):
        self.message = message


# 拆出 data 数组。不合法时抛 EnvelopeError，调用方整包拒绝。
def parse_envelope(payload: object) -> list:
    if not isinstance(payload, dict) or "data" not in payload:
        raise EnvelopeError("缺少批量数据节点 data")
    data = payload["data"]
    if not isinstance(data, list):
        raise EnvelopeError("data 必须是数组")
    if len(data) == 0:
        raise EnvelopeError("data 不能为空")
    if len(data) > MAX_BATCH:
        raise EnvelopeError("一批最多 100 条")
    return data