| | | 1 | | namespace AsiBackbone.Core.Emissions; |
| | | 2 | | |
| | | 3 | | /// <summary> |
| | | 4 | | /// Represents provider-neutral error information for a governance emission attempt. |
| | | 5 | | /// </summary> |
| | | 6 | | public sealed class GovernanceEmissionError |
| | | 7 | | { |
| | 166 | 8 | | private GovernanceEmissionError( |
| | 166 | 9 | | string code, |
| | 166 | 10 | | string message, |
| | 166 | 11 | | bool isRetryable, |
| | 166 | 12 | | string? providerName, |
| | 166 | 13 | | string? providerErrorCode) |
| | | 14 | | { |
| | 166 | 15 | | ArgumentException.ThrowIfNullOrWhiteSpace(code); |
| | 163 | 16 | | ArgumentException.ThrowIfNullOrWhiteSpace(message); |
| | | 17 | | |
| | 160 | 18 | | Code = code.Trim(); |
| | 160 | 19 | | Message = message.Trim(); |
| | 160 | 20 | | IsRetryable = isRetryable; |
| | 160 | 21 | | ProviderName = NormalizeOptional(providerName); |
| | 160 | 22 | | ProviderErrorCode = NormalizeOptional(providerErrorCode); |
| | 160 | 23 | | } |
| | | 24 | | |
| | | 25 | | /// <summary> |
| | | 26 | | /// Gets the provider-neutral error code. |
| | | 27 | | /// </summary> |
| | | 28 | | public string Code { get; } |
| | | 29 | | |
| | | 30 | | /// <summary> |
| | | 31 | | /// Gets the provider-neutral diagnostic message. |
| | | 32 | | /// </summary> |
| | | 33 | | public string Message { get; } |
| | | 34 | | |
| | | 35 | | /// <summary> |
| | | 36 | | /// Gets a value indicating whether the error is expected to be retryable. |
| | | 37 | | /// </summary> |
| | | 38 | | public bool IsRetryable { get; } |
| | | 39 | | |
| | | 40 | | /// <summary> |
| | | 41 | | /// Gets the provider name associated with the error, when available. |
| | | 42 | | /// </summary> |
| | | 43 | | public string? ProviderName { get; } |
| | | 44 | | |
| | | 45 | | /// <summary> |
| | | 46 | | /// Gets the provider-specific error code, when safe and available. |
| | | 47 | | /// </summary> |
| | | 48 | | public string? ProviderErrorCode { get; } |
| | | 49 | | |
| | | 50 | | /// <summary> |
| | | 51 | | /// Creates provider-neutral error information for a governance emission attempt. |
| | | 52 | | /// </summary> |
| | | 53 | | /// <param name="code">The provider-neutral error code.</param> |
| | | 54 | | /// <param name="message">The provider-neutral diagnostic message.</param> |
| | | 55 | | /// <param name="isRetryable">A value indicating whether the error is expected to be retryable.</param> |
| | | 56 | | /// <param name="providerName">Optional provider name.</param> |
| | | 57 | | /// <param name="providerErrorCode">Optional provider-specific error code.</param> |
| | | 58 | | /// <returns>The governance emission error.</returns> |
| | | 59 | | public static GovernanceEmissionError Create( |
| | | 60 | | string code, |
| | | 61 | | string message, |
| | | 62 | | bool isRetryable = false, |
| | | 63 | | string? providerName = null, |
| | | 64 | | string? providerErrorCode = null) |
| | | 65 | | { |
| | 166 | 66 | | return new GovernanceEmissionError( |
| | 166 | 67 | | code, |
| | 166 | 68 | | message, |
| | 166 | 69 | | isRetryable, |
| | 166 | 70 | | providerName, |
| | 166 | 71 | | providerErrorCode); |
| | | 72 | | } |
| | | 73 | | |
| | | 74 | | private static string? NormalizeOptional(string? value) |
| | | 75 | | { |
| | 320 | 76 | | return string.IsNullOrWhiteSpace(value) |
| | 320 | 77 | | ? null |
| | 320 | 78 | | : value.Trim(); |
| | | 79 | | } |
| | | 80 | | } |