namespace Oms.Application.Integrations.SmallBagTrack;

public interface ISmallBagTrackOrderClient
{
    Task UpsertAsync(SmallBagTrackUpsertRequest request, CancellationToken cancellationToken = default);

    /// <summary>
    /// 追加一条生命周期轨迹节点（POST ProviderService/Track/Upsert），默认小包 orderType=1。
    /// </summary>
    Task AppendLifecycleTrackAsync(
        string orderNo,
        string trackCode,
        string? authorization = null,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// 追加生命周期轨迹节点，返回调用结果（用于按序编排）。
    /// </summary>
    Task<SmallBagTrackUpsertResult> AppendLifecycleTrackResultAsync(
        string orderNo,
        string trackCode,
        int orderType,
        string? authorization = null,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// 同步调用并返回完整请求/响应（仅调试）。
    /// </summary>
    Task<SmallBagTrackUpsertResult> UpsertDebugAsync(SmallBagTrackUpsertRequest request, CancellationToken cancellationToken = default);

    /// <summary>
    /// 创建/更新大包轨迹订单（POST ProviderService/Order/UpsertBigBag）。
    /// </summary>
    Task<SmallBagTrackUpsertResult> UpsertBigBagAsync(
        SmallBagTrackUpsertBigBagRequest request,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// 关联大包与小包（POST ProviderService/Order/Link）。
    /// </summary>
    Task<SmallBagTrackUpsertResult> LinkOrdersAsync(
        string parentOrderNo,
        int parentOrderType,
        IReadOnlyList<string> linkOrderNos,
        int linkOrderType,
        string? authorization = null,
        CancellationToken cancellationToken = default);
}