index.md

Package usage patterns

Focused usage guidance for each package in src. Pick the page that matches the layer you are wiring up; the Getting Started guide shows how they fit together.

Domain

• Vulthil.Results – Result<T> and Error for explicit success/failure flows without exceptions.
• Vulthil.SharedKernel – entity, aggregate root, and domain event primitives.

Application

• Vulthil.SharedKernel.Application – commands, queries, handlers, FluentValidation integration, and pipeline behaviors.

Infrastructure

• Vulthil.SharedKernel.Infrastructure – BaseDbContext, generic repository, and outbox composition entry point.
• Vulthil.SharedKernel.Outbox – the EF-free transactional outbox engine (relay, dispatchers, IOutboxStore seam).
• Vulthil.SharedKernel.Outbox.EntityFrameworkCore – the EF Core implementation of the outbox engine.
• Vulthil.SharedKernel.Infrastructure.Relational – relational outbox store base and MigrateAsync for EF Core providers.
• Vulthil.SharedKernel.Infrastructure.Npgsql – UseNpgsql provider wiring with PostgreSQL-tuned outbox.
• Vulthil.SharedKernel.Infrastructure.MySql – UseMySql provider wiring with MySQL-tuned outbox.
• Vulthil.SharedKernel.Infrastructure.Cosmos – UseCosmosDb provider wiring with Cosmos-specific outbox.

API

• Vulthil.SharedKernel.Api – minimal API endpoint conventions and Result → HTTP mapping.

Hosting

• Vulthil.Extensions.Hosting – IRestartableHostedService, the marker for hosted services that can be paused and resumed cleanly.

Messaging

• Vulthil.Messaging.Abstractions – transport-agnostic consumer and publisher contracts.
• Vulthil.Messaging – queue/consumer registration, hosted processing, and the transport-author SDK.
• Vulthil.Messaging.RabbitMq – RabbitMQ transport implementation.
• Vulthil.Messaging.Outbox – transactional bus-publish outbox bridging the outbox engine to the broker.
• Vulthil.Messaging.Inbox – idempotent-receiver consume filter (IIdempotencyStore contract).
• Vulthil.Messaging.Inbox.EntityFrameworkCore – shared EF Core inbox primitives (InboxMessage, ISaveInboxMessages).
• Vulthil.Messaging.Inbox.Relational – relational idempotency store (transactional exactly-once).
• Vulthil.Messaging.Inbox.Cosmos – Cosmos idempotency store (effectively-once).

Testing

• Vulthil.xUnit – reusable xUnit base classes, auto-mocking, containers, and HTTP mocks.
• Vulthil.xUnit.Cosmos – Cosmos DB emulator fixture for Vulthil.xUnit.
• Vulthil.Messaging.TestHarness – in-memory messaging test harness.
• Vulthil.Extensions.Testing – framework-agnostic polling and HTTP response helpers.