using System;

namespace Svrnty.CQRS.Sagas.Abstractions.Messaging;

/// <summary>
/// Response message from a saga step execution.
/// </summary>
public record SagaStepResponse
{
    /// <summary>
    /// Unique identifier for this response.
    /// </summary>
    public Guid MessageId { get; init; } = Guid.NewGuid();

    /// <summary>
    /// The saga instance ID.
    /// </summary>
    public Guid SagaId { get; init; }

    /// <summary>
    /// Correlation ID for tracing across services.
    /// </summary>
    public Guid CorrelationId { get; init; }

    /// <summary>
    /// Name of the saga step that this response is for.
    /// </summary>
    public string StepName { get; init; } = string.Empty;

    /// <summary>
    /// Whether the step executed successfully.
    /// </summary>
    public bool Success { get; init; }

    /// <summary>
    /// Fully qualified type name of the result (if any).
    /// </summary>
    public string? ResultType { get; init; }

    /// <summary>
    /// Serialized result payload (JSON).
    /// </summary>
    public string? ResultPayload { get; init; }

    /// <summary>
    /// Error message if the step failed.
    /// </summary>
    public string? ErrorMessage { get; init; }

    /// <summary>
    /// Stack trace if the step failed (for debugging).
    /// </summary>
    public string? StackTrace { get; init; }

    /// <summary>
    /// When the response was created.
    /// </summary>
    public DateTimeOffset Timestamp { get; init; } = DateTimeOffset.UtcNow;
}