git.stella-ops.org/src/__Libraries/StellaOps.Messaging/Results/EnqueueResult.cs

namespace StellaOps.Messaging;

/// <summary>
/// Result of an enqueue operation.
/// </summary>
public readonly struct EnqueueResult
{
    /// <summary>
    /// Gets the message ID assigned by the queue.
    /// </summary>
    public string MessageId { get; init; }

    /// <summary>
    /// Gets whether the message was enqueued successfully.
    /// </summary>
    public bool Success { get; init; }

    /// <summary>
    /// Gets whether this was a duplicate message (idempotency).
    /// </summary>
    public bool WasDuplicate { get; init; }

    /// <summary>
    /// Gets the error message if the operation failed.
    /// </summary>
    public string? Error { get; init; }

    /// <summary>
    /// Creates a successful result.
    /// </summary>
    public static EnqueueResult Succeeded(string messageId, bool wasDuplicate = false) =>
        new() { MessageId = messageId, Success = true, WasDuplicate = wasDuplicate };

    /// <summary>
    /// Creates a failed result.
    /// </summary>
    public static EnqueueResult Failed(string error) =>
        new() { Success = false, Error = error, MessageId = string.Empty };

    /// <summary>
    /// Creates a duplicate result.
    /// </summary>
    public static EnqueueResult Duplicate(string messageId) =>
        new() { MessageId = messageId, Success = true, WasDuplicate = true };
}