Genocs.WebApi.CQRS

Genocs.WebApi.CQRS — Agent Reference Documentation

Consumer Mode for Agents #

• Assume package is installed from NuGet.
• Do not rely on repository source code access.
• Prefer stable public APIs and extension methods documented here.
• If behavior is uncertain, fail safely and request package version and configuration details.

Purpose #

Genocs.WebApi.CQRS connects CQRS dispatching to the Genocs WebApi endpoint flow and offers optional runtime command/event contract exposure.

Quick Facts #

Install #

dotnet add package Genocs.WebApi.CQRS

Minimal Integration Recipe (Program.cs) #

using Genocs.Core.Builders;
using Genocs.WebApi;
using Genocs.WebApi.CQRS;

var builder = WebApplication.CreateBuilder(args);

IGenocsBuilder gnxBuilder = builder
    .AddGenocs()
    .AddWebApi()
    .AddInMemoryDispatcher();

gnxBuilder.Build();

var app = builder.Build();

app.UseDispatcherEndpoints(endpoints => endpoints
    .Post<CreateOrderCommand>("/orders")
    .Get<GetOrderQuery, OrderDto>("/orders/{id}"));

app.UsePublicContracts(attributeRequired: false, endpoint: "/_contracts");
app.Run();

Dependencies #

• Genocs.WebApi
• CQRS abstractions provided by Genocs packages in the host

Troubleshooting #

1. CQRS endpoints resolve but no command or query executes. Fix: Register the underlying ICommandDispatcher, IQueryDispatcher, and IEventDispatcher services in DI.
2. /_contracts returns empty or incomplete results. Fix: Ensure contract types are loaded at runtime and use the correct attributeRequired setting.