generator-aspnet-oauth 8.0.0 → 9.0.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2015 aspnet-contrib
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2015 aspnet-contrib
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,49 +1,48 @@
-# generator-aspnet-oauth
-
-[![Build status](https://github.com/aspnet-contrib/generator-aspnet-oauth/workflows/build/badge.svg?branch=dev&event=push)](https://github.com/aspnet-contrib/generator-aspnet-oauth/actions?query=workflow%3Abuild+branch%3Adev+event%3Apush)
-
-> [Yeoman](http://yeoman.io) generator
-
-
-## Getting Started
-
-### What is Yeoman?
-
-Trick question. It's not a thing. It's this guy:
-
-![](http://i.imgur.com/JHaAlBJ.png)
-
-Basically, he wears a top hat, lives in your computer, and waits for you to tell him what kind of application you wish to create.
-
-Not every new computer comes with a Yeoman pre-installed. He lives in the [npm](https://npmjs.org) package repository. You only have to ask for him once, then he packs up and moves into your hard drive. *Make sure you clean up, he likes new and shiny things.*
-
-```bash
-npm install -g yo
-```
-
-### Yeoman Generators
-
-Yeoman travels light. He didn't pack any generators when he moved in. You can think of a generator like a plug-in. You get to choose what type of application you wish to create, such as a Backbone application or even a Chrome extension.
-
-To install generator-aspnet-oauth from npm, run:
-
-```bash
-npm install -g generator-aspnet-oauth
-```
-
-Finally, initiate the generator:
-
-```bash
-yo aspnet-oauth
-```
-
-### Getting To Know Yeoman
-
-Yeoman has a heart of gold. He's a person with feelings and opinions, but he's very easy to work with. If you think he's too opinionated, he can be easily convinced.
-
-If you'd like to get to know Yeoman better and meet some of his friends, [Grunt](http://gruntjs.com) and [Bower](http://bower.io), check out the complete [Getting Started Guide](https://github.com/yeoman/yeoman/wiki/Getting-Started).
-
-
-## License
-
-MIT
+# generator-aspnet-oauth
+
+[![Build status](https://github.com/aspnet-contrib/generator-aspnet-oauth/actions/workflows/build.yml/badge.svg?branch=dev&event=push)](https://github.com/aspnet-contrib/generator-aspnet-oauth/actions?query=workflow%3Abuild+branch%3Adev+event%3Apush)
+
+> [Yeoman](http://yeoman.io) generator
+
+## Getting Started
+
+### What is Yeoman?
+
+Trick question. It's not a thing. It's this guy:
+
+![](http://i.imgur.com/JHaAlBJ.png)
+
+Basically, he wears a top hat, lives in your computer, and waits for you to tell him what kind of application you wish to create.
+
+Not every new computer comes with a Yeoman pre-installed. He lives in the [npm](https://npmjs.org) package repository. You only have to ask for him once, then he packs up and moves into your hard drive. *Make sure you clean up, he likes new and shiny things.*
+
+```bash
+npm install -g yo
+```
+
+### Yeoman Generators
+
+Yeoman travels light. He didn't pack any generators when he moved in. You can think of a generator like a plug-in. You get to choose what type of application you wish to create, such as a Backbone application or even a Chrome extension.
+
+To install generator-aspnet-oauth from npm, run:
+
+```bash
+npm install -g generator-aspnet-oauth
+```
+
+Finally, initiate the generator:
+
+```bash
+yo aspnet-oauth
+```
+
+### Getting To Know Yeoman
+
+Yeoman has a heart of gold. He's a person with feelings and opinions, but he's very easy to work with. If you think he's too opinionated, he can be easily convinced.
+
+If you'd like to get to know Yeoman better and meet some of his friends, [Grunt](http://gruntjs.com) and [Bower](http://bower.io), check out the complete [Getting Started Guide](https://github.com/yeoman/yeoman/wiki/Getting-Started).
+
+
+## License
+
+MIT

package/generators/app/index.js

@@ -1,118 +1,118 @@
-'use strict';
-const fetch = require('cross-fetch');
-const Generator = require('yeoman-generator');
-const queryString = require('query-string');
-const yosay = require('yosay');
-
-module.exports = class extends Generator {
-
-  initializing() {
-    this.templateData = {};
-    this.log(yosay('Welcome to the classy ASP.NET OAuth Provider generator!'));
-  }
-
-  async prompting() {
-    const prompts = [{
-      type: 'input',
-      name: 'name',
-      message: 'What is the name of the provider you want to create?',
-      store: true
-    },
-    {
-      type: 'input',
-      name: 'authorname',
-      message: 'What is your name?',
-      store: true
-    },
-    {
-      type: 'input',
-      name: 'authorizationendpoint',
-      message: 'What is the Authorization Endpoint for this service?',
-      store: true
-    },
-    {
-      type: 'input',
-      name: 'tokenendpoint',
-      message: 'What is the Token Endpoint for this service?',
-      store: true
-    },
-    {
-      type: 'input',
-      name: 'userinformationendpoint',
-      message: 'What is the User Information Endpoint for this service?',
-      store: true
-    }];
-
-    const answers = await this.prompt(prompts);
-
-    this.templateData.name = answers.name;
-    this.templateData.authorname = answers.authorname;
-    this.templateData.authorizationendpoint = answers.authorizationendpoint;
-    this.templateData.tokenendpoint = answers.tokenendpoint;
-    this.templateData.userinformationendpoint = answers.userinformationendpoint;
-
-    this.templateData.currentVersion = await this.getCurrentVersion();
-
-    this.name = answers.name;
-    this.applicationName = 'AspNet.Security.OAuth.' + answers.name;
-  }
-
-  writing() {
-    this.fs.copyTpl(this.templatePath('Project.csproj'), this.applicationName + '/' + this.applicationName + '.csproj', this.templateData)
-    this.fs.copyTpl(this.templatePath('AuthenticationDefaults.cs'), this.applicationName + '/' + this.name + 'AuthenticationDefaults.cs', this.templateData)
-    this.fs.copyTpl(this.templatePath('AuthenticationExtensions.cs'), this.applicationName + '/' + this.name + 'AuthenticationExtensions.cs', this.templateData)
-    this.fs.copyTpl(this.templatePath('AuthenticationHandler.cs'), this.applicationName + '/' + this.name + 'AuthenticationHandler.cs', this.templateData)
-    this.fs.copyTpl(this.templatePath('AuthenticationOptions.cs'), this.applicationName + '/' + this.name + 'AuthenticationOptions.cs', this.templateData)
-  }
-
-  async getCurrentVersion() {
-
-    let response = await fetch('https://api.nuget.org/v3/index.json');
-
-    if (!response.ok) {
-      throw new Error(`Failed to query NuGet service index. HTTP status code: ${response.status}.`);
-    }
-
-    const serviceIndex = await response.json();
-    const baseAddress = serviceIndex.resources.find(resource => resource['@type'] === 'SearchQueryService/3.5.0')['@id'];
-
-    if (!baseAddress) {
-      throw new Error('Failed to determine the base address for the NuGet search query service.');
-    }
-
-    const query = queryString.stringify({
-      prerelease: false,
-      q: 'PackageId:AspNet.Security.OAuth.GitHub',
-      semVerLevel: '2.0.0',
-      take: 1
-    });
-
-    const searchUrl = `${baseAddress}?${query}`;
-    response = await fetch(searchUrl);
-
-    if (!response.ok) {
-      throw new Error(`Failed to search for NuGet package from '${searchUrl}'. HTTP status code: ${response.status}.`);
-    }
-
-    const searchResult = await response.json();
-
-    let latestVersion = null;
-
-    if (searchResult.data && searchResult.data.length > 0) {
-      latestVersion = searchResult.data[0].version;
-    }
-
-    if (!latestVersion) {
-      throw new Error('Failed to determine the latest version of the OAuth providers.');
-    }
-
-    const dot = '.';
-    const versionParts = latestVersion.split(dot);
-
-    // Increment the build number by one for the release that
-    // would be the first one including this new provider.
-    versionParts[2] = parseInt(versionParts[2], 10) + 1;
-
-    return versionParts.join(dot);
-  }
-};
+'use strict';
+const fetch = require('cross-fetch');
+const Generator = require('yeoman-generator');
+const queryString = require('query-string');
+const yosay = require('yosay');
+
+module.exports = class extends Generator {
+
+  initializing() {
+    this.templateData = {};
+    this.log(yosay('Welcome to the classy ASP.NET OAuth Provider generator!'));
+  }
+
+  async prompting() {
+    const prompts = [{
+      type: 'input',
+      name: 'name',
+      message: 'What is the name of the provider you want to create?',
+      store: true
+    },
+    {
+      type: 'input',
+      name: 'authorname',
+      message: 'What is your name?',
+      store: true
+    },
+    {
+      type: 'input',
+      name: 'authorizationendpoint',
+      message: 'What is the Authorization Endpoint for this service?',
+      store: true
+    },
+    {
+      type: 'input',
+      name: 'tokenendpoint',
+      message: 'What is the Token Endpoint for this service?',
+      store: true
+    },
+    {
+      type: 'input',
+      name: 'userinformationendpoint',
+      message: 'What is the User Information Endpoint for this service?',
+      store: true
+    }];
+
+    const answers = await this.prompt(prompts);
+
+    this.templateData.name = answers.name;
+    this.templateData.authorname = answers.authorname;
+    this.templateData.authorizationendpoint = answers.authorizationendpoint;
+    this.templateData.tokenendpoint = answers.tokenendpoint;
+    this.templateData.userinformationendpoint = answers.userinformationendpoint;
+
+    this.templateData.currentVersion = await this.getCurrentVersion();
+
+    this.name = answers.name;
+    this.applicationName = 'AspNet.Security.OAuth.' + answers.name;
+  }
+
+  writing() {
+    this.fs.copyTpl(this.templatePath('Project.csproj'), this.applicationName + '/' + this.applicationName + '.csproj', this.templateData)
+    this.fs.copyTpl(this.templatePath('AuthenticationDefaults.cs'), this.applicationName + '/' + this.name + 'AuthenticationDefaults.cs', this.templateData)
+    this.fs.copyTpl(this.templatePath('AuthenticationExtensions.cs'), this.applicationName + '/' + this.name + 'AuthenticationExtensions.cs', this.templateData)
+    this.fs.copyTpl(this.templatePath('AuthenticationHandler.cs'), this.applicationName + '/' + this.name + 'AuthenticationHandler.cs', this.templateData)
+    this.fs.copyTpl(this.templatePath('AuthenticationOptions.cs'), this.applicationName + '/' + this.name + 'AuthenticationOptions.cs', this.templateData)
+  }
+
+  async getCurrentVersion() {
+
+    let response = await fetch('https://api.nuget.org/v3/index.json');
+
+    if (!response.ok) {
+      throw new Error(`Failed to query NuGet service index. HTTP status code: ${response.status}.`);
+    }
+
+    const serviceIndex = await response.json();
+    const baseAddress = serviceIndex.resources.find(resource => resource['@type'] === 'SearchQueryService/3.5.0')['@id'];
+
+    if (!baseAddress) {
+      throw new Error('Failed to determine the base address for the NuGet search query service.');
+    }
+
+    const query = queryString.stringify({
+      prerelease: false,
+      q: 'PackageId:AspNet.Security.OAuth.GitHub',
+      semVerLevel: '2.0.0',
+      take: 1
+    });
+
+    const searchUrl = `${baseAddress}?${query}`;
+    response = await fetch(searchUrl);
+
+    if (!response.ok) {
+      throw new Error(`Failed to search for NuGet package from '${searchUrl}'. HTTP status code: ${response.status}.`);
+    }
+
+    const searchResult = await response.json();
+
+    let latestVersion = null;
+
+    if (searchResult.data && searchResult.data.length > 0) {
+      latestVersion = searchResult.data[0].version;
+    }
+
+    if (!latestVersion) {
+      throw new Error('Failed to determine the latest version of the OAuth providers.');
+    }
+
+    const dot = '.';
+    const versionParts = latestVersion.split(dot);
+
+    // Increment the build number by one for the release that
+    // would be the first one including this new provider.
+    versionParts[2] = parseInt(versionParts[2], 10) + 1;
+
+    return versionParts.join(dot);
+  }
+};

package/generators/app/templates/AuthenticationDefaults.cs

@@ -1,48 +1,48 @@
-/*
- * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
- * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
- * for more information concerning the license and the contributors participating to this project.
- */
-
-namespace AspNet.Security.OAuth.<%= name %>;
-
-/// <summary>
-/// Default values used by the <%= name %> authentication provider.
-/// </summary>
-public static class <%= name %>AuthenticationDefaults
-{
-    /// <summary>
-    /// Default value for <see cref="AuthenticationScheme.Name"/>.
-    /// </summary>
-    public const string AuthenticationScheme = "<%= name %>";
-
-    /// <summary>
-    /// Default value for <see cref="AuthenticationScheme.DisplayName"/>.
-    /// </summary>
-    public static readonly string DisplayName = "<%= name %>";
-
-    /// <summary>
-    /// Default value for <see cref="AuthenticationSchemeOptions.ClaimsIssuer"/>.
-    /// </summary>
-    public static readonly string Issuer = "<%= name %>";
-
-    /// <summary>
-    /// Default value for <see cref="RemoteAuthenticationOptions.CallbackPath"/>.
-    /// </summary>
-    public static readonly string CallbackPath = "/signin-<%= name.toLowerCase() %>";
-
-    /// <summary>
-    /// Default value for <see cref="OAuthOptions.AuthorizationEndpoint"/>.
-    /// </summary>
-    public static readonly string AuthorizationEndpoint = "<%= authorizationendpoint %>";
-
-    /// <summary>
-    /// Default value for <see cref="OAuthOptions.TokenEndpoint"/>.
-    /// </summary>
-    public static readonly string TokenEndpoint = "<%= tokenendpoint %>";
-
-    /// <summary>
-    /// Default value for <see cref="OAuthOptions.UserInformationEndpoint"/>.
-    /// </summary>
-    public static readonly string UserInformationEndpoint = "<%= userinformationendpoint %>";
-}
+/*
+ * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
+ * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
+ * for more information concerning the license and the contributors participating to this project.
+ */
+
+namespace AspNet.Security.OAuth.<%= name %>;
+
+/// <summary>
+/// Default values used by the <%= name %> authentication provider.
+/// </summary>
+public static class <%= name %>AuthenticationDefaults
+{
+    /// <summary>
+    /// Default value for <see cref="AuthenticationScheme.Name"/>.
+    /// </summary>
+    public const string AuthenticationScheme = "<%= name %>";
+
+    /// <summary>
+    /// Default value for <see cref="AuthenticationScheme.DisplayName"/>.
+    /// </summary>
+    public static readonly string DisplayName = "<%= name %>";
+
+    /// <summary>
+    /// Default value for <see cref="AuthenticationSchemeOptions.ClaimsIssuer"/>.
+    /// </summary>
+    public static readonly string Issuer = "<%= name %>";
+
+    /// <summary>
+    /// Default value for <see cref="RemoteAuthenticationOptions.CallbackPath"/>.
+    /// </summary>
+    public static readonly string CallbackPath = "/signin-<%= name.toLowerCase() %>";
+
+    /// <summary>
+    /// Default value for <see cref="OAuthOptions.AuthorizationEndpoint"/>.
+    /// </summary>
+    public static readonly string AuthorizationEndpoint = "<%= authorizationendpoint %>";
+
+    /// <summary>
+    /// Default value for <see cref="OAuthOptions.TokenEndpoint"/>.
+    /// </summary>
+    public static readonly string TokenEndpoint = "<%= tokenendpoint %>";
+
+    /// <summary>
+    /// Default value for <see cref="OAuthOptions.UserInformationEndpoint"/>.
+    /// </summary>
+    public static readonly string UserInformationEndpoint = "<%= userinformationendpoint %>";
+}

package/generators/app/templates/AuthenticationExtensions.cs

@@ -1,74 +1,74 @@
-/*
- * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
- * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
- * for more information concerning the license and the contributors participating to this project.
- */
-
-using AspNet.Security.OAuth.<%= name %>;
-
-namespace Microsoft.Extensions.DependencyInjection;
-
-/// <summary>
-/// Extension methods to add <%= name %> authentication capabilities to an HTTP application pipeline.
-/// </summary>
-public static class <%= name %>AuthenticationExtensions
-{
-    /// <summary>
-    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
-    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
-    /// </summary>
-    /// <param name="builder">The authentication builder.</param>
-    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
-    public static AuthenticationBuilder Add<%= name %>([NotNull] this AuthenticationBuilder builder)
-    {
-        return builder.Add<%= name %>(<%= name %>AuthenticationDefaults.AuthenticationScheme, options => { });
-    }
-
-    /// <summary>
-    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
-    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
-    /// </summary>
-    /// <param name="builder">The authentication builder.</param>
-    /// <param name="configuration">The delegate used to configure the <%= name %> options.</param>
-    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
-    public static AuthenticationBuilder Add<%= name %>(
-        [NotNull] this AuthenticationBuilder builder,
-        [NotNull] Action<<%= name %>AuthenticationOptions> configuration)
-    {
-        return builder.Add<%= name %>(<%= name %>AuthenticationDefaults.AuthenticationScheme, configuration);
-    }
-
-    /// <summary>
-    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
-    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
-    /// </summary>
-    /// <param name="builder">The authentication builder.</param>
-    /// <param name="scheme">The authentication scheme associated with this instance.</param>
-    /// <param name="configuration">The delegate used to configure the <%= name %> options.</param>
-    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
-    public static AuthenticationBuilder Add<%= name %>(
-        [NotNull] this AuthenticationBuilder builder,
-        [NotNull] string scheme,
-        [NotNull] Action<<%= name %>AuthenticationOptions> configuration)
-    {
-        return builder.Add<%= name %>(scheme, <%= name %>AuthenticationDefaults.DisplayName, configuration);
-    }
-
-    /// <summary>
-    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
-    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
-    /// </summary>
-    /// <param name="builder">The authentication builder.</param>
-    /// <param name="scheme">The authentication scheme associated with this instance.</param>
-    /// <param name="caption">The optional display name associated with this instance.</param>
-    /// <param name="configuration">The delegate used to configure the <%= name %> options.</param>
-    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
-    public static AuthenticationBuilder Add<%= name %>(
-        [NotNull] this AuthenticationBuilder builder,
-        [NotNull] string scheme,
-        [CanBeNull] string caption,
-        [NotNull] Action<<%= name %>AuthenticationOptions> configuration)
-    {
-        return builder.AddOAuth<<%= name %>AuthenticationOptions, <%= name %>AuthenticationHandler>(scheme, caption, configuration);
-    }
-}
+/*
+ * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
+ * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
+ * for more information concerning the license and the contributors participating to this project.
+ */
+
+using AspNet.Security.OAuth.<%= name %>;
+
+namespace Microsoft.Extensions.DependencyInjection;
+
+/// <summary>
+/// Extension methods to add <%= name %> authentication capabilities to an HTTP application pipeline.
+/// </summary>
+public static class <%= name %>AuthenticationExtensions
+{
+    /// <summary>
+    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
+    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
+    /// </summary>
+    /// <param name="builder">The authentication builder.</param>
+    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
+    public static AuthenticationBuilder Add<%= name %>([NotNull] this AuthenticationBuilder builder)
+    {
+        return builder.Add<%= name %>(<%= name %>AuthenticationDefaults.AuthenticationScheme, options => { });
+    }
+
+    /// <summary>
+    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
+    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
+    /// </summary>
+    /// <param name="builder">The authentication builder.</param>
+    /// <param name="configuration">The delegate used to configure the <%= name %> options.</param>
+    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
+    public static AuthenticationBuilder Add<%= name %>(
+        [NotNull] this AuthenticationBuilder builder,
+        [NotNull] Action<<%= name %>AuthenticationOptions> configuration)
+    {
+        return builder.Add<%= name %>(<%= name %>AuthenticationDefaults.AuthenticationScheme, configuration);
+    }
+
+    /// <summary>
+    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
+    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
+    /// </summary>
+    /// <param name="builder">The authentication builder.</param>
+    /// <param name="scheme">The authentication scheme associated with this instance.</param>
+    /// <param name="configuration">The delegate used to configure the <%= name %> options.</param>
+    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
+    public static AuthenticationBuilder Add<%= name %>(
+        [NotNull] this AuthenticationBuilder builder,
+        [NotNull] string scheme,
+        [NotNull] Action<<%= name %>AuthenticationOptions> configuration)
+    {
+        return builder.Add<%= name %>(scheme, <%= name %>AuthenticationDefaults.DisplayName, configuration);
+    }
+
+    /// <summary>
+    /// Adds <see cref="<%= name %>AuthenticationHandler"/> to the specified
+    /// <see cref="AuthenticationBuilder"/>, which enables <%= name %> authentication capabilities.
+    /// </summary>
+    /// <param name="builder">The authentication builder.</param>
+    /// <param name="scheme">The authentication scheme associated with this instance.</param>
+    /// <param name="caption">The optional display name associated with this instance.</param>
+    /// <param name="configuration">The delegate used to configure the <%= name %> options.</param>
+    /// <returns>The <see cref="AuthenticationBuilder"/>.</returns>
+    public static AuthenticationBuilder Add<%= name %>(
+        [NotNull] this AuthenticationBuilder builder,
+        [NotNull] string scheme,
+        [CanBeNull] string caption,
+        [NotNull] Action<<%= name %>AuthenticationOptions> configuration)
+    {
+        return builder.AddOAuth<<%= name %>AuthenticationOptions, <%= name %>AuthenticationHandler>(scheme, caption, configuration);
+    }
+}

package/generators/app/templates/AuthenticationHandler.cs

@@ -1,89 +1,89 @@
-/*
- * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
- * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
- * for more information concerning the license and the contributors participating to this project.
- */
-
-using System.Net.Http;
-using System.Net.Http.Headers;
-using System.Security.Claims;
-using System.Text.Encodings.Web;
-using System.Text.Json;
-using Microsoft.AspNetCore.WebUtilities;
-using Microsoft.Extensions.Logging;
-using Microsoft.Extensions.Options;
-
-namespace AspNet.Security.OAuth.<%= name %>;
-
-/// <summary>
-/// Defines a handler for authentication using <%= name %>.
-/// </summary>
-public partial class <%= name %>AuthenticationHandler : OAuthHandler<<%= name %>AuthenticationOptions>
-{
-    /// <summary>
-    /// Initializes a new instance of the <see cref="<%= name %>AuthenticationHandler"/> class.
-    /// </summary>
-    /// <param name="options">The authentication options.</param>
-    /// <param name="logger">The logger to use.</param>
-    /// <param name="encoder">The URL encoder to use.</param>
-    public <%= name %>AuthenticationHandler(
-        [NotNull] IOptionsMonitor<<%= name %>AuthenticationOptions> options,
-        [NotNull] ILoggerFactory logger,
-        [NotNull] UrlEncoder encoder)
-        : base(options, logger, encoder)
-    {
-    }
-
-    /// <inheritdoc />
-    protected override async Task<AuthenticationTicket> CreateTicketAsync(
-        [NotNull] ClaimsIdentity identity,
-        [NotNull] AuthenticationProperties properties,
-        [NotNull] OAuthTokenResponse tokens)
-    {
-        var endpoint = Options.UserInformationEndpoint;
-
-        // TODO Append any additional query string parameters required
-        ////endpoint = QueryHelpers.AddQueryString(endpoint, "token", tokens.AccessToken);
-
-        using var request = new HttpRequestMessage(HttpMethod.Get, endpoint);
-        request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
-
-        // TODO Add any HTTP request headers required
-        ////request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", tokens.AccessToken);
-
-        using var response = await Backchannel.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, Context.RequestAborted);
-        if (!response.IsSuccessStatusCode)
-        {
-            await Log.UserProfileErrorAsync(Logger, response, Context.RequestAborted);
-            throw new HttpRequestException("An error occurred while retrieving the user profile from <%= name %>.");
-        }
-
-        using var payload = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
-
-        var principal = new ClaimsPrincipal(identity);
-        var context = new OAuthCreatingTicketContext(principal, properties, Context, Scheme, Options, Backchannel, tokens, payload.RootElement);
-        context.RunClaimActions();
-
-        await Events.CreatingTicket(context);
-        return new AuthenticationTicket(context.Principal!, context.Properties, Scheme.Name);
-    }
-
-    private static partial class Log
-    {
-        internal static async Task UserProfileErrorAsync(ILogger logger, HttpResponseMessage response, CancellationToken cancellationToken)
-        {
-            UserProfileError(
-                logger,
-                response.StatusCode,
-                response.Headers.ToString(),
-                await response.Content.ReadAsStringAsync(cancellationToken));
-        }
-
-        [LoggerMessage(1, LogLevel.Error, "An error occurred while retrieving the user profile: the remote server returned a {Status} response with the following payload: {Headers} {Body}.")]
-        private static partial void UserProfileError(
-            ILogger logger,
-            System.Net.HttpStatusCode status,
-            string headers,
-            string body);
-    }
-}
+/*
+ * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
+ * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
+ * for more information concerning the license and the contributors participating to this project.
+ */
+
+using System.Net.Http;
+using System.Net.Http.Headers;
+using System.Security.Claims;
+using System.Text.Encodings.Web;
+using System.Text.Json;
+using Microsoft.AspNetCore.WebUtilities;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.Options;
+
+namespace AspNet.Security.OAuth.<%= name %>;
+
+/// <summary>
+/// Defines a handler for authentication using <%= name %>.
+/// </summary>
+public partial class <%= name %>AuthenticationHandler : OAuthHandler<<%= name %>AuthenticationOptions>
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="<%= name %>AuthenticationHandler"/> class.
+    /// </summary>
+    /// <param name="options">The authentication options.</param>
+    /// <param name="logger">The logger to use.</param>
+    /// <param name="encoder">The URL encoder to use.</param>
+    public <%= name %>AuthenticationHandler(
+        [NotNull] IOptionsMonitor<<%= name %>AuthenticationOptions> options,
+        [NotNull] ILoggerFactory logger,
+        [NotNull] UrlEncoder encoder)
+        : base(options, logger, encoder)
+    {
+    }
+
+    /// <inheritdoc />
+    protected override async Task<AuthenticationTicket> CreateTicketAsync(
+        [NotNull] ClaimsIdentity identity,
+        [NotNull] AuthenticationProperties properties,
+        [NotNull] OAuthTokenResponse tokens)
+    {
+        var endpoint = Options.UserInformationEndpoint;
+
+        // TODO Append any additional query string parameters required
+        ////endpoint = QueryHelpers.AddQueryString(endpoint, "token", tokens.AccessToken);
+
+        using var request = new HttpRequestMessage(HttpMethod.Get, endpoint);
+        request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
+
+        // TODO Add any HTTP request headers required
+        ////request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", tokens.AccessToken);
+
+        using var response = await Backchannel.SendAsync(request, HttpCompletionOption.ResponseHeadersRead, Context.RequestAborted);
+        if (!response.IsSuccessStatusCode)
+        {
+            await Log.UserProfileErrorAsync(Logger, response, Context.RequestAborted);
+            throw new HttpRequestException("An error occurred while retrieving the user profile from <%= name %>.");
+        }
+
+        using var payload = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
+
+        var principal = new ClaimsPrincipal(identity);
+        var context = new OAuthCreatingTicketContext(principal, properties, Context, Scheme, Options, Backchannel, tokens, payload.RootElement);
+        context.RunClaimActions();
+
+        await Events.CreatingTicket(context);
+        return new AuthenticationTicket(context.Principal!, context.Properties, Scheme.Name);
+    }
+
+    private static partial class Log
+    {
+        internal static async Task UserProfileErrorAsync(ILogger logger, HttpResponseMessage response, CancellationToken cancellationToken)
+        {
+            UserProfileError(
+                logger,
+                response.StatusCode,
+                response.Headers.ToString(),
+                await response.Content.ReadAsStringAsync(cancellationToken));
+        }
+
+        [LoggerMessage(1, LogLevel.Error, "An error occurred while retrieving the user profile: the remote server returned a {Status} response with the following payload: {Headers} {Body}.")]
+        private static partial void UserProfileError(
+            ILogger logger,
+            System.Net.HttpStatusCode status,
+            string headers,
+            string body);
+    }
+}

package/generators/app/templates/AuthenticationOptions.cs

@@ -1,34 +1,34 @@
-/*
- * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
- * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
- * for more information concerning the license and the contributors participating to this project.
- */
-
-using System.Security.Claims;
-
-namespace AspNet.Security.OAuth.<%= name %>;
-
-/// <summary>
-/// Defines a set of options used by <see cref="<%= name %>AuthenticationHandler"/>.
-/// </summary>
-public class <%= name %>AuthenticationOptions : OAuthOptions
-{
-    /// <summary>
-    /// Initializes a new instance of the <see cref="<%= name %>AuthenticationOptions"/> class.
-    /// </summary>
-    public <%= name %>AuthenticationOptions()
-    {
-        ClaimsIssuer = <%= name %>AuthenticationDefaults.Issuer;
-        CallbackPath = <%= name %>AuthenticationDefaults.CallbackPath;
-
-        AuthorizationEndpoint = <%= name %>AuthenticationDefaults.AuthorizationEndpoint;
-        TokenEndpoint = <%= name %>AuthenticationDefaults.TokenEndpoint;
-        UserInformationEndpoint = <%= name %>AuthenticationDefaults.UserInformationEndpoint;
-
-        // TODO Add any required scopes
-        // Scope.Add("?");
-
-        // TODO Map any claims
-        // ClaimActions.MapJsonKey(ClaimTypes.Email, "?");
-    }
-}
+/*
+ * Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
+ * See https://github.com/aspnet-contrib/AspNet.Security.OAuth.Providers
+ * for more information concerning the license and the contributors participating to this project.
+ */
+
+using System.Security.Claims;
+
+namespace AspNet.Security.OAuth.<%= name %>;
+
+/// <summary>
+/// Defines a set of options used by <see cref="<%= name %>AuthenticationHandler"/>.
+/// </summary>
+public class <%= name %>AuthenticationOptions : OAuthOptions
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="<%= name %>AuthenticationOptions"/> class.
+    /// </summary>
+    public <%= name %>AuthenticationOptions()
+    {
+        ClaimsIssuer = <%= name %>AuthenticationDefaults.Issuer;
+        CallbackPath = <%= name %>AuthenticationDefaults.CallbackPath;
+
+        AuthorizationEndpoint = <%= name %>AuthenticationDefaults.AuthorizationEndpoint;
+        TokenEndpoint = <%= name %>AuthenticationDefaults.TokenEndpoint;
+        UserInformationEndpoint = <%= name %>AuthenticationDefaults.UserInformationEndpoint;
+
+        // TODO Add any required scopes
+        // Scope.Add("?");
+
+        // TODO Map any claims
+        // ClaimActions.MapJsonKey(ClaimTypes.Email, "?");
+    }
+}

package/generators/app/templates/Project.csproj

@@ -1,24 +1,24 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <PackageValidationBaselineVersion><%= currentVersion %></PackageValidationBaselineVersion>
-    <TargetFrameworks>$(DefaultNetCoreTargetFramework)</TargetFrameworks>
-  </PropertyGroup>
-
-  <!-- This property group is required until the new provider is first published to NuGet.org -->
-  <PropertyGroup>
-    <DisablePackageBaselineValidation>true</DisablePackageBaselineValidation>
-  </PropertyGroup>
-
-  <PropertyGroup>
-    <Description>ASP.NET Core security provider enabling <%= name %> authentication.</Description>
-    <Authors><%= authorname %></Authors>
-    <PackageTags><%= name.toLowerCase() %>;aspnetcore;authentication;oauth;security</PackageTags>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <FrameworkReference Include="Microsoft.AspNetCore.App" />
-    <PackageReference Include="JetBrains.Annotations" PrivateAssets="All" />
-  </ItemGroup>
-
-</Project>
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <PackageValidationBaselineVersion><%= currentVersion %></PackageValidationBaselineVersion>
+    <TargetFrameworks>$(DefaultNetCoreTargetFramework)</TargetFrameworks>
+  </PropertyGroup>
+
+  <!-- This property group is required until the new provider is first published to NuGet.org -->
+  <PropertyGroup>
+    <DisablePackageBaselineValidation>true</DisablePackageBaselineValidation>
+  </PropertyGroup>
+
+  <PropertyGroup>
+    <Description>ASP.NET Core security provider enabling <%= name %> authentication.</Description>
+    <Authors><%= authorname %></Authors>
+    <PackageTags><%= name.toLowerCase() %>;aspnetcore;authentication;oauth;security</PackageTags>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <FrameworkReference Include="Microsoft.AspNetCore.App" />
+    <PackageReference Include="JetBrains.Annotations" PrivateAssets="All" />
+  </ItemGroup>
+
+</Project>

package/package.json

@@ -1,40 +1,43 @@
-{
-  "name": "generator-aspnet-oauth",
-  "version": "8.0.0",
-  "description": "Yeoman generator for OAuth Providers for ASP.NET Core",
-  "license": "MIT",
-  "main": "app/index.js",
-  "repository": "aspnet-contrib/generator-aspnet-oauth",
-  "engines": {
-    "node": ">=14"
-  },
-  "author": {
-    "name": "Jerrie Pelser",
-    "email": "jerrie@jerriepelser.com",
-    "url": "https://github.com/jerriep"
-  },
-  "scripts": {
-    "test": "mocha"
-  },
-  "files": [
-    "generators"
-  ],
-  "keywords": [
-    "yeoman-generator",
-    "ASP.NET",
-    "aspnet",
-    "oauth"
-  ],
-  "dependencies": {
-    "cross-fetch": "^3.1.5",
-    "query-string": "^7.1.1",
-    "yosay": "^2.0.2",
-    "yeoman-generator": "^5.7.0"
-  },
-  "devDependencies": {
-    "glob": "^8.0.3",
-    "mocha": "^10.1.0",
-    "yeoman-assert": "^3.1.1",
-    "yeoman-test": "^6.3.0"
-  }
-}
+{
+  "name": "generator-aspnet-oauth",
+  "version": "9.0.1",
+  "description": "Yeoman generator for OAuth Providers for ASP.NET Core",
+  "license": "MIT",
+  "main": "app/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aspnet-contrib/generator-aspnet-oauth.git"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "author": {
+    "name": "Jerrie Pelser",
+    "email": "jerrie@jerriepelser.com",
+    "url": "https://github.com/jerriep"
+  },
+  "scripts": {
+    "test": "mocha"
+  },
+  "files": [
+    "generators"
+  ],
+  "keywords": [
+    "yeoman-generator",
+    "ASP.NET",
+    "aspnet",
+    "oauth"
+  ],
+  "dependencies": {
+    "cross-fetch": "^4.1.0",
+    "query-string": "^7.1.1",
+    "yosay": "^2.0.2",
+    "yeoman-generator": "^5.7.0"
+  },
+  "devDependencies": {
+    "glob": "^11.0.1",
+    "mocha": "^11.1.0",
+    "yeoman-assert": "^3.1.1",
+    "yeoman-test": "^6.3.0"
+  }
+}