| | | 1 | | using AsiBackbone.Core.Handshakes; |
| | | 2 | | |
| | | 3 | | namespace AsiBackbone.AspNetCore.Handshakes; |
| | | 4 | | |
| | | 5 | | /// <summary> |
| | | 6 | | /// Represents an ASP.NET Core-friendly acknowledgment challenge that a host can render using any UI or transport. |
| | | 7 | | /// </summary> |
| | | 8 | | public sealed class AsiBackboneAcknowledgmentChallenge |
| | | 9 | | { |
| | 29 | 10 | | internal AsiBackboneAcknowledgmentChallenge( |
| | 29 | 11 | | LiabilityHandshakeRequest handshakeRequest, |
| | 29 | 12 | | string handshakeId, |
| | 29 | 13 | | string operationName, |
| | 29 | 14 | | string reasonCode, |
| | 29 | 15 | | string? reasonMessage, |
| | 29 | 16 | | string requiredAcknowledgmentCode, |
| | 29 | 17 | | string requiredAcknowledgmentText, |
| | 29 | 18 | | LiabilityHandshakeRiskLevel riskLevel, |
| | 29 | 19 | | string? riskCategory, |
| | 29 | 20 | | string? correlationId, |
| | 29 | 21 | | string? traceId, |
| | 29 | 22 | | string? policyVersion, |
| | 29 | 23 | | string? policyHash, |
| | 29 | 24 | | IReadOnlyDictionary<string, string> metadata) |
| | | 25 | | { |
| | | 26 | | // Defensive validation for internal construction invariants. |
| | | 27 | | // Public inputs are validated through FromHandshakeRequest and LiabilityHandshakeRequest. |
| | 29 | 28 | | ArgumentNullException.ThrowIfNull(handshakeRequest); |
| | 28 | 29 | | ArgumentException.ThrowIfNullOrWhiteSpace(handshakeId); |
| | 27 | 30 | | ArgumentException.ThrowIfNullOrWhiteSpace(operationName); |
| | 26 | 31 | | ArgumentException.ThrowIfNullOrWhiteSpace(reasonCode); |
| | 25 | 32 | | ArgumentException.ThrowIfNullOrWhiteSpace(requiredAcknowledgmentCode); |
| | 24 | 33 | | ArgumentException.ThrowIfNullOrWhiteSpace(requiredAcknowledgmentText); |
| | | 34 | | |
| | 23 | 35 | | HandshakeRequest = handshakeRequest; |
| | 23 | 36 | | HandshakeId = handshakeId.Trim(); |
| | 23 | 37 | | OperationName = operationName.Trim(); |
| | 23 | 38 | | ReasonCode = reasonCode.Trim(); |
| | 23 | 39 | | ReasonMessage = NormalizeOptional(reasonMessage); |
| | 23 | 40 | | RequiredAcknowledgmentCode = requiredAcknowledgmentCode.Trim(); |
| | 23 | 41 | | RequiredAcknowledgmentText = requiredAcknowledgmentText.Trim(); |
| | 23 | 42 | | RiskLevel = riskLevel; |
| | 23 | 43 | | RiskCategory = NormalizeOptional(riskCategory); |
| | 23 | 44 | | CorrelationId = NormalizeOptional(correlationId); |
| | 23 | 45 | | TraceId = NormalizeOptional(traceId); |
| | 23 | 46 | | PolicyVersion = NormalizeOptional(policyVersion); |
| | 23 | 47 | | PolicyHash = NormalizeOptional(policyHash); |
| | 23 | 48 | | Metadata = metadata; |
| | 23 | 49 | | } |
| | | 50 | | |
| | | 51 | | /// <summary> |
| | | 52 | | /// Gets the framework-neutral Core handshake request used for round-tripping acknowledgment responses. |
| | | 53 | | /// </summary> |
| | 9 | 54 | | public LiabilityHandshakeRequest HandshakeRequest { get; } |
| | | 55 | | |
| | | 56 | | /// <summary> |
| | | 57 | | /// Gets the stable handshake identifier. |
| | | 58 | | /// </summary> |
| | 24 | 59 | | public string HandshakeId { get; } |
| | | 60 | | |
| | | 61 | | /// <summary> |
| | | 62 | | /// Gets the operation name requiring acknowledgment. |
| | | 63 | | /// </summary> |
| | 2 | 64 | | public string OperationName { get; } |
| | | 65 | | |
| | | 66 | | /// <summary> |
| | | 67 | | /// Gets the machine-readable reason code for the challenge. |
| | | 68 | | /// </summary> |
| | 3 | 69 | | public string ReasonCode { get; } |
| | | 70 | | |
| | | 71 | | /// <summary> |
| | | 72 | | /// Gets the optional user-facing reason message for the challenge. |
| | | 73 | | /// </summary> |
| | 5 | 74 | | public string? ReasonMessage { get; } |
| | | 75 | | |
| | | 76 | | /// <summary> |
| | | 77 | | /// Gets the required acknowledgment code. |
| | | 78 | | /// </summary> |
| | 15 | 79 | | public string RequiredAcknowledgmentCode { get; } |
| | | 80 | | |
| | | 81 | | /// <summary> |
| | | 82 | | /// Gets the required acknowledgment text. |
| | | 83 | | /// </summary> |
| | 2 | 84 | | public string RequiredAcknowledgmentText { get; } |
| | | 85 | | |
| | | 86 | | /// <summary> |
| | | 87 | | /// Gets the risk level associated with the challenge. |
| | | 88 | | /// </summary> |
| | 2 | 89 | | public LiabilityHandshakeRiskLevel RiskLevel { get; } |
| | | 90 | | |
| | | 91 | | /// <summary> |
| | | 92 | | /// Gets the optional host-defined risk category. |
| | | 93 | | /// </summary> |
| | 2 | 94 | | public string? RiskCategory { get; } |
| | | 95 | | |
| | | 96 | | /// <summary> |
| | | 97 | | /// Gets the correlation identifier associated with the challenge. |
| | | 98 | | /// </summary> |
| | 4 | 99 | | public string? CorrelationId { get; } |
| | | 100 | | |
| | | 101 | | /// <summary> |
| | | 102 | | /// Gets the optional trace identifier associated with the challenge. |
| | | 103 | | /// </summary> |
| | 5 | 104 | | public string? TraceId { get; } |
| | | 105 | | |
| | | 106 | | /// <summary> |
| | | 107 | | /// Gets the optional policy version associated with the challenge. |
| | | 108 | | /// </summary> |
| | 5 | 109 | | public string? PolicyVersion { get; } |
| | | 110 | | |
| | | 111 | | /// <summary> |
| | | 112 | | /// Gets the optional policy hash associated with the challenge. |
| | | 113 | | /// </summary> |
| | 5 | 114 | | public string? PolicyHash { get; } |
| | | 115 | | |
| | | 116 | | /// <summary> |
| | | 117 | | /// Gets additional host-provided challenge metadata. |
| | | 118 | | /// </summary> |
| | 7 | 119 | | public IReadOnlyDictionary<string, string> Metadata { get; } |
| | | 120 | | |
| | | 121 | | /// <summary> |
| | | 122 | | /// Creates a host-friendly challenge from a Core handshake request. |
| | | 123 | | /// </summary> |
| | | 124 | | /// <param name="request">The Core handshake request.</param> |
| | | 125 | | /// <param name="options">The challenge options.</param> |
| | | 126 | | /// <returns>A host-friendly acknowledgment challenge.</returns> |
| | | 127 | | public static AsiBackboneAcknowledgmentChallenge FromHandshakeRequest( |
| | | 128 | | LiabilityHandshakeRequest request, |
| | | 129 | | AsiBackboneAcknowledgmentChallengeOptions? options = null) |
| | | 130 | | { |
| | 25 | 131 | | ArgumentNullException.ThrowIfNull(request); |
| | 24 | 132 | | options ??= new AsiBackboneAcknowledgmentChallengeOptions(); |
| | 24 | 133 | | options.Validate(); |
| | | 134 | | |
| | 23 | 135 | | return new AsiBackboneAcknowledgmentChallenge( |
| | 23 | 136 | | request, |
| | 23 | 137 | | request.HandshakeId, |
| | 23 | 138 | | request.OperationName, |
| | 23 | 139 | | request.ReasonCode, |
| | 23 | 140 | | options.IncludeReasonMessage ? request.Message : null, |
| | 23 | 141 | | request.RequiredAcknowledgmentCode, |
| | 23 | 142 | | request.RequiredAcknowledgmentText, |
| | 23 | 143 | | request.RiskLevel, |
| | 23 | 144 | | request.RiskCategory, |
| | 23 | 145 | | request.CorrelationId, |
| | 23 | 146 | | options.IncludeTraceId ? request.TraceId : null, |
| | 23 | 147 | | options.IncludePolicyMetadata ? request.PolicyVersion : null, |
| | 23 | 148 | | options.IncludePolicyMetadata ? request.PolicyHash : null, |
| | 23 | 149 | | request.Metadata); |
| | | 150 | | } |
| | | 151 | | |
| | | 152 | | private static string? NormalizeOptional(string? value) |
| | | 153 | | { |
| | 138 | 154 | | return string.IsNullOrWhiteSpace(value) |
| | 138 | 155 | | ? null |
| | 138 | 156 | | : value.Trim(); |
| | | 157 | | } |
| | | 158 | | } |