docs: update README and CLAUDE.md for v4.0.0 API changes

- Update all code examples to instance-based API (create_table(T{}),
  select(col{}), from(T{}), etc.)
- Document execute() returning uint64_t affected row count
- Document new mysql_connection methods and connect_options
- Add charset_name and connect_options.hpp to header layout
- Fix truncate<T>() → truncate_table(T{}) in DML examples

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Pierre-Luc Gagné

CLAUDE.md

@@ -47,10 +47,12 @@ Style: Google-based, 120-char line limit, 4-space indent (`.clang-format` at roo
 ### Header Layout (`lib/include/ds_mysql/`)
 
 - `ds_mysql.hpp` — umbrella include; users include only this
-- `mysql_connection.hpp` — `mysql_config` and `mysql_connection` classes; `.query()` returns `std::expected<ResultType, std::string>`, `.execute()` for DDL/DML
-- `sql_ddl.hpp` — `create_table<T>()`, `drop_table<T>()`, `create_database<DB>()`, `create_all_tables<DB>()`
-- `sql_dml.hpp` — `insert_into<T>()`, `update<T>()`, `delete_from<T>()`, `truncate<T>()`
-- `sql_dql.hpp` — `select<...>()`, `count<T>()`, `describe<T>()`
+- `mysql_connection.hpp` — `mysql_config`, `connect_options`, and `mysql_connection` classes; `.query()` returns `std::expected<ResultType, std::string>`, `.execute()` returns `std::expected<uint64_t, std::string>` (affected row count); also provides `last_insert_id()`, `ping()`, `commit()`, `rollback()`, `autocommit()`, `select_db()`, `reset_connection()`, `escape_string()`, `warning_count()`, `info()`, `server_version()`, `server_info()`, `stat()`, `thread_id()`, `character_set()`, `set_character_set()`
+- `sql_ddl.hpp` — `create_table(T{})`, `drop_table(T{})`, `create_database(DB{})`, `create_all_tables(DB{})`
+- `sql_dml.hpp` — `insert_into(T{})`, `update(T{})`, `delete_from(T{})`, `truncate_table(T{})`
+- `sql_dql.hpp` — `select(col1{}, col2{})`, `count(T{})`, `describe(T{})`
+- `connect_options.hpp` — `connect_options` fluent builder and `ssl_mode` enum for pre-connect `mysql_options()` configuration (timeouts, SSL/TLS, charset, compression, etc.)
+- `charset_name.hpp` — `charset_name` strong type for character set names
 - `column_field.hpp` / `column_field_base_*.hpp` — `column_field<"name", Type>` descriptors and `COLUMN_FIELD(name, type)` macro
 - `schema_generator.hpp` — derives CREATE TABLE SQL from a C++ struct at compile time using Boost.PFR
 - `sql_varchar.hpp`, `sql_numeric.hpp`, `sql_temporal.hpp` — library-specific SQL types (`varchar_type<N>`, `decimal_type<P,S>`, `datetime_type<FSP>`, etc.)
@@ -61,7 +63,7 @@ Style: Google-based, 120-char line limit, 4-space indent (`.clang-format` at roo
 - Native C++ types map directly: `int32_t` → INT, `int64_t` → BIGINT, `double` → DOUBLE, `std::string` → TEXT
 - `std::optional<T>` → nullable column
 - `varchar_type<N>` → VARCHAR(N); `decimal_type<P,S>` → DECIMAL(P,S)
-- Strong-typed wrappers (`host_name`, `database_name`, `port_number`) enforce correct argument passing
+- Strong-typed wrappers (`host_name`, `database_name`, `port_number`, `charset_name`) enforce correct argument passing
 
 ### Schema Generation and Validation
 

README.md

@@ -61,7 +61,7 @@ struct product {
 // c) Fixed string literal — column name embedded directly, no tag needed.
 //    ⚠ Two tables with identically-named and -typed columns share the same C++ type,
 //    so column_field cannot verify which table a column belongs to. This means
-//    column_field columns cannot be used as select projections in from<Table>().
+//    from() cannot verify column membership for untagged column_field types.
 //    Prefer COLUMN_FIELD or explicit nested tags for query-building use cases.
 //   using price = column_field<"price", double>;
 //   price price_;
@@ -79,13 +79,13 @@ auto db = mysql_connection::connect(mysql_config{
 }).value();
 
 // CREATE TABLE IF NOT EXISTS product (...)
-db.execute(create_table<product>().if_not_exists());
+db.execute(create_table(product{}).if_not_exists());
 
 // Type-safe SELECT: returns std::expected<std::vector<std::tuple<uint32_t, varchar_type<255>>>, std::string>
-auto rows = db.query(select<product::id, product::name>()
-                         .from<product>()
-                         .where(product::price{9.99})
-                         .order_by<product::id>());
+auto rows = db.query(select(product::id{}, product::name{})
+                         .from(product{})
+                         .where(equal<product::price>(9.99))
+                         .order_by(product::id{}));
 
 for (auto const& [id, name] : *rows) {
     std::println("{}: {}", id, name.to_string());
@@ -201,15 +201,15 @@ auto db = mysql_connection::connect(cfg).value();
 ### DDL (CREATE, DROP)
 
 ```cpp
-db.execute(create_table<product>().if_not_exists());
-db.execute(drop_table<product>());
-db.execute(create_database<my_db>().if_not_exists());
+db.execute(create_table(product{}).if_not_exists());
+db.execute(drop_table(product{}));
+db.execute(create_database(my_db{}).if_not_exists());
 ```
 
 #### CREATE TABLE attributes (fluent API)
 
 ```cpp
-auto sql = create_table<product>()
+auto sql = create_table(product{})
                .if_not_exists()
                .engine(Engine::InnoDB)
                .auto_increment(1)
@@ -218,8 +218,8 @@ auto sql = create_table<product>()
                .comment("product catalog")
                .build_sql();
 
-auto ctas = create_table<product_archive>()
-                .as(select<product::id, product::name>().from<product>())
+auto ctas = create_table(product_archive{})
+                .as(select(product::id{}, product::name{}).from(product{}))
                 .engine("MyCustomEngine")
                 .default_charset("koi8r")
                 .build_sql();
@@ -228,28 +228,28 @@ auto ctas = create_table<product_archive>()
 ### DML (INSERT, UPDATE, DELETE)
 
 ```cpp
-db.execute(insert_into<product>().values(row));
-db.execute(update<product>().set(product::price{12.99}).where(product::id{1}));
-db.execute(delete_from<product>().where(product::id{1}));
-db.execute(truncate<product>());
+db.execute(insert_into(product{}).values(row));
+db.execute(update(product{}).set(product::price{12.99}).where(equal<product::id>(1u)));
+db.execute(delete_from(product{}).where(equal<product::id>(1u)));
+db.execute(truncate_table(product{}));
 ```
 
 ### DQL (SELECT, COUNT, DESCRIBE)
 
 ```cpp
 // Select specific columns
-auto rows = db.query(select<product::id, product::name>().from<product>());
+auto rows = db.query(select(product::id{}, product::name{}).from(product{}));
 
 // Select all columns
-auto all = db.query(select<product::id, product::sku, product::name, product::price>()
-                        .from<product>()
-                        .order_by<product::id>());
+auto all = db.query(select(product::id{}, product::sku{}, product::name{}, product::price{})
+                        .from(product{})
+                        .order_by(product::id{}));
 
 // Count
-auto cnt = db.query(count<product>().where(product::price{9.99}));
+auto cnt = db.query(count(product{}).where(equal<product::price>(9.99)));
 
 // DESCRIBE (schema introspection)
-auto cols = db.query(describe<product>());
+auto cols = db.query(describe(product{}));
 ```
 
 ### Schema Validation