Added #

• None

Changed #

• None

Removed #

• None

Fixed #

• None

Fixed #

• FFI buffer-retry reliability hardening:
  • preserved stream chunks across -2 retries in odbc_stream_fetch
  • preserved async payloads across -2 retries in odbc_async_get_result
  • avoided re-execution for -2 retries by serving pending payloads in: odbc_exec_query, odbc_exec_query_params, odbc_exec_query_multi, and odbc_execute
  • fixed odbc_get_driver_capabilities to return -2 (instead of truncating JSON with success)
• Added regression coverage for retry semantics in stream, async, and execute paths (including side-effect safety check for prepared execute retry).
• Removed CI flakiness in async invalid-request tests by avoiding ID collision between TEST_INVALID_ID and generated invalid test IDs.

Added #

• Schema reflection API for primary keys, foreign keys, and indexes:
  • catalogPrimaryKeys(connectionId, table) - Lists primary keys for a table
  • catalogForeignKeys(connectionId, table) - Lists foreign keys for a table
  • catalogIndexes(connectionId, table) - Lists indexes for a table (PRIMARY KEY and UNIQUE constraints)
• FFI exports: odbc_catalog_primary_keys, odbc_catalog_foreign_keys, odbc_catalog_indexes
• Full implementation from Rust engine -> FFI -> Dart bindings -> Repository -> Service
• Type mapping documentation consolidated:
  • Added "Type Mapping" section to README with implemented vs planned status
  • doc/notes/TYPE_MAPPING.md updated with verified implementation status
  • columnar_protocol.dart marked as experimental/not used
• Example: example/catalog_reflection_demo.dart
• Experimental typed parameter prototype:
  • SqlDataType, SqlTypedValue, and typedParam(...)
• Protocol performance benchmark suite:
  • test/performance/protocol_performance_test.dart

Changed #

• Reliability/performance hardening completed:
  • fail-fast nullability and per-type validation in BulkInsertBuilder.addRow()
  • text validation by character and UTF-8 byte length
  • canonical double mapping to fixed-scale decimal string
  • DateTime year range validation (1..9999)
  • complex unsupported-type error message construction via StringBuffer
• Documentation cleanup:
  • removed completed execution plans from doc/notes/
  • added Validation examples section in root README.md

Removed #

• Orphaned native/telemetry/ directory (not compiled in workspace; actual implementation is in native/odbc_engine/src/observability/telemetry/)

Fixed #

• Streaming integration stability and cleanup:
  • unique dynamic test tables and safer assertions
• CI reliability:
  • Rust fmt alignment and test thread safety adjustments

Added #

• workflow_dispatch support in publish workflow for manual pub.dev publishing

Changed #

• Documentation updates and release automation alignment

Added #

• Statement cancellation API exposed at high-level service/repository layers: cancelStatement(connectionId, stmtId)
• UnsupportedFeatureError in Dart domain errors for explicit unsupported capability reporting

Changed #

• Statement cancellation contract standardized as explicit unsupported at runtime (Option B path), with structured native error SQLSTATE 0A000
• Sync and async cancellation paths now aligned with equivalent behavior and consistent unsupported semantics
• Canonical docs aligned for cancellation status and workaround guidance: README.md, doc/TROUBLESHOOTING.md, example/README.md

Fixed #

• Removed ambiguity between exposed cancellation entrypoints and current runtime capability by returning explicit unsupported contract instead of implicit behavior

Added #

• New canonical type mapping documentation: doc/TYPE_MAPPING.md
• New implementation checklists:
  • doc/notes/TYPE_MAPPING_IMPLEMENTATION_CHECKLIST.md
  • doc/notes/STATEMENT_CANCELLATION_IMPLEMENTATION_CHECKLIST.md
  • doc/notes/NULL_HANDLING_RELIABILITY_PERFORMANCE_PLAN.md
• New/updated example coverage docs and demo files for advanced/service/telemetry scenarios

Changed #

• Root and docs indexes now reference canonical type-mapping documentation
• Master gaps plan now tracks open execution checklists for remaining gaps

Fixed #

• Documentation consistency across root README, doc/README.md, and notes references

Added #

• Documentation enhancement: Expanded examples section with detailed feature overview and advantages for each API level (High-Level, Low-Level, Async, Named Parameters, Multi-Result, Pooling, Streaming, Savepoints)

Changed #

• None

Fixed #

• None

Added #

• Test release for automated publishing

Changed #

• None

Fixed #

• None

Added #

• Async API request timeout: AsyncNativeOdbcConnection(requestTimeout: Duration?) — optional timeout per request; default 30s; Duration.zero or null disables
• AsyncError new codes: requestTimeout (worker did not respond in time), workerTerminated (disposed or crashed)
• Parallel bulk insert (pool-based) end-to-end: Rust FFI odbc_bulk_insert_parallel now implemented and exposed in Dart sync/async service/repository stack
• Bulk insert comparative benchmark: new ignored Rust E2E benchmark test e2e_bulk_compare_benchmark_test for ArrayBinding vs ParallelBulkInsert

Changed #

