Refactor API to use IOptions pattern with IConfigurationSection binding (#59)

* Refactor API to use IOptions pattern with IConfigurationSection binding

* Update Documentation and Examples to work with the new public API signatures

* Update docs-source to reflect the new Public API signatures

* Adds Domain format validation and prevent EventsType bypass

* Adds startup validation integration tests

* Ensure trailing '/' in domain is tolerated

* Update Migration.md to callout potential captive dependency

* Improve DX with more extension methods for configuration

Author: kailash-b

.gitignore

@@ -48,3 +48,6 @@ docfx.zip
 # Ignoring Misc
 .DS_Store
 .github/.DS_Store
+
+# Ignoring C# Dev Kit language service cache files
+*.lscache

Auth0.AspNetCore.Authentication.Api.Playground/Program.cs

@@ -10,25 +10,21 @@
 builder.Services.AddSwaggerGen();
 
 // Adds Auth0 JWT validation to the API
-builder.Services.AddAuth0ApiAuthentication(options =>
-{
-    options.JwtBearerOptions = new JwtBearerOptions
-    {
-        Audience = builder.Configuration["Auth0:Audience"]
-                   ?? throw new InvalidOperationException("Auth0:Audience is required")
-    };
-    options.Domain = builder.Configuration["Auth0:Domain"]
-                     ?? throw new InvalidOperationException("Auth0:Domain is required");
-    options.JwtBearerOptions.Events = new JwtBearerEvents
+// Configuration is automatically bound from appsettings.json "Auth0" section
+builder.Services.AddAuth0ApiAuthentication(
+    builder.Configuration.GetSection("Auth0"),
+    configureJwtBearer: jwt =>
     {
-        // Custom event just to log the token received in the request.
-        OnMessageReceived = context =>
+        jwt.Events = new JwtBearerEvents
         {
-            Console.WriteLine($"Token extracted? : {(!string.IsNullOrEmpty(context.Token) ? "yes" : "no")}");
-            return Task.CompletedTask;
-        }
-    };
-}).WithDPoP();
+            // Custom event just to log the token received in the request.
+            OnMessageReceived = context =>
+            {
+                Console.WriteLine($"Token extracted? : {(!string.IsNullOrEmpty(context.Token) ? "yes" : "no")}");
+                return Task.CompletedTask;
+            }
+        };
+    }).WithDPoP();
 
 builder.Services.AddAuthorization();