BytLabs Backend Packages — Reference

Per-package documentation for the BytLabs platform libraries. Each page covers what the package provides and how to use it, with code examples. Packages are versioned together (one BytLabsPackageVersion in each consumer's Directory.Packages.props).

Packages by layer

Core (domain & application)

Package	What it gives you
BytLabs.Domain	DDD building blocks: `Entity`, `AggregateRootBase`, `ValueObject`, domain events, audit, soft-delete, dynamic data, business rules
BytLabs.Application	CQRS (`ICommand`/`IQuery` + handlers), `IRepository`/`IUnitOfWork`, `DomainEventHandler`, validation+logging pipeline, user context, `AddCQS`

Data access

Package	What it gives you
BytLabs.DataAccess	Provider-agnostic unit-of-work, command transactions, domain-event dispatch decorator
BytLabs.DataAccess.MongoDB	MongoDB `IRepository`, per-tenant database, BSON setup, dynamic-data query helpers, health checks

API / hosting

Package	What it gives you
BytLabs.Api	`ApiServiceBuilder` fluent host (user context, multitenancy, logging, metrics, tracing, health), config binding, HTTP tenant/user resolvers
BytLabs.Api.Graphql	HotChocolate setup with BytLabs defaults, typed errors, DTO/command/aggregate type registration, dynamic-data inputs

Cross-cutting

Package	What it gives you
BytLabs.Multitenancy	Tenant resolution (`ITenantIdResolver`/`ITenantIdProvider`), database-per-tenant
BytLabs.Observability	Serilog + OpenTelemetry logging/metrics/tracing and health checks

Optional / specialized

Package	What it gives you
BytLabs.States.Domain	State-machine aggregates with rule-guarded transitions (RulesEngine)
BytLabs.Infrastructure	Placeholder; `InfrastructureException` only

How they fit together

Arrows point from a package to the packages it depends on.

---
config:
  look: handDrawn
  theme: neutral
---
flowchart LR
    App[BytLabs.Application] --> Domain[BytLabs.Domain]
    DataAccess[BytLabs.DataAccess] --> App
    Mongo[BytLabs.DataAccess.MongoDB] --> DataAccess
    Mongo --> MT[BytLabs.Multitenancy]
    Gql[BytLabs.Api.Graphql] --> App
    Gql --> Domain
    Api[BytLabs.Api] --> App
    Api --> Obs[BytLabs.Observability]
    Api --> MT

A service's Domain project references BytLabs.Domain (and optionally BytLabs.States.Domain).
Application references BytLabs.Application.
Infrastructure references BytLabs.DataAccess.MongoDB (which pulls in BytLabs.DataAccess, BytLabs.Multitenancy).
Api references BytLabs.Api + BytLabs.Api.Graphql (which pull in BytLabs.Observability, BytLabs.Multitenancy).

Table of Contents