Eternet.Mediator.Abstractions 3.0.7

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:

• 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 GenerateEndpoint

GenerateEndpoint describe la metadata del endpoint: controller, verbo, ruta y binding. Esa metadata debe vivir en el contrato real que publica el endpoint manifest. 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.