Scry.Client 0.1.0-beta.13

Scry.Client

Client-side LINQ provider for Scry. Write ordinary LINQ against the source-generated query models; Scry captures it, serializes it to the query AST, and sends it to the server. No EF dependency, so it stays small in a trimmed Blazor WebAssembly app and light in a WPF, Windows Forms, or console client.

This package also ships the Scry source generator, so a client project needs only a <ScryModelDll> path to the server model's built DLL — never a reference to it.

<a id='snippet-clientModelPath'></a>

<ScryModelDll>$(MSBuildThisFileDirectory)..\Sample.Model\bin\$(Configuration)\net10.0\Sample.Model.dll</ScryModelDll>

^{<a href='/samples/Sample.WebClient/Sample.WebClient.csproj#L7-L10' title='Snippet source file'>snippet source</a> | <a href='#snippet-clientModelPath' title='Start of snippet'>anchor</a>}

A model shipped as a NuGet package is pointed at inside the package, which is downloaded and never referenced: see The model as a package.

Register the client over a named HttpClient, so its base address — and any handler pipeline it grows — stays separate from every other call the application makes:

<a id='snippet-clientRegistration'></a>

var services = builder.Services;
services.AddHttpClient(
    "scry",
    _ => _.BaseAddress = new(builder.HostEnvironment.BaseAddress));
services.AddScryClient(
    "/api/query",
    _ => _.GetRequiredService<IHttpClientFactory>().CreateClient("scry"));
services.AddScoped<ScryQuery>();

^{<a href='/samples/Sample.WebClient/Program.cs#L14-L23' title='Snippet source file'>snippet source</a> | <a href='#snippet-clientRegistration' title='Start of snippet'>anchor</a>}

Blazor WebAssembly is the exception: there is one HttpClient, the browser backs it, and it already points at the app's own origin, so nothing needs disambiguating and the shorter overload avoids pulling Microsoft.Extensions.Http into the payload.

<a id='snippet-clientWasmRegistration'></a>

services.AddScoped(
    _ => new HttpClient
    {
        BaseAddress = new("https://localhost")
    });
services.AddScryClient("/api/query");
services.AddScoped<ScryQuery>();

^{<a href='/samples/Sample.Tests/ClientRegistrationTests.cs#L19-L27' title='Snippet source file'>snippet source</a> | <a href='#snippet-clientWasmRegistration' title='Start of snippet'>anchor</a>}

<a id='snippet-clientQuery'></a>

employees = await Query
    .Employee
    .Where(_ => _.Active)
    .OrderBy(_ => _.Name)
    .Select(_ => new EmployeeRow(_.Name, _.Status, _.Manager!.Name, _.Department!.Name))
    .ToListAsync();

^{<a href='/samples/Sample.WebClient/Pages/Index.razor.cs#L82-L89' title='Snippet source file'>snippet source</a> | <a href='#snippet-clientQuery' title='Start of snippet'>anchor</a>}

Docs: Getting started · Writing queries · Source generator · The model as a package