Auth.Contracts

Shared gRPC protocol buffer contracts for the Authentication microservice. This package distributes only the raw .proto files to prevent code generation conflicts and support clean, client-side compilation in consumer services.

Installation

Add this package to your microservice via NuGet:

dotnet add package Auth.Contracts

You also need Grpc.Tools in the consuming project to automatically compile these proto files:

dotnet add package Grpc.Tools

How to Consume in Projects

Consuming projects must reference the .proto files from the NuGet package using <Protobuf> compile items. The files are distributed in the package's contentFiles and are visible locally.

Add the following to your .csproj:

<ItemGroup>
  <!-- Link and compile the gRPC Client/Server stub dynamically -->
  <Protobuf Include="$(MSBuildThisFileDirectory)Protos\Authentication\authentication.proto" 
            GrpcServices="Client" 
            Access="Public" 
            Link="Protos\Authentication\authentication.proto" />
            
  <Protobuf Include="$(MSBuildThisFileDirectory)Protos\Authorization\authorization.proto" 
            GrpcServices="Client" 
            Access="Public" 
            Link="Protos\Authorization\authorization.proto" />
            
  <Protobuf Include="$(MSBuildThisFileDirectory)Protos\Application\application.proto" 
            GrpcServices="Client" 
            Access="Public" 
            Link="Protos\Application\application.proto" />
</ItemGroup>

Set GrpcServices="Server" or GrpcServices="Both" depending on whether your project implements the service or acts as a client.

Versioning

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

• MAJOR: Released when there are breaking API/gRPC changes (e.g., removing fields, changing field IDs, renaming RPC endpoints).
• MINOR: Released when backward-compatible additions are made (e.g., adding new RPC methods, adding new optional fields).
• PATCH: Released for backward-compatible bug fixes or comment updates.