Problem
The library supports SQL Server, PostgreSQL, MySQL, and SQLite, but legacy SQL Server naming and metadata remain:
- Core public API is still named
SqlClient / IAsyncSqlClient
AssemblyInfo.cs describes "A simple Sql Server wrapper"
BulkOperations imports Microsoft.Data.SqlClient directly
config.json previously included unused ServerType: "MSSQL"
- LINQ infrastructure is still typed against
SqlClient in places
This creates confusion for consumers adopting non-SQL Server providers.
Proposed solution
Plan a phased migration:
- Documentation pass — clarify that
SqlClient is provider-agnostic despite the name
- Add aliases — introduce
DbClient / IDbClient as preferred names (keeping SqlClient as obsolete aliases initially)
- Update metadata — assembly description, XML docs, README terminology
- Breaking change release — remove obsolete names in a major version
Acceptance criteria
Notes
This is a potentially breaking API change. Coordinate with NuGet packaging (#25) and semver strategy.
Problem
The library supports SQL Server, PostgreSQL, MySQL, and SQLite, but legacy SQL Server naming and metadata remain:
SqlClient/IAsyncSqlClientAssemblyInfo.csdescribes "A simple Sql Server wrapper"BulkOperationsimportsMicrosoft.Data.SqlClientdirectlyconfig.jsonpreviously included unusedServerType: "MSSQL"SqlClientin placesThis creates confusion for consumers adopting non-SQL Server providers.
Proposed solution
Plan a phased migration:
SqlClientis provider-agnostic despite the nameDbClient/IDbClientas preferred names (keepingSqlClientas obsolete aliases initially)Acceptance criteria
Notes
This is a potentially breaking API change. Coordinate with NuGet packaging (#25) and semver strategy.