feat(mssql): support (local) aliases and Data Source in connection strings

Author: vkuttyp

Directory.Build.props

@@ -7,6 +7,6 @@
     <Authors>vkuttyp</Authors>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
     <RepositoryUrl>https://github.com/vkuttyp/CosmoSQLClient-Dotnet</RepositoryUrl>
-    <Version>1.5.7</Version>
+    <Version>1.5.8</Version>
   </PropertyGroup>
 </Project>

src/CosmoSQLClient.MsSql/MsSqlConnection.cs

@@ -24,18 +24,19 @@ public sealed record MsSqlConfiguration
     /// </summary>
     public string? InstanceName     { get; init; }
     public required string Database { get; init; }
-    public required string Username { get; init; }
-    public required string Password { get; init; }
+    public string? Username         { get; init; }
+    public string? Password         { get; init; }
     /// <summary>Optional Windows domain for NTLM auth.</summary>
     public string? Domain           { get; init; }
+    public bool IntegratedSecurity  { get; init; } = false;
     public bool TrustServerCertificate { get; init; } = false;
     public bool Encrypt             { get; init; } = true;
     public int  ConnectTimeout      { get; init; } = 30;
     public string AppName           { get; init; } = "CosmoSQLClient";
 
     /// <summary>
     /// Parse a SQL Server connection string.
-    /// Supports: Server=host,port; Database=...; User Id=...; Password=...; Encrypt=...; TrustServerCertificate=...
+    /// Supports: Server=host,port; Database=...; User Id=...; Password=...; Encrypt=...; TrustServerCertificate=...; Integrated Security=True
     /// </summary>
     public static MsSqlConfiguration Parse(string connectionString)
     {
@@ -54,8 +55,12 @@ public static MsSqlConfiguration Parse(string connectionString)
             return null;
         }
 
-        var server = Get("Server", "Data Source", "DataSource")
+        var server = Get("Server", "Data Source", "DataSource", "Address", "Addr", "Network Address")
             ?? throw new ArgumentException("Connection string missing 'Server'.");
+        
+        // Handle (local) and . aliases
+        if (server == "(local)" || server == ".") server = "localhost";
+
         string host = server;
         int port = 1433;
         string? instanceName = null;
@@ -81,18 +86,22 @@ public static MsSqlConfiguration Parse(string connectionString)
         bool trustCert = string.Equals(Get("TrustServerCertificate"), "true", StringComparison.OrdinalIgnoreCase)
                       || string.Equals(Get("TrustServerCertificate"), "yes",  StringComparison.OrdinalIgnoreCase);
 
+        bool integratedSecurity = string.Equals(Get("Integrated Security"), "true", StringComparison.OrdinalIgnoreCase)
+                               || string.Equals(Get("Integrated Security"), "sspi", StringComparison.OrdinalIgnoreCase)
+                               || string.Equals(Get("Trusted_Connection"),  "true", StringComparison.OrdinalIgnoreCase)
+                               || string.Equals(Get("Trusted_Connection"),  "yes",  StringComparison.OrdinalIgnoreCase);
+
         return new MsSqlConfiguration
         {
             Host         = host,
             Port         = port,
             InstanceName = instanceName,
             Database = Get("Database", "Initial Catalog", "InitialCatalog")
                           ?? throw new ArgumentException("Connection string missing 'Database'."),
-            Username = Get("User Id", "User ID", "UserId", "UID", "User")
-                          ?? throw new ArgumentException("Connection string missing 'User Id'."),
-            Password = Get("Password", "PWD", "PW")
-                          ?? throw new ArgumentException("Connection string missing 'Password'."),
+            Username = Get("User Id", "User ID", "UserId", "UID", "User"),
+            Password = Get("Password", "PWD", "PW"),
             Domain   = Get("Domain"),
+            IntegratedSecurity = integratedSecurity,
             Encrypt  = encrypt,
             TrustServerCertificate = trustCert,
         };
@@ -647,12 +656,17 @@ await WritePacketsAsync(TdsPacketType.PreLogin, TdsPreLogin.BuildRequest(wantEnc
         }
 
         // ── Login7 ────────────────────────────────────────────────────────────
+        if (_config.IntegratedSecurity && string.IsNullOrEmpty(_config.Username))
+        {
+            throw SqlException.Auth("Integrated Security (SSPI) is not yet supported by this driver. Please provide a User Id and Password.");
+        }
+
         var loginPayload = TdsLogin7.Build(new TdsLogin7.Options
         {
             Host     = _config.Host,
             Database = _config.Database,
-            Username = _config.Username,
-            Password = _config.Password,
+            Username = _config.Username ?? string.Empty,
+            Password = _config.Password ?? string.Empty,
             Domain   = _config.Domain,
             AppName  = _config.AppName,
         });

src/CosmoSQLClient.MsSql/Tds/TdsLogin7.cs

@@ -25,13 +25,13 @@ private enum TypeFlags   : byte { SqlType = 0x00 }
 
     public sealed class Options
     {
-        public required string Host     { get; init; }
-        public required string Database { get; init; }
-        public required string Username { get; init; }
-        public required string Password { get; init; }
-        public string? Domain           { get; init; }
-        public string AppName           { get; init; } = "CosmoSQLClient";
-        public string Language          { get; init; } = "us_english";
+        public required string  Host     { get; init; }
+        public required string  Database { get; init; }
+        public string?          Username { get; init; }
+        public string?          Password { get; init; }
+        public string?          Domain   { get; init; }
+        public string           AppName  { get; init; } = "CosmoSQLClient";
+        public string           Language { get; init; } = "us_english";
     }
 
     /// <summary>Build Login7 payload bytes (without the TDS packet header).</summary>
@@ -68,8 +68,8 @@ public static byte[] Build(Options opts)
         var fields = new List<(string? name, byte[]? bytes)>
         {
             (opts.Host,     null),
-            (opts.Username, null),
-            (null,          ObfuscatePassword(opts.Password)),
+            (opts.Username ?? string.Empty, null),
+            (null,          ObfuscatePassword(opts.Password ?? string.Empty)),
             (opts.AppName,  null),
             (opts.Host,     null),  // ServerName
             (null,          null),  // Extension