Eternet.Mediator.Abstractions 3.0.31

Eternet.Mediator.Abstractions

Contratos públicos de Eternet.Mediator.

Incluye interfaces y tipos base para:

• requests y responses
• handlers y domain results
• semánticas públicas de API (IEndpointQuery<TResponse>, IEndpointCreate<TResponse>, IEndpointUpdate<TResponse>, IEndpointDelete<TResponse>, IEndpointUpsert<TResponse>)
• consumo vía IGetResponse<TResponse>
• selección contextual vía IGetResponseFactory
• contexto de ejecución HTTP (HttpEndpointExecutionContext)

Instalación

dotnet add package Eternet.Mediator.Abstractions

Breaking Changes in 3.0.0

Eternet.Mediator.Abstractions 3.0.0 no longer ships ScopedStates.

• Contracts should stay on request properties plus request.StepsResults.
• If a consumer still references ScopedStates or ScopedStateAccessor<T>, that consumer must remain on 2.x or migrate first.
• Runtime-owned helpers are now intentionally outside the public abstractions contract.

Migration guide: ../docs/scoped-states-breaking-change-v3.md

Cuándo usarlo

Usalo cuando necesites depender sólo de contratos mediator sin traer la implementación completa.

Si además necesitás atributos, runtime y extensiones de ejecución, usá Eternet.Mediator.

Semánticas públicas de API

Las interfaces IEndpointQuery<TResponse>, IEndpointCreate<TResponse>, IEndpointUpdate<TResponse>, IEndpointDelete<TResponse> e IEndpointUpsert<TResponse> son la forma recomendada de expresar la intención pública de un request.

Úsalas cuando el contrato público necesita seguir siendo la fuente de verdad para:

• EndpointGroup
• GenerateEndpoint
• endpoint manifest generation
• clientes HTTP generados
• el handler público del servidor que hereda el contrato

Cuándo usar cada interfaz

• IEndpointQuery<TResponse>: operaciones de lectura sin efectos de escritura persistente
• IEndpointCreate<TResponse>: la operación siempre crea un recurso nuevo
• IEndpointUpdate<TResponse>: la operación exige que el recurso ya exista y se identifica por key
• IEndpointDelete<TResponse>: la operación borra un recurso existente
• IEndpointUpsert<TResponse>: la operación puede crear o actualizar según una lookup key o natural key

IEndpointUpsert<TResponse> conserva la semántica pública Upsert, pero en metadata CRUD compatible sigue proyectando a Update para no romper consumidores legacy.

Convivencia con atributos y contratos legacy

Estas interfaces agregan metadata; no reemplazan los atributos de transporte existentes.

La precedencia de inferencia sigue siendo:

1. atributos HTTP/ruta explícitos
2. interfaces IEndpoint*
3. interfaces legacy IApi*
4. heurísticas legacy basadas en base types
5. fallback legacy por nombre de operación

Las interfaces IApi* siguen disponibles como alias de compatibilidad para contratos existentes.

Los contratos legacy que todavía implementan sólo IRequest<TResponse> siguen siendo compatibles, pero para nuevos contratos públicos la dirección preferida es usar IEndpointQuery/Create/Update/Delete/Upsert.

Uso de EndpointGroup y GenerateEndpoint

EndpointGroup describe la metadata pública de agrupación del endpoint. Hoy MVC la mapea al controller route group; a futuro puede alimentar Minimal API route groups sin cambiar los contratos. Esa metadata debe vivir en el contrato real que publica el endpoint manifest.

GenerateEndpoint queda como opt-in server. En implementaciones que heredan contratos públicos, usalo sin parámetros:

[GenerateEndpoint]
public sealed partial class GetWorkerProduct : GetWorkerProductContract;

Cuando el mismo assembly host necesita declarar descriptores outbound para Eternet.Client.Http.Generator, ponelos dentro del contenedor GenerateHttpClient sin repetir GenerateEndpoint:

[GenerateHttpClient("Worker")]
internal abstract class WorkerHttpClient
{
 internal abstract class GetWorkerProductClient : GetWorkerProductContract;
}

El endpoint sigue siendo un endpoint real servido por otro assembly o proceso. La diferencia es local a este assembly: Eternet.Client.Http.Generator resuelve la metadata desde el manifest del contrato referenciado, mientras Eternet.Mediator.Generator no materializa el descriptor como controller server.