msgexchange-v2/src/main/kotlin/com/gzzn/omms/msgexchange/codec/XmlCodec.kt

package com.gzzn.omms.msgexchange.codec

import com.gzzn.omms.msgexchange.domain.DecodedMessage
import com.gzzn.omms.msgexchange.domain.ErrorClass

/**
 * ACMA-8 流程 2：解码失败分类（矩阵/状态机：MALFORMED 不重试；CODEC_ERROR 可一键重放）。
 */
data class DecodeFailure(val errorClass: ErrorClass, val detail: String)

sealed interface DecodeResult {
    data class Ok(val message: DecodedMessage) : DecodeResult
    data class Err(val failure: DecodeFailure) : DecodeResult
}

/**
 * XML codec：使用 SIS 文档对应的 Jackson XML 注解 DTO，再显式转换为领域载荷；
 * XMLInputFactory 禁用 DTD/外部实体，原文仍由入站层保留。
 */
interface XmlCodec {
    fun decode(rawXml: String): DecodeResult
    fun encodeRqrd(kind: String, rangeJson: String): String
}