From 04041d0401e5b98e90a25196bcd757753555a539 Mon Sep 17 00:00:00 2001
From: Stevan Freeborn <65925598+StevanFreeborn@users.noreply.github.com>
Date: Thu, 2 Apr 2026 20:48:58 -0500
Subject: [PATCH] docs: document empty/whitespace passthrough behavior in
 ICryptoProvider

---
 .../Cryptography/ICryptoProvider.cs                           | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/StevanFreeborn.Extensions.Configuration.Secure/Cryptography/ICryptoProvider.cs b/src/StevanFreeborn.Extensions.Configuration.Secure/Cryptography/ICryptoProvider.cs
index b9ff163..90a9263 100644
--- a/src/StevanFreeborn.Extensions.Configuration.Secure/Cryptography/ICryptoProvider.cs
+++ b/src/StevanFreeborn.Extensions.Configuration.Secure/Cryptography/ICryptoProvider.cs
@@ -9,13 +9,13 @@ public interface ICryptoProvider
   /// Encrypts the provided plain text.
   /// </summary>
   /// <param name="plainText">The unencrypted string to be encrypted.</param>
-  /// <returns>The encrypted cipher text.</returns>
+  /// <returns>The encrypted cipher text. If <paramref name="plainText"/> is null, empty, or whitespace, it is returned unchanged.</returns>
   string Encrypt(string plainText);
 
   /// <summary>
   /// Decrypts the provided cipher text.
   /// </summary>
   /// <param name="cipherText">The encrypted string to be decrypted.</param>
-  /// <returns>The decrypted plain text.</returns>
+  /// <returns>The decrypted plain text. If <paramref name="cipherText"/> is null, empty, or whitespace, it is returned unchanged.</returns>
   string Decrypt(string cipherText);
 }
\ No newline at end of file