v3.0.2

FlexQuery.NET v3.0.2 Release Notes

Release date: 2026-06-22

Overview

v3.0.2 streamlines the AG Grid integration with a simplified, extension-method-based API and improves documentation for the adapter package. This release contains no breaking changes.

What's New

Simplified AG Grid API

The AG Grid adapter now provides extension methods on AgGridRequest and QueryOptions, removing the need to reference AgGridQueryOptionsParser directly.

Before (v3.0.1):

using FlexQuery.NET.Adapters.AgGrid.Parsers;

[HttpPost("grid")]
public async Task<IActionResult> GetGridData([FromBody] JsonElement payload)
{
    var options = AgGridQueryOptionsParser.Parse(payload);
    var result = await _context.Users.FlexQueryAsync<User>(options);
    return Ok(result);
}

After (v3.0.2):

[HttpPost("grid")]
public async Task<IActionResult> GetGridData([FromBody] AgGridRequest request)
{
    var options = request.ToQueryOptions();
    var result = await _context.Users.FlexQueryAsync<User>(options);
    return Ok(result);
}

New Extension Methods

Method	Description
AgGridRequest.ToQueryOptions()	Converts an AG Grid request into QueryOptions
QueryOptions.ApplyAgGridRequest(AgGridRequest)	Merges AG Grid filters, sorts, paging, grouping, and aggregates into an existing QueryOptions instance
string.FromAgGridJson()	Parses a raw JSON string into QueryOptions

---

Other Changes

• Documentation: README and AG Grid adapter guide updated to reflect the new simplified API.

---

Upgrading

Update the FlexQuery.NET.Adapters.AgGrid package to v3.0.2:

dotnet add package FlexQuery.NET.Adapters.AgGrid --version 3.0.2

No code migration is required — all existing AgGridQueryOptionsParser.Parse() calls continue to work. The new extension methods are optional.