Bff.Auth

Shared REST API Data Transfer Objects (DTOs) representing the API contracts exposed by the Authentication BFF. This library is designed to be shared across client-facing API gateways (e.g., Web.BFF, Mobile.BFF, Admin.BFF).

Installation

Add this package to your project:

dotnet add package Bff.Auth

Structure & Namespaces

The DTOs are organized logically under the following namespaces:

• Authentication: Bff.Auth.Contracts.Authentication (e.g., LoginRequestDto, RegisterResponseDto)
• Authorization: Bff.Auth.Contracts.Authorization (e.g., CreateRoleRequestDto, UserDto)
• Application: Bff.Auth.Contracts.Application (e.g., ListUserDto, EditUserRequestDto)

Content Rules

This package is strictly for shared REST request/response contracts. It does NOT contain:

• Domain entities
• DbContexts or EF Models
• Repositories or database layers
• Business logic, services, or middleware
• Data validators (except primitive System.ComponentModel.DataAnnotations validation attributes)

Versioning

This library follows Semantic Versioning (MAJOR.MINOR.PATCH):

• MAJOR: Released for breaking DTO changes (e.g., property removals, type changes, property renaming).
• MINOR: Released for backward-compatible additions (e.g., adding new optional properties, new DTOs).
• PATCH: Released for backward-compatible bug fixes or documentation updates.