@adonisjs/ally 6.0.0 → 6.1.0

package/build/index.js

@@ -1,17 +1,18 @@
 import {
   Oauth1Driver
-} from "./chunk-KWRXS6EG.js";
+} from "./chunk-SBQAXPUK.js";
 import {
   AllyManager
-} from "./chunk-SZ4YJCVU.js";
+} from "./chunk-TFPW7D75.js";
 import {
   Oauth2Driver
-} from "./chunk-WM3V3APX.js";
+} from "./chunk-46TOMXWK.js";
+import {
+  RedirectRequest
+} from "./chunk-NK6X76EQ.js";
 import {
-  RedirectRequest,
   errors_exports
-} from "./chunk-KSJ4CFTC.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-6BP2DK5A.js";
 
 // index.ts
 import { HttpClient } from "@poppinss/oauth-client";
@@ -94,53 +95,113 @@ function defineConfig(config) {
   });
 }
 var services = {
+  /**
+   * Create a config provider for the Discord OAuth2 driver.
+   *
+   * @param config - Discord driver configuration.
+   * @returns A lazily resolved config provider for the Discord driver.
+   */
   discord(config) {
     return configProvider.create(async () => {
       const { DiscordDriver } = await import("./src/drivers/discord.js");
       return (ctx) => new DiscordDriver(ctx, config);
     });
   },
+  /**
+   * Create a config provider for the Facebook OAuth2 driver.
+   *
+   * @param config - Facebook driver configuration.
+   * @returns A lazily resolved config provider for the Facebook driver.
+   */
   facebook(config) {
     return configProvider.create(async () => {
       const { FacebookDriver } = await import("./src/drivers/facebook.js");
       return (ctx) => new FacebookDriver(ctx, config);
     });
   },
+  /**
+   * Create a config provider for the GitHub OAuth2 driver.
+   *
+   * @param config - GitHub driver configuration.
+   * @returns A lazily resolved config provider for the GitHub driver.
+   */
   github(config) {
     return configProvider.create(async () => {
       const { GithubDriver } = await import("./src/drivers/github.js");
       return (ctx) => new GithubDriver(ctx, config);
     });
   },
+  /**
+   * Create a config provider for the Google OAuth2 driver.
+   *
+   * @param config - Google driver configuration.
+   * @returns A lazily resolved config provider for the Google driver.
+   */
   google(config) {
     return configProvider.create(async () => {
       const { GoogleDriver } = await import("./src/drivers/google.js");
       return (ctx) => new GoogleDriver(ctx, config);
     });
   },
+  /**
+   * Create a config provider for the LinkedIn OAuth2 driver.
+   *
+   * @param config - LinkedIn driver configuration.
+   * @returns A lazily resolved config provider for the LinkedIn driver.
+   */
   linkedin(config) {
     return configProvider.create(async () => {
       const { LinkedInDriver } = await import("./src/drivers/linked_in.js");
       return (ctx) => new LinkedInDriver(ctx, config);
     });
   },
+  /**
+   * Create a config provider for the LinkedIn OpenID Connect driver.
+   *
+   * @param config - LinkedIn OpenID Connect driver configuration.
+   * @returns A lazily resolved config provider for the LinkedIn OpenID Connect driver.
+   */
   linkedinOpenidConnect(config) {
     return configProvider.create(async () => {
       const { LinkedInOpenidConnectDriver } = await import("./src/drivers/linked_in_openid_connect.js");
       return (ctx) => new LinkedInOpenidConnectDriver(ctx, config);
     });
   },
+  /**
+   * Create a config provider for the Spotify OAuth2 driver.
+   *
+   * @param config - Spotify driver configuration.
+   * @returns A lazily resolved config provider for the Spotify driver.
+   */
   spotify(config) {
     return configProvider.create(async () => {
       const { SpotifyDriver } = await import("./src/drivers/spotify.js");
       return (ctx) => new SpotifyDriver(ctx, config);
     });
   },
+  /**
+   * Create a config provider for the Twitter OAuth1 driver.
+   *
+   * @param config - Twitter driver configuration.
+   * @returns A lazily resolved config provider for the Twitter driver.
+   */
   twitter(config) {
     return configProvider.create(async () => {
       const { TwitterDriver } = await import("./src/drivers/twitter.js");
       return (ctx) => new TwitterDriver(ctx, config);
     });
+  },
+  /**
+   * Create a config provider for the X OAuth2 driver.
+   *
+   * @param config - X driver configuration.
+   * @returns A lazily resolved config provider for the X driver.
+   */
+  twitterX(config) {
+    return configProvider.create(async () => {
+      const { TwitterXDriver } = await import("./src/drivers/twitter_x.js");
+      return (ctx) => new TwitterXDriver(ctx, config);
+    });
   }
 };
 export {

package/build/providers/ally_provider.d.ts

@@ -10,6 +10,16 @@ declare module '@adonisjs/core/http' {
  */
 export default class AllyProvider {
     protected app: ApplicationService;
+    /**
+     * Create a new Ally provider instance.
+     *
+     * @param app - The AdonisJS application service.
+     */
     constructor(app: ApplicationService);
+    /**
+     * Boot the provider and register the `ctx.ally` getter.
+     *
+     * @returns A promise that resolves once the provider has been booted.
+     */
     boot(): Promise<void>;
 }

package/build/providers/ally_provider.js

@@ -1,16 +1,27 @@
 import {
   AllyManager
-} from "../chunk-SZ4YJCVU.js";
-import "../chunk-MLKGABMK.js";
+} from "../chunk-TFPW7D75.js";
+import "../chunk-6BP2DK5A.js";
 
 // providers/ally_provider.ts
 import { configProvider } from "@adonisjs/core";
 import { HttpContext } from "@adonisjs/core/http";
 import { RuntimeException } from "@adonisjs/core/exceptions";
 var AllyProvider = class {
+  /**
+   * Create a new Ally provider instance.
+   *
+   * @param app - The AdonisJS application service.
+   */
   constructor(app) {
     this.app = app;
   }
+  app;
+  /**
+   * Boot the provider and register the `ctx.ally` getter.
+   *
+   * @returns A promise that resolves once the provider has been booted.
+   */
   async boot() {
     const allyConfigProvider = this.app.config.get("ally");
     const config = await configProvider.resolve(this.app, allyConfigProvider);

package/build/src/abstract_drivers/oauth1.d.ts

@@ -80,6 +80,7 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
      * authorization from the current request.
      *
      * @param callback - Optional callback to customize the API request
+     * @returns A promise resolving to the authenticated user profile.
      */
     abstract user(callback?: (request: ApiRequestContract) => void): Promise<AllyUserContract<Token>>;
     /**
@@ -89,6 +90,7 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
      * @param token - The access token
      * @param secret - The token secret
      * @param callback - Optional callback to customize the API request
+     * @returns A promise resolving to the authenticated user profile.
      */
     abstract userFromTokenAndSecret(token: string, secret: string, callback?: (request: ApiRequestContract) => void): Promise<AllyUserContract<{
         token: string;
@@ -97,6 +99,8 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
     /**
      * Check if the current error indicates that the user denied access.
      * Different providers use different error codes for access denial.
+     *
+     * @returns `true` when the provider reported an access-denied state.
      */
     abstract accessDenied(): boolean;
     /**
@@ -111,9 +115,13 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
     /**
      * The cookie name for storing the OAuth token secret.
      * Automatically derived from the token cookie name.
+     *
+     * @returns The cookie name used to persist the OAuth token secret.
      */
     protected get oauthSecretCookieName(): string;
     /**
+     * Create a new OAuth1 driver instance.
+     *
      * @param ctx - The current HTTP context
      * @param config - OAuth1 driver configuration
      */
@@ -123,6 +131,7 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
      * with scope support.
      *
      * @param url - The base authorization URL
+     * @returns A redirect request builder for the given URL.
      */
     protected urlBuilder(url: string): RedirectRequest<string>;
     /**
@@ -142,6 +151,8 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
     /**
      * OAuth1 does not support stateless authentication due to the
      * three-legged authentication flow requiring token persistence.
+     *
+     * @returns This method never returns.
      */
     stateless(): never;
     /**
@@ -150,6 +161,7 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
      * in a different context.
      *
      * @param callback - Optional callback to customize the redirect request
+     * @returns A promise resolving to the authorization URL.
      *
      * @example
      * ```ts
@@ -162,6 +174,7 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
      * The request token is automatically obtained and stored in cookies.
      *
      * @param callback - Optional callback to customize the redirect request
+     * @returns A promise that resolves after the redirect response is prepared.
      *
      * @example
      * ```ts
@@ -172,23 +185,33 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
     /**
      * Check if the OAuth token from the callback matches the token
      * stored in the cookie.
+     *
+     * @returns `true` when the callback token does not match the stored token.
      */
     stateMisMatch(): boolean;
     /**
      * Check if an error was returned by the OAuth provider.
+     *
+     * @returns `true` when an error exists on the callback request.
      */
     hasError(): boolean;
     /**
      * Get the error code or message returned by the OAuth provider.
      * Returns 'unknown_error' if no verifier is present and no error was specified.
+     *
+     * @returns The provider error value when present.
      */
     getError(): string | null;
     /**
      * Get the OAuth verifier from the callback request.
+     *
+     * @returns The OAuth verifier when present.
      */
     getCode(): string | null;
     /**
      * Check if the OAuth verifier is present in the callback request.
+     *
+     * @returns `true` when the callback request contains an OAuth verifier.
      */
     hasCode(): boolean;
     /**
@@ -197,6 +220,7 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
      * making the request.
      *
      * @param callback - Optional callback to customize the token request
+     * @returns A promise resolving to the access token payload.
      *
      * @example
      * ```ts
@@ -206,6 +230,8 @@ export declare abstract class Oauth1Driver<Token extends Oauth1AccessToken, Scop
     accessToken(callback?: (request: ApiRequestContract) => void): Promise<Token>;
     /**
      * Not applicable with OAuth1. Use `userFromTokenAndSecret` instead.
+     *
+     * @returns This method never returns.
      */
     userFromToken(): Promise<never>;
 }

package/build/src/abstract_drivers/oauth2.d.ts

@@ -39,6 +39,11 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      * for your driver to avoid conflicts. For example: `gh_oauth_state`
      */
     protected abstract stateCookieName: string;
+    /**
+     * The cookie name for storing the PKCE code verifier. Define this property
+     * in child classes that require PKCE.
+     */
+    protected codeVerifierCookieName?: string;
     /**
      * The query parameter name for sending the state to the OAuth provider.
      * This is typically 'state' but varies by provider. Check the provider's
@@ -80,6 +85,7 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      * authorization code from the current request.
      *
      * @param callback - Optional callback to customize the API request
+     * @returns A promise resolving to the authenticated user profile.
      */
     abstract user(callback?: (request: ApiRequestContract) => void): Promise<AllyUserContract<Token>>;
     /**
@@ -88,6 +94,7 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      *
      * @param token - The access token
      * @param callback - Optional callback to customize the API request
+     * @returns A promise resolving to the authenticated user profile.
      */
     abstract userFromToken(token: string, callback?: (request: ApiRequestContract) => void): Promise<AllyUserContract<{
         token: string;
@@ -96,6 +103,8 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
     /**
      * Check if the current error indicates that the user denied access.
      * Different providers use different error codes for access denial.
+     *
+     * @returns `true` when the provider reported an access-denied state.
      */
     abstract accessDenied(): boolean;
     /**
@@ -107,6 +116,13 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      */
     protected stateCookieValue?: string;
     /**
+     * Cached PKCE code verifier value read from the cookie via
+     * loadState
+     */
+    protected codeVerifierCookieValue?: string;
+    /**
+     * Create a new OAuth2 driver instance.
+     *
      * @param ctx - The current HTTP context
      * @param config - OAuth2 driver configuration
      */
@@ -116,12 +132,13 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      * with scope support.
      *
      * @param url - The base authorization URL
+     * @returns A redirect request builder for the given URL.
      */
     protected urlBuilder(url: string): RedirectRequest<string>;
     /**
      * Loads the state value from the encrypted cookie and immediately clears
-     * the cookie. This must be called by child classes in their constructor
-     * to enable CSRF protection.
+     * the cookie. When PKCE is enabled, it also loads the PKCE code verifier.
+     * This must be called by child classes in their constructor.
      *
      * @example
      * ```ts
@@ -132,10 +149,26 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      * ```
      */
     protected loadState(): void;
+    /**
+     * Returns the PKCE code verifier for building the authorization redirect.
+     * This method is expected to create and persist the verifier for later use.
+     *
+     * @returns The generated PKCE code verifier or `null` when PKCE is disabled.
+     */
+    protected getPkceCodeVerifierForRedirect(): string | null;
+    /**
+     * Returns the PKCE code verifier for the access token exchange.
+     * This method only reads the verifier that was persisted during redirect.
+     *
+     * @returns The persisted PKCE code verifier or `null` when PKCE is disabled.
+     */
+    protected getPkceCodeVerifierForAccessToken(): string | null;
     /**
      * Enable stateless authentication by disabling CSRF state verification.
      * Only use this in scenarios where state verification is not required.
      *
+     * @returns The current driver instance.
+     *
      * @example
      * ```ts
      * await ally.use('github').stateless().redirect()
@@ -148,6 +181,7 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      * in a different context.
      *
      * @param callback - Optional callback to customize the redirect request
+     * @returns A promise resolving to the authorization URL.
      *
      * @example
      * ```ts
@@ -162,6 +196,7 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      * The state parameter is automatically set for CSRF protection.
      *
      * @param callback - Optional callback to customize the redirect request
+     * @returns A promise that resolves after the redirect response is prepared.
      *
      * @example
      * ```ts
@@ -175,23 +210,33 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
     /**
      * Check if the state parameter from the callback matches the state
      * stored in the cookie. Returns false in stateless mode.
+     *
+     * @returns `true` when the state validation fails.
      */
     stateMisMatch(): boolean;
     /**
      * Check if an error was returned by the OAuth provider.
+     *
+     * @returns `true` when an error exists on the callback request.
      */
     hasError(): boolean;
     /**
      * Get the error code or message returned by the OAuth provider.
      * Returns 'unknown_error' if no code is present and no error was specified.
+     *
+     * @returns The provider error value when present.
      */
     getError(): string | null;
     /**
      * Get the authorization code from the callback request.
+     *
+     * @returns The authorization code when present.
      */
     getCode(): string | null;
     /**
      * Check if the authorization code is present in the callback request.
+     *
+     * @returns `true` when the callback request contains an authorization code.
      */
     hasCode(): boolean;
     /**
@@ -199,6 +244,7 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
      * validates the state and checks for errors before making the request.
      *
      * @param callback - Optional callback to customize the token request
+     * @returns A promise resolving to the access token payload.
      *
      * @example
      * ```ts
@@ -208,6 +254,8 @@ export declare abstract class Oauth2Driver<Token extends Oauth2AccessToken, Scop
     accessToken(callback?: (request: ApiRequestContract) => void): Promise<Token>;
     /**
      * Not applicable with OAuth2. Use `userFromToken` instead.
+     *
+     * @returns This method never returns.
      */
     userFromTokenAndSecret(): Promise<never>;
 }

package/build/src/ally_manager.d.ts

@@ -1,5 +1,5 @@
 import type { HttpContext } from '@adonisjs/core/http';
-import type { AllyManagerDriverFactory } from './types.ts';
+import type { AllyManagerDriverFactory, AllyManagerUseOptions } from './types.ts';
 /**
  * AllyManager is used to create and manage social authentication driver
  * instances during an HTTP request. The drivers are cached during the
@@ -20,23 +20,87 @@ import type { AllyManagerDriverFactory } from './types.ts';
  */
 export declare class AllyManager<KnownSocialProviders extends Record<string, AllyManagerDriverFactory>> {
     #private;
+    /**
+     * The configured provider factories available for the current application.
+     */
     config: KnownSocialProviders;
     /**
+     * Create a new Ally manager for the current request.
+     *
      * @param config - Map of provider names to driver factory functions
      * @param ctx - The current HTTP context
      */
-    constructor(config: KnownSocialProviders, ctx: HttpContext);
+    constructor(
+    /**
+     * The configured provider factories available for the current application.
+     */
+    config: KnownSocialProviders, ctx: HttpContext);
+    /**
+     * Find if a provider has been configured.
+     *
+     * @param provider - The provider name to check.
+     * @returns `true` when the provider exists in the manager config.
+     *
+     * @example
+     * ```ts
+     * if (ally.has(provider)) {
+     *   await ally.use(provider).redirect()
+     * }
+     * ```
+     */
+    has(provider: string): provider is Extract<keyof KnownSocialProviders, string>;
+    /**
+     * Find if a provider allows local signup.
+     *
+     * @param provider - The configured provider name to inspect.
+     * @returns `true` when the provider does not opt out of local signup.
+     *
+     * @example
+     * ```ts
+     * if (ally.allowsLocalSignup('github')) {
+     *   return ally.use('github', { intent: 'signup' }).redirect()
+     * }
+     * ```
+     */
+    allowsLocalSignup(provider: keyof KnownSocialProviders & string): boolean;
+    /**
+     * Returns configured provider names.
+     *
+     * @returns An array of configured provider names.
+     *
+     * @example
+     * ```ts
+     * const providers = ally.configuredProviderNames()
+     * ```
+     */
+    configuredProviderNames(): Array<Extract<keyof KnownSocialProviders, string>>;
+    /**
+     * Returns provider names that allow local signup.
+     *
+     * @returns An array of configured provider names that allow signup flows.
+     *
+     * @example
+     * ```ts
+     * const signupProviders = ally.signupProviderNames()
+     * ```
+     */
+    signupProviderNames(): Array<Extract<keyof KnownSocialProviders, string>>;
     /**
      * Get a driver instance for the specified social provider. The driver
      * instance is cached for the duration of the HTTP request.
      *
      * @param provider - The name of the social provider (e.g., 'github', 'google')
+     * @param options - Additional options used to qualify the provider usage.
+     * @returns The instantiated social authentication driver.
      *
      * @example
      * ```ts
      * const github = ally.use('github')
      * await github.redirect()
+     *
+     * const signupDriver = ally.use('github', { intent: 'signup' })
+     * await signupDriver.redirect()
      * ```
      */
-    use<SocialProvider extends keyof KnownSocialProviders>(provider: SocialProvider): ReturnType<KnownSocialProviders[SocialProvider]>;
+    use<SocialProvider extends keyof KnownSocialProviders>(provider: SocialProvider, options?: AllyManagerUseOptions): ReturnType<KnownSocialProviders[SocialProvider]>;
 }

package/build/src/define_config.d.ts

@@ -4,14 +4,17 @@ import type { GoogleDriver } from './drivers/google.ts';
 import type { GithubDriver } from './drivers/github.ts';
 import type { SpotifyDriver } from './drivers/spotify.ts';
 import type { TwitterDriver } from './drivers/twitter.ts';
+import type { TwitterXDriver } from './drivers/twitter_x.ts';
 import type { DiscordDriver } from './drivers/discord.ts';
 import type { FacebookDriver } from './drivers/facebook.ts';
 import type { LinkedInDriver } from './drivers/linked_in.ts';
 import type { LinkedInOpenidConnectDriver } from './drivers/linked_in_openid_connect.ts';
-import type { GoogleDriverConfig, GithubDriverConfig, SpotifyDriverConfig, DiscordDriverConfig, TwitterDriverConfig, LinkedInDriverConfig, LinkedInOpenidConnectDriverConfig, FacebookDriverConfig, AllyManagerDriverFactory } from './types.ts';
+import type { GoogleDriverConfig, GithubDriverConfig, SpotifyDriverConfig, DiscordDriverConfig, TwitterDriverConfig, TwitterXDriverConfig, LinkedInDriverConfig, LinkedInOpenidConnectDriverConfig, FacebookDriverConfig, AllyManagerDriverFactory } from './types.ts';
 /**
  * Shape of config after it has been resolved from
  * the config provider
+ *
+ * Maps config providers to their resolved driver factory values.
  */
 type ResolvedConfig<KnownSocialProviders extends Record<string, AllyManagerDriverFactory | ConfigProvider<AllyManagerDriverFactory>>> = {
     [K in keyof KnownSocialProviders]: KnownSocialProviders[K] extends ConfigProvider<infer A> ? A : KnownSocialProviders[K];
@@ -22,6 +25,7 @@ type ResolvedConfig<KnownSocialProviders extends Record<string, AllyManagerDrive
  * functions or config providers.
  *
  * @param config - An object mapping provider names to driver factories
+ * @returns A config provider that resolves all registered providers.
  *
  * @example
  * ```ts
@@ -47,6 +51,16 @@ export declare function defineConfig<KnownSocialProviders extends Record<string,
  *
  * @example
  * ```ts
+ * const github = services.github({
+ *   clientId: env.get('GITHUB_CLIENT_ID'),
+ *   clientSecret: env.get('GITHUB_CLIENT_SECRET'),
+ *   callbackUrl: 'http://localhost:3333/github/callback',
+ *   disallowLocalSignup: true,
+ * })
+ * ```
+ *
+ * @example
+ * ```ts
  * export default defineConfig({
  *   github: services.github({
  *     clientId: env.get('GITHUB_CLIENT_ID'),
@@ -66,5 +80,6 @@ export declare const services: {
     linkedinOpenidConnect: (config: LinkedInOpenidConnectDriverConfig) => ConfigProvider<(ctx: HttpContext) => LinkedInOpenidConnectDriver>;
     spotify: (config: SpotifyDriverConfig) => ConfigProvider<(ctx: HttpContext) => SpotifyDriver>;
     twitter: (config: TwitterDriverConfig) => ConfigProvider<(ctx: HttpContext) => TwitterDriver>;
+    twitterX: (config: TwitterXDriverConfig) => ConfigProvider<(ctx: HttpContext) => TwitterXDriver>;
 };
 export {};

package/build/src/drivers/discord.d.ts

@@ -36,8 +36,17 @@ import { Oauth2Driver } from '../abstract_drivers/oauth2.ts';
  */
 export declare class DiscordDriver extends Oauth2Driver<DiscordToken, DiscordScopes> {
     config: DiscordDriverConfig;
+    /**
+     * Discord token endpoint URL.
+     */
     protected accessTokenUrl: string;
+    /**
+     * Discord authorization endpoint URL.
+     */
     protected authorizeUrl: string;
+    /**
+     * Discord user profile endpoint URL.
+     */
     protected userInfoUrl: string;
     /**
      * The param name for the authorization code

package/build/src/drivers/discord.js

@@ -1,8 +1,8 @@
 import {
   Oauth2Driver
-} from "../../chunk-WM3V3APX.js";
-import "../../chunk-KSJ4CFTC.js";
-import "../../chunk-MLKGABMK.js";
+} from "../../chunk-46TOMXWK.js";
+import "../../chunk-NK6X76EQ.js";
+import "../../chunk-6BP2DK5A.js";
 
 // src/drivers/discord.ts
 var DiscordDriver = class extends Oauth2Driver {
@@ -15,8 +15,18 @@ var DiscordDriver = class extends Oauth2Driver {
     this.config = config;
     this.loadState();
   }
+  config;
+  /**
+   * Discord token endpoint URL.
+   */
   accessTokenUrl = "https://discord.com/api/oauth2/token";
+  /**
+   * Discord authorization endpoint URL.
+   */
   authorizeUrl = "https://discord.com/oauth2/authorize";
+  /**
+   * Discord user profile endpoint URL.
+   */
   userInfoUrl = "https://discord.com/api/users/@me";
   /**
    * The param name for the authorization code

package/build/src/drivers/facebook.d.ts

@@ -36,8 +36,17 @@ import { Oauth2Driver } from '../abstract_drivers/oauth2.ts';
  */
 export declare class FacebookDriver extends Oauth2Driver<FacebookToken, FacebookScopes> {
     config: FacebookDriverConfig;
+    /**
+     * Facebook token endpoint URL.
+     */
     protected accessTokenUrl: string;
+    /**
+     * Facebook authorization endpoint URL.
+     */
     protected authorizeUrl: string;
+    /**
+     * Facebook profile endpoint URL.
+     */
     protected userInfoUrl: string;
     /**
      * The default set of fields to query for the user request