Release v2.1.0 — structured schema types

Author: diegoripera

CHANGELOG.md

@@ -5,6 +5,88 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [2.1.0] — 2026-03-30
+
+### ⚠️ Breaking Changes
+
+| Area | Before | After |
+|------|--------|-------|
+| **`TableColumn.TypeName`** | `string` — e.g. `"Long Integer"` | **Removed** — replaced by `Type` (`System.Type`) |
+| **`TableColumn.SizeDesc`** | `string` — e.g. `"4 bytes"` | **Removed** — replaced by `Size` (`ColumnSize` struct) |
+| **`ReadFirstTable()`** | Returned `TableResult` | Now returns `FirstTableResult` (subclass of `TableResult`) |
+| **`GetTableStats()`** | Returned `List<(string Name, long RowCount, int ColumnCount)>` | Now returns `List<TableStat>` |
+| **`TableResult`** | `sealed` class | Unsealed — serves as base class for `FirstTableResult` |
+
+### ✨ New Types
+
+| Type | Description |
+|------|-------------|
+| `ColumnSizeUnit` | Enum: `Bits`, `Bytes`, `Chars`, `Variable`, `Lval` |
+| `ColumnSize` | Readonly struct — `Value` (`int?`) + `Unit` (`ColumnSizeUnit`). Factory methods: `FromBits`, `FromBytes`, `FromChars`. Sentinels: `Variable`, `Lval`. `ToString()` produces a human-readable description. |
+| `FirstTableResult` | Extends `TableResult` with `TableCount` (`int`) — the total number of user tables in the database. Returned by `ReadFirstTable()`. |
+| `TableStat` | Named class with `Name` (`string`), `RowCount` (`long`), `ColumnCount` (`int`). Returned as element of `List<TableStat>` from `GetTableStats()`. |
+
+### 🔧 Improvements
+
+- **`TableResult`** gains `TableName` (`string`) — the table this result was read from — and `RowCount` (`int`) computed property.
+- **`TableColumn.Type`** (`System.Type`) — exact CLR type, consistent with `ColumnMetadata.ClrType`.
+- **`TableColumn.Size`** (`ColumnSize`) — structured size with programmatic access to numeric value and unit; `ToString()` preserves the previous human-readable output.
+
+### 📦 Migration Guide
+
+```csharp
+// ── TableColumn schema properties ────────────────────────────────────
+// Before
+string typeName = col.TypeName;   // "Long Integer"
+string sizeDesc = col.SizeDesc;   // "4 bytes"
+// After
+Type   clrType  = col.Type;                    // typeof(int)
+int?   bytes    = col.Size.Value;              // 4
+string display  = col.Size.ToString();         // "4 bytes"
+bool   isVar    = col.Size.Unit == ColumnSizeUnit.Variable;
+
+// ── ReadFirstTable ────────────────────────────────────────────────────
+// Before
+TableResult      r = reader.ReadFirstTable();
+// After
+FirstTableResult r = reader.ReadFirstTable();
+int total = r.TableCount;   // new property on FirstTableResult
+
+// ── GetTableStats ─────────────────────────────────────────────────────
+// Before — tuple list
+foreach (var (name, rows, cols) in reader.GetTableStats()) { ... }
+// After — named class
+foreach (TableStat s in reader.GetTableStats())
+    Console.WriteLine($"{s.Name}: {s.RowCount} rows, {s.ColumnCount} cols");
+```
+
+---
+
+## [2.0.1] — 2026-03-29
+
+### ⚠️ Breaking Changes
+
+| Before | After | Notes |
+|--------|-------|-------|
+| `TablePreviewResult` | `TableResult` | Renamed for clarity — remove the `Preview` prefix |
+| `TablePreviewColumn` | `TableColumn` | Renamed for clarity — remove the `Preview` prefix |
+
+### 📦 Migration Guide
+
+```csharp
+// Before
+TablePreviewResult p = r.ReadTable("Orders", 10);
+foreach (TablePreviewColumn col in p.Schema)
+    Console.WriteLine($"{col.Name}: {col.TypeName} ({col.SizeDesc})");
+
+// After
+TableResult p = r.ReadTable("Orders", 10);
+foreach (TableColumn col in p.Schema)
+    Console.WriteLine($"{col.Name}: {col.TypeName} ({col.SizeDesc})");
+```
+
+---
+
 ## [2.0.0] — 2026-03-28
 
 ### ⚠️ Breaking Changes
@@ -23,9 +105,9 @@ This project follows [Semantic Versioning](https://semver.org/).
 | Method | Description |
 |--------|-------------|
 | `ReadTable()` | Primary read method — typed `DataTable` (replaces `ReadTableAsDataTableTyped`) |
-| `ReadTable(string, int)` | Sampled-rows overload — returns `TableResult` (headers, rows, schema) |
+| `ReadTable(string, int)` | Sampled-rows overload — returns `TablePreviewResult` (headers, rows, schema) |
 | `ReadTableAsync()` | Async typed `DataTable` |
-| `ReadTableAsync(string, int)` | Async sampled-rows overload — returns `Task<TableResult>` |
+| `ReadTableAsync(string, int)` | Async sampled-rows overload — returns `Task<TablePreviewResult>` |
 | `StreamRowsAsStrings()` | Compatibility streaming — `IEnumerable<string[]>` |
 | `ReadAllTablesAsStrings()` | Bulk read with string columns |
 | `ReadAllTablesAsStringsAsync()` | Async bulk read with string columns |
@@ -38,8 +120,8 @@ This project follows [Semantic Versioning](https://semver.org/).
 | `TableQuery.Count()` / `CountAsStrings()` | Count per chain |
 | `GetColumnMetadata()` | Rich per-column metadata with CLR type |
 | `GetStatistics()` / `GetStatisticsAsync()` | Database-level statistics + cache hit rate |
-| `TableResult` | Result type for sampled-rows overload — `Headers`, `Rows`, `Schema` |
-| `TableColumn` | Schema entry — `Name`, `TypeName`, `SizeDesc` |
+| `TablePreviewResult` | Result type for sampled-rows overload — `Headers`, `Rows`, `Schema` |
+| `TablePreviewColumn` | Schema entry — `Name`, `TypeName` (`string`), `SizeDesc` (`string`) |
 
 ### 🔧 Improvements
 
@@ -76,7 +158,7 @@ DataTable dt = r.ReadTableAsStringDataTable("Orders");
 // v1
 var (h, rows, schema) = r.ReadTable("Orders", maxRows: 10);
 // v2
-TableResult p = r.ReadTable("Orders", 10);
+TablePreviewResult p = r.ReadTable("Orders", 10);
 // p.Headers / p.Rows / p.Schema[i].Name, .TypeName, .SizeDesc
 
 // ── Stream rows (typed) ──────────────────────────────────────────────

JetDatabaseReader.Tests/Core/AccessReaderCoreTests.cs

@@ -228,11 +228,11 @@ public void ReadFirstTable_ReturnsNonEmptyHeadersAndTableName(string path)
         {
             using var reader = TestDatabases.Open(path);
 
-            var (headers, _, tableName, tableCount) = reader.ReadFirstTable();
+            FirstTableResult result = reader.ReadFirstTable();
 
-            headers.Should().NotBeEmpty();
-            tableName.Should().NotBeNullOrWhiteSpace();
-            tableCount.Should().BeGreaterThan(0);
+            result.Headers.Should().NotBeEmpty();
+            result.TableName.Should().NotBeNullOrWhiteSpace();
+            result.TableCount.Should().BeGreaterThan(0);
         }
 
         // ── ReadTable (preview overload) ──────────────────────────────────