namespace Flyshot.Native.Planning;

/// <summary>
/// 表示原生规划库加载、调用或数值计算失败。
/// </summary>
public sealed class NativePlanningException : Exception
{
    /// <summary>
    /// 初始化包含原生错误码和底层异常的规划异常。
    /// </summary>
    /// <param name="message">供调用方诊断的错误说明。</param>
    /// <param name="errorCode">Rust C ABI 返回的错误码；托管加载错误使用负数。</param>
    /// <param name="innerException">触发本异常的底层异常；没有时为 <see langword="null"/>。</param>
    public NativePlanningException(string message, int errorCode, Exception? innerException = null)
        : base(message, innerException)
    {
        ErrorCodeValue = errorCode;
    }

    /// <summary>
    /// 获取 Rust C ABI 错误码或托管互操作错误码。
    /// </summary>
    public int ErrorCodeValue { get; }
}