• Async dispose: Pending requests now complete with AsyncError (workerTerminated) instead of hanging when dispose() is called
• Worker crash handling: When the worker isolate dies, pending requests complete with error instead of hanging
• BinaryProtocolParser: Truncated buffers now throw FormatException('Buffer too small for payload') instead of RangeError

Fixed #

• Array binding tail chunk panic: fixed copy_from_slice length mismatch when the final bulk-insert chunk is smaller than configured batch size

Changed #

• Improved download experience: Native library download now includes retry logic with exponential backoff (up to 3 attempts)
• Better error messages: Download failures now show detailed troubleshooting steps and clearly explain what went wrong
• HTTP 404 handling: When GitHub release doesn't exist, provides clear instructions for production vs development scenarios
• Connection timeout: Added 30-second timeout to HTTP client to prevent hanging on slow connections
• Download feedback: Shows file size after successful download
• CI/pub.dev detection: Skip download in CI environments to avoid analysis timeout, with clear logging

Fixed #

• pub.dev analysis timeout: Hook now detects CI/pub.dev environment and skips external download, allowing pub.dev to analyze the package correctly

Added #

• Configurable result buffer size: ConnectionOptions.maxResultBufferBytes (optional). When set at connect time, caps the size of query result buffers for that connection; when null, the package default (16 MB) is used. Use for large result sets to avoid "Buffer too small" errors. Constant defaultMaxResultBufferBytes is exported for reference.

Fixed #

• Async API "QueryError: No error": when executing queries with no parameters, the Dart FFI was passing null for the params buffer to odbc_exec_query_params, which caused invalid arguments and led to failures reported as "No error". The native bindings now always pass a valid buffer (e.g. Uint8List(0)) instead of null, so both sync and async (worker) paths work correctly for parameterless queries.

Added #

• scripts/copy_odbc_dll.ps1: copies odbc_engine.dll from package (pub cache) to project root and Flutter runner folders (Debug/Release) for consumers who need the DLL manually

Changed #

• Publish hook/ and scripts/ in the package (removed from .pubignore): Native Assets hook runs for consumers so the DLL can be downloaded/cached automatically; script copy_odbc_dll.ps1 is available in the package
• Minimum SDK constraint raised to >=3.6.0 (required by pub.dev when publishing packages with build hooks)

Fixed #

• Async API (worker isolate): empty result (DDL/DML, SELECT with no rows) is now returned as Result.ok(QueryResult(columns: [], rows: [], rowCount: 0)) instead of Result.err(QueryError("No error", ...)) (fixes "No error" when executing CREATE TABLE, INSERT, ALTER, etc.)

Fixed #

• Native DLL cache now keyed by package version (~/.cache/odbc_fast/<version>/) to avoid loading an older DLL when upgrading the package (fixes symbol lookup error 127 for new symbols e.g. odbc_savepoint_create)

Added #

• README: "Support the project" section with Pix (buy developer a coffee)

Changed #

• Exclude test/my_test/ from pub package via .pubignore (domain-specific tests)
• README: installation example updated to ^0.2.6

Added #

• Database type detection in tests: detectDatabaseType(), skipIfDatabase(), skipUnlessDatabase()
• Test helpers for conditional execution by database (SQL Server, PostgreSQL, MySQL, Oracle)
• test/helpers/README.md with usage and examples

Changed #

• Dart tests run sequentially (--concurrency=1) to avoid resource contention (ServiceLocator, worker isolates)
• Savepoint release test skipped on SQL Server (RELEASE SAVEPOINT not supported)

Fixed #

• Rust FFI E2E: ffi_test_dsn() loads .env and checks ENABLE_E2E_TESTS; invalid stream ID race in tests
• Dart integration test timeouts when running in parallel

Added #

• Examples: multi-result, timeouts, typed params, and low-level wrappers

Changed #

• README: refresh API coverage and fix broken links

Changed #

• CI: run only unit tests that do not require real ODBC connection (domain, protocol, errors)
• CI: exclude stress, integration/e2e, and native-dependent tests from publish pipeline

Changed #

• Version bump for release

Fixed #

• Fixed Native Assets hook to read package version from correct pubspec.yaml
• Fixed test helper to properly handle empty environment variables
• Fixed GitHub Actions cache paths and key format

Changed #

• Improved CI workflow: now builds Rust library before running tests
• Split unit and integration tests in CI for better organization
• Enhanced GitHub Actions workflows with proper dependency installation

Added #

• Savepoints (nested transaction markers)
• Automatic retry with exponential backoff for transient errors
• Connection timeouts (login/connection timeout configuration)
• Connection String Builder (fluent API)
• Backpressure control in streaming queries

Changed #

• Async API with worker isolate for non-blocking operations
• Comprehensive E2E Rust tests with coverage reporting
• Improved documentation and troubleshooting guides

Fixed #

• Various lint issues (very_good_analysis compliance)
• Code formatting and cleanup

Added #

• Initial stable release
• Core ODBC functionality
• Streaming queries
• Connection pooling
• Prepared statements
• Transaction support
• Bulk insert operations
• Metrics and observability