Decorate advanced infrastructure types with [EditorBrowsable(EditorBrowsableState.Advanced)] or [EditorBrowsable(EditorBrowsableState.Never)]

src/OpenIddict.Client.AspNetCore/OpenIddictClientAspNetCoreConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Client.AspNetCore;
@@ -11,6 +12,7 @@ namespace OpenIddict.Client.AspNetCore;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict client configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientAspNetCoreConfiguration : IConfigureOptions<AuthenticationOptions>,
                                                               IConfigureOptions<OpenIddictClientOptions>,
                                                               IPostConfigureOptions<AuthenticationOptions>

src/OpenIddict.Client.AspNetCore/OpenIddictClientAspNetCoreFeature.cs

@@ -4,11 +4,14 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Client.AspNetCore;
 
 /// <summary>
 /// Exposes the current client transaction to the ASP.NET Core host.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientAspNetCoreFeature
 {
     /// <summary>

src/OpenIddict.Client.AspNetCore/OpenIddictClientAspNetCoreHandler.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 using System.Text.Encodings.Web;
 using System.Text.Json;
@@ -18,6 +19,7 @@ namespace OpenIddict.Client.AspNetCore;
 /// <summary>
 /// Provides the logic necessary to extract, validate and handle OpenID Connect requests.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientAspNetCoreHandler : AuthenticationHandler<OpenIddictClientAspNetCoreOptions>,
     IAuthenticationRequestHandler,
     IAuthenticationSignOutHandler

src/OpenIddict.Client.DataProtection/IOpenIddictClientDataProtectionFormatter.cs

@@ -4,10 +4,12 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 
 namespace OpenIddict.Client.DataProtection;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public interface IOpenIddictClientDataProtectionFormatter
 {
     ClaimsPrincipal ReadToken(BinaryReader reader);

src/OpenIddict.Client.DataProtection/OpenIddictClientDataProtectionConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.AspNetCore.DataProtection;
 using Microsoft.Extensions.Options;
 
@@ -12,6 +13,7 @@ namespace OpenIddict.Client.DataProtection;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict ASP.NET Core Data Protection configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientDataProtectionConfiguration : IConfigureOptions<OpenIddictClientOptions>,
                                                                   IPostConfigureOptions<OpenIddictClientDataProtectionOptions>
 {

src/OpenIddict.Client.DataProtection/OpenIddictClientDataProtectionFormatter.cs

@@ -5,6 +5,7 @@
  */
 
 using System.Collections.Immutable;
+using System.ComponentModel;
 using System.Security.Claims;
 using System.Text;
 using System.Text.Encodings.Web;
@@ -13,6 +14,7 @@ using Properties = OpenIddict.Client.DataProtection.OpenIddictClientDataProtecti
 
 namespace OpenIddict.Client.DataProtection;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientDataProtectionFormatter : IOpenIddictClientDataProtectionFormatter
 {
     public ClaimsPrincipal ReadToken(BinaryReader reader)

src/OpenIddict.Client.Owin/OpenIddictClientOwinConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Client.Owin;
@@ -11,6 +12,7 @@ namespace OpenIddict.Client.Owin;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict client configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientOwinConfiguration : IConfigureOptions<OpenIddictClientOptions>,
                                                         IPostConfigureOptions<OpenIddictClientOwinOptions>
 {

src/OpenIddict.Client.Owin/OpenIddictClientOwinHandler.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 using System.Text.Json;
 using Microsoft.Owin.Security.Infrastructure;
@@ -16,6 +17,7 @@ namespace OpenIddict.Client.Owin;
 /// <summary>
 /// Provides the entry point necessary to register the OpenIddict client in an OWIN pipeline.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientOwinHandler : AuthenticationHandler<OpenIddictClientOwinOptions>
 {
     private readonly IOpenIddictClientDispatcher _dispatcher;

src/OpenIddict.Client.Owin/OpenIddictClientOwinMiddleware.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 using Microsoft.Owin.Security.Infrastructure;
 
@@ -15,6 +16,7 @@ namespace OpenIddict.Client.Owin;
 /// that support middleware resolution, like Autofac. Since it depends on scoped services,
 /// it is NOT recommended to instantiate it as a singleton like a regular OWIN middleware.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientOwinMiddleware : AuthenticationMiddleware<OpenIddictClientOwinOptions>
 {
     private readonly IOpenIddictClientDispatcher _dispatcher;

src/OpenIddict.Client.Owin/OpenIddictClientOwinMiddlewareFactory.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Options;
 
@@ -13,6 +14,7 @@ namespace OpenIddict.Client.Owin;
 /// Provides the entry point necessary to instantiate and register the scoped
 /// <see cref="OpenIddictClientOwinMiddleware"/> in an OWIN/Katana pipeline.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientOwinMiddlewareFactory : OwinMiddleware
 {
     /// <summary>

src/OpenIddict.Client.SystemNetHttp/OpenIddictClientSystemNetHttpConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Http;
 using Microsoft.Extensions.Options;
@@ -13,6 +14,7 @@ namespace OpenIddict.Client.SystemNetHttp;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict client/System.Net.Http integration configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientSystemNetHttpConfiguration : IConfigureOptions<OpenIddictClientOptions>,
                                                                  IConfigureNamedOptions<HttpClientFactoryOptions>
 {

src/OpenIddict.Client.WebIntegration/OpenIddictClientWebIntegrationConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Client.WebIntegration;
@@ -11,6 +12,7 @@ namespace OpenIddict.Client.WebIntegration;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict client Web integration configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed partial class OpenIddictClientWebIntegrationConfiguration : IConfigureOptions<OpenIddictClientOptions>
 {
     /// <summary>

src/OpenIddict.Client/IOpenIddictClientDispatcher.cs

@@ -4,8 +4,11 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Client;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public interface IOpenIddictClientDispatcher
 {
     ValueTask DispatchAsync<TContext>(TContext context) where TContext : BaseContext;

src/OpenIddict.Client/IOpenIddictClientFactory.cs

@@ -4,8 +4,11 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Client;
 
+[EditorBrowsable(EditorBrowsableState.Never)]
 public interface IOpenIddictClientFactory
 {
     ValueTask<OpenIddictClientTransaction> CreateTransactionAsync();

src/OpenIddict.Client/OpenIddictClientConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Diagnostics;
 using Microsoft.Extensions.Options;
 using Microsoft.IdentityModel.Protocols;
@@ -14,6 +15,7 @@ namespace OpenIddict.Client;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict client configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientConfiguration : IPostConfigureOptions<OpenIddictClientOptions>
 {
     private readonly OpenIddictClientService _service;
@@ -67,10 +69,7 @@ public sealed class OpenIddictClientConfiguration : IPostConfigureOptions<OpenId
                         throw new InvalidOperationException(SR.GetResourceString(SR.ID0313));
                     }
 
-                    if (registration.MetadataAddress is null)
-                    {
-                        registration.MetadataAddress = new Uri(".well-known/openid-configuration", UriKind.Relative);
-                    }
+                    registration.MetadataAddress ??= new Uri(".well-known/openid-configuration", UriKind.Relative);
 
                     if (!registration.MetadataAddress.IsAbsoluteUri)
                     {

src/OpenIddict.Client/OpenIddictClientDispatcher.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Client;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientDispatcher : IOpenIddictClientDispatcher
 {
     private readonly ILogger<OpenIddictClientDispatcher> _logger;

src/OpenIddict.Client/OpenIddictClientFactory.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Client;
 
+[EditorBrowsable(EditorBrowsableState.Never)]
 public sealed class OpenIddictClientFactory : IOpenIddictClientFactory
 {
     private readonly ILogger<OpenIddictClientDispatcher> _logger;

src/OpenIddict.Client/OpenIddictClientRetriever.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Diagnostics.CodeAnalysis;
 using Microsoft.IdentityModel.Protocols;
 
 namespace OpenIddict.Client;
 
+[EditorBrowsable(EditorBrowsableState.Never)]
 public sealed class OpenIddictClientRetriever : IConfigurationRetriever<OpenIddictConfiguration>
 {
     private readonly OpenIddictClientService _service;

src/OpenIddict.Client/OpenIddictClientTransaction.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 
 namespace OpenIddict.Client;
@@ -11,6 +12,7 @@ namespace OpenIddict.Client;
 /// <summary>
 /// Represents the context associated with an OpenID Connect client request.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictClientTransaction
 {
     /// <summary>

src/OpenIddict.MongoDb/IOpenIddictMongoDbContext.cs

@@ -4,11 +4,14 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.MongoDb;
 
 /// <summary>
 /// Exposes the MongoDB database used by the OpenIddict stores.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public interface IOpenIddictMongoDbContext
 {
     /// <summary>

src/OpenIddict.MongoDb/OpenIddictMongoDbContext.cs

@@ -4,12 +4,14 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.MongoDb;
 
 /// <inheritdoc/>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictMongoDbContext : IOpenIddictMongoDbContext
 {
     private readonly IOptionsMonitor<OpenIddictMongoDbOptions> _options;
@@ -31,12 +33,7 @@ public sealed class OpenIddictMongoDbContext : IOpenIddictMongoDbContext
             return new(Task.FromCanceled<IMongoDatabase>(cancellationToken));
         }
 
-        var database = _options.CurrentValue.Database;
-        if (database is null)
-        {
-            database = _provider.GetService<IMongoDatabase>();
-        }
-
+        var database = _options.CurrentValue.Database ?? _provider.GetService<IMongoDatabase>();
         if (database is null)
         {
             return new(Task.FromException<IMongoDatabase>(

src/OpenIddict.Quartz/OpenIddictQuartzConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Quartz;
@@ -11,6 +12,7 @@ namespace OpenIddict.Quartz;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict Quartz.NET configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictQuartzConfiguration : IConfigureOptions<QuartzOptions>
 {
     /// <inheritdoc/>

src/OpenIddict.Quartz/OpenIddictQuartzJob.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Options;
 
@@ -12,7 +13,7 @@ namespace OpenIddict.Quartz;
 /// <summary>
 /// Represents a Quartz.NET job performing scheduled tasks for OpenIddict.
 /// </summary>
-[DisallowConcurrentExecution]
+[DisallowConcurrentExecution, EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictQuartzJob : IJob
 {
     private readonly IOptionsMonitor<OpenIddictQuartzOptions> _options;

src/OpenIddict.Server.AspNetCore/OpenIddictServerAspNetCoreConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Server.AspNetCore;
@@ -11,6 +12,7 @@ namespace OpenIddict.Server.AspNetCore;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict server configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerAspNetCoreConfiguration : IConfigureOptions<AuthenticationOptions>,
                                                               IConfigureOptions<OpenIddictServerOptions>,
                                                               IPostConfigureOptions<AuthenticationOptions>,

src/OpenIddict.Server.AspNetCore/OpenIddictServerAspNetCoreFeature.cs

@@ -4,11 +4,14 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Server.AspNetCore;
 
 /// <summary>
 /// Exposes the current server transaction to the ASP.NET Core host.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerAspNetCoreFeature
 {
     /// <summary>

src/OpenIddict.Server.AspNetCore/OpenIddictServerAspNetCoreHandler.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 using System.Text.Encodings.Web;
 using System.Text.Json;
@@ -17,6 +18,7 @@ namespace OpenIddict.Server.AspNetCore;
 /// <summary>
 /// Provides the logic necessary to extract, validate and handle OpenID Connect requests.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerAspNetCoreHandler : AuthenticationHandler<OpenIddictServerAspNetCoreOptions>,
     IAuthenticationRequestHandler,
     IAuthenticationSignInHandler,

src/OpenIddict.Server.DataProtection/IOpenIddictServerDataProtectionFormatter.cs

@@ -4,10 +4,12 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 
 namespace OpenIddict.Server.DataProtection;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public interface IOpenIddictServerDataProtectionFormatter
 {
     ClaimsPrincipal ReadToken(BinaryReader reader);

src/OpenIddict.Server.DataProtection/OpenIddictServerDataProtectionConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.AspNetCore.DataProtection;
 using Microsoft.Extensions.Options;
 
@@ -12,6 +13,7 @@ namespace OpenIddict.Server.DataProtection;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict ASP.NET Core Data Protection configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerDataProtectionConfiguration : IConfigureOptions<OpenIddictServerOptions>,
                                                                   IPostConfigureOptions<OpenIddictServerDataProtectionOptions>
 {

src/OpenIddict.Server.DataProtection/OpenIddictServerDataProtectionFormatter.cs

@@ -5,6 +5,7 @@
  */
 
 using System.Collections.Immutable;
+using System.ComponentModel;
 using System.Security.Claims;
 using System.Text;
 using System.Text.Encodings.Web;
@@ -13,6 +14,7 @@ using Properties = OpenIddict.Server.DataProtection.OpenIddictServerDataProtecti
 
 namespace OpenIddict.Server.DataProtection;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerDataProtectionFormatter : IOpenIddictServerDataProtectionFormatter
 {
     public ClaimsPrincipal ReadToken(BinaryReader reader)

src/OpenIddict.Server.Owin/OpenIddictServerOwinConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Server.Owin;
@@ -11,6 +12,7 @@ namespace OpenIddict.Server.Owin;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict server configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerOwinConfiguration : IConfigureOptions<OpenIddictServerOptions>,
                                                         IPostConfigureOptions<OpenIddictServerOwinOptions>
 {

src/OpenIddict.Server.Owin/OpenIddictServerOwinHandler.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 using System.Text.Json;
 using Microsoft.Owin.Security.Infrastructure;
@@ -15,6 +16,7 @@ namespace OpenIddict.Server.Owin;
 /// <summary>
 /// Provides the entry point necessary to register the OpenIddict server in an OWIN pipeline.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerOwinHandler : AuthenticationHandler<OpenIddictServerOwinOptions>
 {
     private readonly IOpenIddictServerDispatcher _dispatcher;

src/OpenIddict.Server.Owin/OpenIddictServerOwinMiddleware.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 using Microsoft.Owin.Security.Infrastructure;
 
@@ -15,6 +16,7 @@ namespace OpenIddict.Server.Owin;
 /// that support middleware resolution, like Autofac. Since it depends on scoped services,
 /// it is NOT recommended to instantiate it as a singleton like a regular OWIN middleware.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerOwinMiddleware : AuthenticationMiddleware<OpenIddictServerOwinOptions>
 {
     private readonly IOpenIddictServerDispatcher _dispatcher;

src/OpenIddict.Server.Owin/OpenIddictServerOwinMiddlewareFactory.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Options;
 
@@ -13,6 +14,7 @@ namespace OpenIddict.Server.Owin;
 /// Provides the entry point necessary to instantiate and register the scoped
 /// <see cref="OpenIddictServerOwinMiddleware"/> in an OWIN/Katana pipeline.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerOwinMiddlewareFactory : OwinMiddleware
 {
     /// <summary>

src/OpenIddict.Server/IOpenIddictServerDispatcher.cs

@@ -4,8 +4,11 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Server;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public interface IOpenIddictServerDispatcher
 {
     ValueTask DispatchAsync<TContext>(TContext context) where TContext : BaseContext;

src/OpenIddict.Server/IOpenIddictServerFactory.cs

@@ -4,8 +4,11 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Server;
 
+[EditorBrowsable(EditorBrowsableState.Never)]
 public interface IOpenIddictServerFactory
 {
     ValueTask<OpenIddictServerTransaction> CreateTransactionAsync();

src/OpenIddict.Server/OpenIddictServerConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Diagnostics;
 using Microsoft.Extensions.Options;
 using Microsoft.IdentityModel.Tokens;
@@ -13,6 +14,7 @@ namespace OpenIddict.Server;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict server configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerConfiguration : IPostConfigureOptions<OpenIddictServerOptions>
 {
     /// <summary>

src/OpenIddict.Server/OpenIddictServerDispatcher.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Server;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerDispatcher : IOpenIddictServerDispatcher
 {
     private readonly ILogger<OpenIddictServerDispatcher> _logger;

src/OpenIddict.Server/OpenIddictServerFactory.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Server;
 
+[EditorBrowsable(EditorBrowsableState.Never)]
 public sealed class OpenIddictServerFactory : IOpenIddictServerFactory
 {
     private readonly ILogger _logger;

src/OpenIddict.Server/OpenIddictServerTransaction.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 
 namespace OpenIddict.Server;
@@ -11,6 +12,7 @@ namespace OpenIddict.Server;
 /// <summary>
 /// Represents the context associated with an OpenID Connect server request.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictServerTransaction
 {
     /// <summary>

src/OpenIddict.Validation.AspNetCore/OpenIddictValidationAspNetCoreConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Validation.AspNetCore;
@@ -11,6 +12,7 @@ namespace OpenIddict.Validation.AspNetCore;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict validation configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationAspNetCoreConfiguration : IConfigureOptions<AuthenticationOptions>,
                                                                   IConfigureOptions<OpenIddictValidationOptions>,
                                                                   IPostConfigureOptions<AuthenticationOptions>

src/OpenIddict.Validation.AspNetCore/OpenIddictValidationAspNetCoreFeature.cs

@@ -4,11 +4,14 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Validation.AspNetCore;
 
 /// <summary>
 /// Exposes the current validation transaction to the ASP.NET Core host.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationAspNetCoreFeature
 {
     /// <summary>

src/OpenIddict.Validation.AspNetCore/OpenIddictValidationAspNetCoreHandler.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Text.Encodings.Web;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
@@ -15,6 +16,7 @@ namespace OpenIddict.Validation.AspNetCore;
 /// <summary>
 /// Provides the logic necessary to extract, validate and handle OpenID Connect requests.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationAspNetCoreHandler : AuthenticationHandler<OpenIddictValidationAspNetCoreOptions>,
     IAuthenticationRequestHandler
 {

src/OpenIddict.Validation.DataProtection/IOpenIddictValidationDataProtectionFormatter.cs

@@ -4,10 +4,12 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 
 namespace OpenIddict.Validation.DataProtection;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public interface IOpenIddictValidationDataProtectionFormatter
 {
     ClaimsPrincipal ReadToken(BinaryReader reader);

src/OpenIddict.Validation.DataProtection/OpenIddictValidationDataProtectionConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.AspNetCore.DataProtection;
 using Microsoft.Extensions.Options;
 
@@ -12,6 +13,7 @@ namespace OpenIddict.Validation.DataProtection;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict ASP.NET Core Data Protection configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationDataProtectionConfiguration : IConfigureOptions<OpenIddictValidationOptions>,
                                                                       IPostConfigureOptions<OpenIddictValidationDataProtectionOptions>
 {

src/OpenIddict.Validation.DataProtection/OpenIddictValidationDataProtectionFormatter.cs

@@ -4,12 +4,14 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 using System.Text.Json;
 using Properties = OpenIddict.Validation.DataProtection.OpenIddictValidationDataProtectionConstants.Properties;
 
 namespace OpenIddict.Validation.DataProtection;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationDataProtectionFormatter : IOpenIddictValidationDataProtectionFormatter
 {
     public ClaimsPrincipal ReadToken(BinaryReader reader)

src/OpenIddict.Validation.Owin/OpenIddictValidationOwinConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Validation.Owin;
@@ -11,6 +12,7 @@ namespace OpenIddict.Validation.Owin;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict validation configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationOwinConfiguration : IConfigureOptions<OpenIddictValidationOptions>
 {
     public void Configure(OpenIddictValidationOptions options)

src/OpenIddict.Validation.Owin/OpenIddictValidationOwinHandler.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Security.Claims;
 using Microsoft.Owin.Security.Infrastructure;
 using Properties = OpenIddict.Validation.Owin.OpenIddictValidationOwinConstants.Properties;
@@ -13,6 +14,7 @@ namespace OpenIddict.Validation.Owin;
 /// <summary>
 /// Provides the entry point necessary to register the OpenIddict validation in an OWIN pipeline.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationOwinHandler : AuthenticationHandler<OpenIddictValidationOwinOptions>
 {
     private readonly IOpenIddictValidationDispatcher _dispatcher;

src/OpenIddict.Validation.Owin/OpenIddictValidationOwinMiddleware.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 using Microsoft.Owin.Security.Infrastructure;
 
@@ -15,6 +16,7 @@ namespace OpenIddict.Validation.Owin;
 /// that support middleware resolution, like Autofac. Since it depends on scoped services,
 /// it is NOT recommended to instantiate it as a singleton like a regular OWIN middleware.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationOwinMiddleware : AuthenticationMiddleware<OpenIddictValidationOwinOptions>
 {
     private readonly IOpenIddictValidationDispatcher _dispatcher;

src/OpenIddict.Validation.Owin/OpenIddictValidationOwinMiddlewareFactory.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Options;
 
@@ -13,6 +14,7 @@ namespace OpenIddict.Validation.Owin;
 /// Provides the entry point necessary to instantiate and register the scoped
 /// <see cref="OpenIddictValidationOwinMiddleware"/> in an OWIN/Katana pipeline.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationOwinMiddlewareFactory : OwinMiddleware
 {
     /// <summary>

src/OpenIddict.Validation.ServerIntegration/OpenIddictValidationServerIntegrationConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Options;
 using OpenIddict.Server;
 
@@ -12,6 +13,7 @@ namespace OpenIddict.Validation.ServerIntegration;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict validation/server integration configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationServerIntegrationConfiguration : IConfigureOptions<OpenIddictValidationOptions>,
                                                                          IPostConfigureOptions<OpenIddictValidationOptions>
 {

src/OpenIddict.Validation.SystemNetHttp/OpenIddictValidationSystemNetHttpConfiguration.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Http;
 using Microsoft.Extensions.Options;
@@ -13,6 +14,7 @@ namespace OpenIddict.Validation.SystemNetHttp;
 /// <summary>
 /// Contains the methods required to ensure that the OpenIddict validation/System.Net.Http integration configuration is valid.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationSystemNetHttpConfiguration : IConfigureOptions<OpenIddictValidationOptions>,
                                                                      IConfigureNamedOptions<HttpClientFactoryOptions>
 {

src/OpenIddict.Validation/IOpenIddictValidationDispatcher.cs

@@ -4,8 +4,11 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Validation;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public interface IOpenIddictValidationDispatcher
 {
     ValueTask DispatchAsync<TContext>(TContext context) where TContext : BaseContext;

src/OpenIddict.Validation/IOpenIddictValidationFactory.cs

@@ -4,8 +4,11 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
+
 namespace OpenIddict.Validation;
 
+[EditorBrowsable(EditorBrowsableState.Never)]
 public interface IOpenIddictValidationFactory
 {
     ValueTask<OpenIddictValidationTransaction> CreateTransactionAsync();

src/OpenIddict.Validation/OpenIddictValidationConfiguration.cs

@@ -101,10 +101,7 @@ public sealed class OpenIddictValidationConfiguration : IPostConfigureOptions<Op
                     throw new InvalidOperationException(SR.GetResourceString(SR.ID0135));
                 }
 
-                if (options.MetadataAddress is null)
-                {
-                    options.MetadataAddress = new Uri(".well-known/openid-configuration", UriKind.Relative);
-                }
+                options.MetadataAddress ??= new Uri(".well-known/openid-configuration", UriKind.Relative);
 
                 if (!options.MetadataAddress.IsAbsoluteUri)
                 {

src/OpenIddict.Validation/OpenIddictValidationDispatcher.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Validation;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationDispatcher : IOpenIddictValidationDispatcher
 {
     private readonly ILogger<OpenIddictValidationDispatcher> _logger;

src/OpenIddict.Validation/OpenIddictValidationFactory.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 
 namespace OpenIddict.Validation;
 
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationFactory : IOpenIddictValidationFactory
 {
     private readonly ILogger<OpenIddictValidationDispatcher> _logger;

src/OpenIddict.Validation/OpenIddictValidationRetriever.cs

@@ -4,11 +4,13 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using System.Diagnostics.CodeAnalysis;
 using Microsoft.IdentityModel.Protocols;
 
 namespace OpenIddict.Validation;
 
+[EditorBrowsable(EditorBrowsableState.Never)]
 public sealed class OpenIddictValidationRetriever : IConfigurationRetriever<OpenIddictConfiguration>
 {
     private readonly OpenIddictValidationService _service;

src/OpenIddict.Validation/OpenIddictValidationTransaction.cs

@@ -4,6 +4,7 @@
  * the license and the contributors participating to this project.
  */
 
+using System.ComponentModel;
 using Microsoft.Extensions.Logging;
 
 namespace OpenIddict.Validation;
@@ -11,6 +12,7 @@ namespace OpenIddict.Validation;
 /// <summary>
 /// Represents the context associated with an OpenID Connect validation request.
 /// </summary>
+[EditorBrowsable(EditorBrowsableState.Advanced)]
 public sealed class OpenIddictValidationTransaction
 {
     /// <summary>