feat: add ToClrObject() public method to SqlValue

Returns the CLR-native boxed value (DBNull.Value for Null)
for use with DataRow, DataGridView and any code that needs
an object without pattern-matching on SqlValue subtypes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: vkuttyp

src/SqlDotnetty.Core/ISqlDatabase.cs

@@ -94,7 +94,7 @@ public static async Task<SqlValue> ScalarAsync(
 
                 var dataRow = dt.NewRow();
                 for (int i = 0; i < row.ColumnCount; i++)
-                    dataRow[i] = SqlValueToClr(row[i]);
+                    dataRow[i] = row[i].ToClrObject();
                 dt.Rows.Add(dataRow);
             }
         }
@@ -121,21 +121,5 @@ public static async Task<SqlValue> ScalarAsync(
         this ISqlDatabase db, string sql, params SqlParameter[] parameters)
         => db.QueryStreamAsync(sql, parameters).ToDataTableAsync();
 
-    private static object SqlValueToClr(SqlValue v) => v switch
-    {
-        SqlValue.Null      => DBNull.Value,
-        SqlValue.Bool b    => b.Value,
-        SqlValue.Int8 b    => b.Value,
-        SqlValue.Int16 s   => s.Value,
-        SqlValue.Int32 i   => i.Value,
-        SqlValue.Int64 l   => l.Value,
-        SqlValue.Float f   => f.Value,
-        SqlValue.Double d  => d.Value,
-        SqlValue.Decimal d => d.Value,
-        SqlValue.Text t    => t.Value,
-        SqlValue.Bytes b   => b.Value,
-        SqlValue.Uuid u    => u.Value,
-        SqlValue.Date d    => d.Value,
-        _                  => DBNull.Value,
-    };
+    private static object SqlValueToClr(SqlValue v) => v.ToClrObject();
 }

src/SqlDotnetty.Core/SqlValue.cs

@@ -102,6 +102,25 @@ public sealed record Date(DateTime Value) : SqlValue;
     public byte[]?   AsBytes()   => this is Bytes b ? b.Value : null;
     public bool      IsNull      => this is Null;
 
+    /// <summary>Returns the CLR-native value for use with DataRow, DataGridView, etc.</summary>
+    public object ToClrObject() => this switch
+    {
+        Null        => DBNull.Value,
+        Bool v      => v.Value,
+        Int8 v      => v.Value,
+        Int16 v     => v.Value,
+        Int32 v     => v.Value,
+        Int64 v     => v.Value,
+        Float v     => v.Value,
+        Double v    => v.Value,
+        Decimal v   => v.Value,
+        Text v      => v.Value,
+        Bytes v     => v.Value,
+        Uuid v      => v.Value,
+        Date v      => v.Value,
+        _           => DBNull.Value,
+    };
+
     public override string ToString() => this switch
     {
         Null      => "NULL",