@tstdl/base 0.92.145 → 0.92.147

package/authentication/client/module.d.ts

@@ -1,10 +1,29 @@
 import type { ApiClientImplementation } from '../../api/index.js';
 import { Injector } from '../../injector/injector.js';
-import type { Type } from '../../types.js';
+import type { Type } from '../../types/index.js';
 import type { AuthenticationApiDefinition } from '../authentication.api.js';
+/**
+ * Configuration for {@link configureAuthenticationClient}
+ */
 export type AuthenticationClientModuleConfig = {
+    /**
+     * Optional custom authentication api client
+     */
     authenticationApiClient?: Type<ApiClientImplementation<AuthenticationApiDefinition<any, any, any>>>;
+    /**
+     * Optional initial authentication data
+     */
     initialAuthenticationData?: unknown;
+    /**
+     * Whether to register the {@link waitForAuthenticationCredentialsMiddleware} for all http clients.
+     *
+     * @default false
+     */
     registerMiddleware?: boolean;
 };
+/**
+ * Configures authentication client services.
+ * @param config Configuration
+ * @param injector The injector to use. If not provided, the current injector is used.
+ */
 export declare function configureAuthenticationClient(config: AuthenticationClientModuleConfig, injector?: Injector | null): void;

package/authentication/client/module.js

@@ -5,6 +5,11 @@ import { isDefined } from '../../utils/type-guards.js';
 import { AuthenticationClientService } from './authentication.service.js';
 import { waitForAuthenticationCredentialsMiddleware } from './http-client.middleware.js';
 import { AUTHENTICATION_API_CLIENT, INITIAL_AUTHENTICATION_DATA } from './tokens.js';
+/**
+ * Configures authentication client services.
+ * @param config Configuration
+ * @param injector The injector to use. If not provided, the current injector is used.
+ */
 export function configureAuthenticationClient(config, injector = getCurrentInjector()) {
     if (isDefined(config.authenticationApiClient)) {
         (injector ?? Injector).registerSingleton(AUTHENTICATION_API_CLIENT, { useToken: config.authenticationApiClient });
@@ -17,7 +22,7 @@ export function configureAuthenticationClient(config, injector = getCurrentInjec
             useFactory(_, context) {
                 const authenticationService = context.resolve(AuthenticationClientService, undefined, { forwardRef: true, forwardRefTypeHint: 'object' });
                 return waitForAuthenticationCredentialsMiddleware(authenticationService);
-            }
+            },
         }, { multi: true });
     }
 }

package/authentication/client/tokens.d.ts

@@ -1,4 +1,10 @@
 import type { ApiClientImplementation } from '../../api/index.js';
 import type { AuthenticationApiDefinition } from '../authentication.api.js';
+/**
+ * Injection token for {@link AuthenticationApiClient}
+ */
 export declare const AUTHENTICATION_API_CLIENT: import("../../injector/token.js").InjectionToken<ApiClientImplementation<AuthenticationApiDefinition<any, any, any>>, never>;
+/**
+ * Injection token for initial authentication data
+ */
 export declare const INITIAL_AUTHENTICATION_DATA: import("../../injector/token.js").InjectionToken<unknown, never>;

package/authentication/client/tokens.js

@@ -1,6 +1,12 @@
 import { Injector } from '../../injector/injector.js';
 import { injectionToken } from '../../injector/token.js';
 import { AuthenticationApiClient } from './api.client.js';
+/**
+ * Injection token for {@link AuthenticationApiClient}
+ */
 export const AUTHENTICATION_API_CLIENT = injectionToken('ApiClientImplementation');
+/**
+ * Injection token for initial authentication data
+ */
 export const INITIAL_AUTHENTICATION_DATA = injectionToken('initial authentication data');
 Injector.registerSingleton(AUTHENTICATION_API_CLIENT, { useToken: AuthenticationApiClient });

package/authentication/models/authentication-credentials.model.d.ts

@@ -2,6 +2,12 @@ import { Entity } from '../../orm/index.js';
 export declare class AuthenticationCredentials extends Entity {
     subject: string;
     hashVersion: number;
+    /**
+     * The salt used to hash the secret.
+     */
     salt: Uint8Array;
+    /**
+     * The hashed secret.
+     */
     hash: Uint8Array;
 }

package/authentication/models/authentication-credentials.model.js

@@ -13,7 +13,13 @@ import { Integer, StringProperty, Uint8ArrayProperty } from '../../schema/index.
 let AuthenticationCredentials = class AuthenticationCredentials extends Entity {
     subject;
     hashVersion;
+    /**
+     * The salt used to hash the secret.
+     */
     salt;
+    /**
+     * The hashed secret.
+     */
     hash;
 };
 __decorate([

package/authentication/models/authentication-session.model.d.ts

@@ -5,6 +5,12 @@ export declare class AuthenticationSession extends Entity {
     begin: Timestamp;
     end: Timestamp;
     refreshTokenHashVersion: number;
+    /**
+     * The salt used to hash the refresh token.
+     */
     refreshTokenSalt: Uint8Array;
+    /**
+     * The hashed refresh token.
+     */
     refreshTokenHash: Uint8Array;
 }

package/authentication/models/authentication-session.model.js

@@ -16,7 +16,13 @@ let AuthenticationSession = class AuthenticationSession extends Entity {
     begin;
     end;
     refreshTokenHashVersion;
+    /**
+     * The salt used to hash the refresh token.
+     */
     refreshTokenSalt;
+    /**
+     * The hashed refresh token.
+     */
     refreshTokenHash;
 };
 __decorate([

package/authentication/models/init-secret-reset-data.model.d.ts

@@ -1,5 +1,14 @@
+/**
+ * Data for initializing a secret reset.
+ */
 export declare class InitSecretResetData {
-    /** Subject is not checked for existence. */
+    /**
+     * The subject for which to reset the secret.
+     * Note: The existence of the subject is not checked to avoid data leaks.
+     */
     subject: string;
+    /**
+     * The secret reset token.
+     */
     token: string;
 }

package/authentication/models/init-secret-reset-data.model.js

@@ -8,9 +8,18 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { StringProperty } from '../../schema/index.js';
+/**
+ * Data for initializing a secret reset.
+ */
 export class InitSecretResetData {
-    /** Subject is not checked for existence. */
+    /**
+     * The subject for which to reset the secret.
+     * Note: The existence of the subject is not checked to avoid data leaks.
+     */
     subject;
+    /**
+     * The secret reset token.
+     */
     token;
 }
 __decorate([

package/authentication/models/token-payload-base.model.d.ts

@@ -1,13 +1,33 @@
+/**
+ * Base for token payloads.
+ */
 export declare class TokenPayloadBase {
-    /** Token id */
+    /**
+     * Token id.
+     */
     jti: string;
-    /** Issue timestamp in seconds */
+    /**
+     * Issue timestamp in seconds.
+     */
     iat: number;
-    /** Expiration timestamp in seconds */
+    /**
+     * Expiration timestamp in seconds.
+     */
     exp: number;
-    /** Refresh token expiration timestamp in seconds */
+    /**
+     * Refresh token expiration timestamp in seconds.
+     */
     refreshTokenExp: number;
+    /**
+     * The id of the session.
+     */
     sessionId: string;
+    /**
+     * The subject of the token.
+     */
     subject: string;
+    /**
+     * The subject of the impersonator, if any.
+     */
     impersonator?: string;
 }

package/authentication/models/token-payload-base.model.js

@@ -8,17 +8,37 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { NumberProperty, StringProperty } from '../../schema/index.js';
+/**
+ * Base for token payloads.
+ */
 export class TokenPayloadBase {
-    /** Token id */
+    /**
+     * Token id.
+     */
     jti;
-    /** Issue timestamp in seconds */
+    /**
+     * Issue timestamp in seconds.
+     */
     iat;
-    /** Expiration timestamp in seconds */
+    /**
+     * Expiration timestamp in seconds.
+     */
     exp;
-    /** Refresh token expiration timestamp in seconds */
+    /**
+     * Refresh token expiration timestamp in seconds.
+     */
     refreshTokenExp;
+    /**
+     * The id of the session.
+     */
     sessionId;
+    /**
+     * The subject of the token.
+     */
     subject;
+    /**
+     * The subject of the impersonator, if any.
+     */
     impersonator;
 }
 __decorate([

package/authentication/models/token.model.d.ts

@@ -1,20 +1,51 @@
-import type { Record } from '../../types.js';
+import type { Record } from '../../types/index.js';
 import type { JwtToken, JwtTokenHeader } from '../../utils/jwt.js';
 import type { TokenPayloadBase } from './token-payload-base.model.js';
 export type TokenHeader = {
+    /**
+     * Token version.
+     */
     v: number;
 };
+/**
+ * JWT token with custom header.
+ * @template AdditionalTokenPayload The type of the additional token payload.
+ */
 export type Token<AdditionalTokenPayload extends Record = Record<never>> = JwtToken<TokenPayload<AdditionalTokenPayload>, JwtTokenHeader<TokenHeader>>;
+/**
+ * Token payload.
+ * @template T The type of the additional token payload.
+ */
 export type TokenPayload<T extends Record = Record<never>> = T & TokenPayloadBase;
 export type RefreshToken = JwtToken<{
-    /** expiration timestamp in seconds */
+    /**
+     * Expiration timestamp in seconds.
+     */
     exp: number;
+    /**
+     * The subject of the token.
+     */
     subject: string;
+    /**
+     * The subject of the impersonator, if any.
+     */
     impersonator?: string;
+    /**
+     * The id of the session.
+     */
     sessionId: string;
+    /**
+     * The secret to use for refreshing the token.
+     */
     secret: string;
 }>;
 export type SecretResetToken = JwtToken<{
+    /**
+     * Expiration timestamp in seconds.
+     */
     exp: number;
+    /**
+     * The subject for which to reset the secret.
+     */
     subject: string;
 }>;

package/authentication/server/authentication-ancillary.service.d.ts

@@ -1,5 +1,5 @@
 import { type EnumType } from '../../enumeration/enumeration.js';
-import type { Record } from '../../types.js';
+import type { Record } from '../../types/index.js';
 import type { TokenPayload } from '../index.js';
 import type { InitSecretResetData } from '../models/init-secret-reset-data.model.js';
 export declare const GetTokenPayloadContextAction: {
@@ -8,6 +8,9 @@ export declare const GetTokenPayloadContextAction: {
 };
 export type GetTokenPayloadContextAction = EnumType<typeof GetTokenPayloadContextAction>;
 export type GetTokenPayloadContext = {
+    /**
+     * The action that triggered the token payload retrieval.
+     */
     action: GetTokenPayloadContextAction;
 };
 export type ResolveSubjectResult = {
@@ -17,6 +20,13 @@ export type ResolveSubjectResult = {
     success: false;
     subject?: undefined;
 };
+/**
+ * Ancillary service for authentication to hook into the authentication process.
+ *
+ * @param AdditionalTokenPayload Type of additional token payload
+ * @param AuthenticationData Type of additional authentication data
+ * @param AdditionalInitSecretResetData Type of additional secret reset data
+ */
 export declare abstract class AuthenticationAncillaryService<AdditionalTokenPayload extends Record = Record<never>, AuthenticationData = void, AdditionalInitSecretResetData = void> {
     /**
      * Resolve a provided subject to the actual subject used for authentication.
@@ -26,12 +36,25 @@ export declare abstract class AuthenticationAncillaryService<AdditionalTokenPayl
      * If the subject cannot be resolved, return an object with success set to false.
      */
     abstract resolveSubject(providedSubject: string): ResolveSubjectResult | Promise<ResolveSubjectResult>;
+    /**
+     * Get the additional token payload for a subject.
+     * @param subject The subject for which to get the payload.
+     * @param authenticationData Additional authentication data.
+     * @param context Context for getting the token payload.
+     * @returns The additional token payload.
+     */
     abstract getTokenPayload(subject: string, authenticationData: AuthenticationData, context: GetTokenPayloadContext): AdditionalTokenPayload | Promise<AdditionalTokenPayload>;
+    /**
+     * Handle the initialization of a secret reset.
+     * @param data Data for initializing the secret reset.
+     */
     abstract handleInitSecretReset(data: InitSecretResetData & AdditionalInitSecretResetData): void | Promise<void>;
     /**
-     * Check if token is allowed to impersonate subject
-     * @param token Token which tries to impersonate
-     * @param subject Subject to impersonate
+     * Check if token is allowed to impersonate subject.
+     * @param token Token which tries to impersonate.
+     * @param subject Subject to impersonate.
+     * @param authenticationData Additional authentication data.
+     * @returns Whether impersonation is allowed.
      */
     abstract canImpersonate(token: TokenPayload<AdditionalTokenPayload>, subject: string, authenticationData: AuthenticationData): boolean | Promise<boolean>;
 }

package/authentication/server/authentication-ancillary.service.js

@@ -3,5 +3,12 @@ export const GetTokenPayloadContextAction = defineEnum('GetTokenPayloadContextAc
     GetToken: 'get-token',
     Refresh: 'refresh',
 });
+/**
+ * Ancillary service for authentication to hook into the authentication process.
+ *
+ * @param AdditionalTokenPayload Type of additional token payload
+ * @param AuthenticationData Type of additional authentication data
+ * @param AdditionalInitSecretResetData Type of additional secret reset data
+ */
 export class AuthenticationAncillaryService {
 }

package/authentication/server/authentication-api-request-token.provider.d.ts

@@ -1,6 +1,9 @@
 import type { ApiRequestData } from '../../api/index.js';
 import { ApiRequestTokenProvider } from '../../api/server/api-request-token.provider.js';
 import { AuthenticationService } from './authentication.service.js';
+/**
+ * Provides the token for an API request from the authorization header.
+ */
 export declare class AuthenticationApiRequestTokenProvider extends ApiRequestTokenProvider {
     private readonly authenticationService;
     constructor(authenticationService: AuthenticationService);

package/authentication/server/authentication-api-request-token.provider.js

@@ -11,6 +11,9 @@ import { ApiRequestTokenProvider } from '../../api/server/api-request-token.prov
 import { Singleton } from '../../injector/decorators.js';
 import { AuthenticationService } from './authentication.service.js';
 import { tryGetAuthorizationTokenStringFromRequest } from './helper.js';
+/**
+ * Provides the token for an API request from the authorization header.
+ */
 let AuthenticationApiRequestTokenProvider = class AuthenticationApiRequestTokenProvider extends ApiRequestTokenProvider {
     authenticationService;
     constructor(authenticationService) {

package/authentication/server/authentication-secret-requirements.validator.d.ts

@@ -7,12 +7,49 @@ export type SecretTestResult = {
     reason: string;
 };
 export declare abstract class AuthenticationSecretRequirementsValidator {
+    /**
+     * Checks the secret against the requirements.
+     * @param secret The secret to check.
+     * @returns The result of the check.
+     */
     abstract checkSecretRequirements(secret: string): Promise<SecretCheckResult>;
+    /**
+     * Tests the secret against the requirements.
+     * @param secret The secret to test.
+     * @returns The result of the test.
+     */
     abstract testSecretRequirements(secret: string): Promise<SecretTestResult>;
+    /**
+     * Validates the secret against the requirements. Throws an error if the requirements are not met.
+     * @param secret The secret to validate.
+     * @throws {SecretRequirementsError} If the secret does not meet the requirements.
+     */
     abstract validateSecretRequirements(secret: string): Promise<void>;
 }
+/**
+ * Default validator for secret requirements.
+ *
+ * Checks for pwned passwords and password strength.
+ * - Pwned passwords are not allowed.
+ * - Password strength must be at least 'medium'.
+ */
 export declare class DefaultAuthenticationSecretRequirementsValidator extends AuthenticationSecretRequirementsValidator {
+    /**
+     * Checks the secret against the requirements.
+     * @param secret The secret to check.
+     * @returns The result of the check.
+     */
     checkSecretRequirements(secret: string): Promise<SecretCheckResult>;
+    /**
+     * Tests the secret against the requirements.
+     * @param secret The secret to test.
+     * @returns The result of the test.
+     */
     testSecretRequirements(secret: string): Promise<SecretTestResult>;
+    /**
+     * Validates the secret against the requirements. Throws an error if the requirements are not met.
+     * @param secret The secret to validate.
+     * @throws {SecretRequirementsError} If the secret does not meet the requirements.
+     */
     validateSecretRequirements(secret: string): Promise<void>;
 }

package/authentication/server/authentication-secret-requirements.validator.js

@@ -11,10 +11,27 @@ import { isNumber } from '../../utils/type-guards.js';
 import { SecretRequirementsError } from '../errors/secret-requirements.error.js';
 export class AuthenticationSecretRequirementsValidator {
 }
+/**
+ * Default validator for secret requirements.
+ *
+ * Checks for pwned passwords and password strength.
+ * - Pwned passwords are not allowed.
+ * - Password strength must be at least 'medium'.
+ */
 let DefaultAuthenticationSecretRequirementsValidator = class DefaultAuthenticationSecretRequirementsValidator extends AuthenticationSecretRequirementsValidator {
+    /**
+     * Checks the secret against the requirements.
+     * @param secret The secret to check.
+     * @returns The result of the check.
+     */
     async checkSecretRequirements(secret) {
         return await checkPassword(secret, { checkForPwned: true });
     }
+    /**
+     * Tests the secret against the requirements.
+     * @param secret The secret to test.
+     * @returns The result of the test.
+     */
     async testSecretRequirements(secret) {
         const result = await this.checkSecretRequirements(secret);
         if (isNumber(result.pwned) && (result.pwned > 0)) {
@@ -25,6 +42,11 @@ let DefaultAuthenticationSecretRequirementsValidator = class DefaultAuthenticati
         }
         return { success: true };
     }
+    /**
+     * Validates the secret against the requirements. Throws an error if the requirements are not met.
+     * @param secret The secret to validate.
+     * @throws {SecretRequirementsError} If the secret does not meet the requirements.
+     */
     async validateSecretRequirements(secret) {
         const result = await this.testSecretRequirements(secret);
         if (!result.success) {

package/authentication/server/authentication.api-controller.d.ts

@@ -1,23 +1,88 @@
 import type { ApiController, ApiRequestContext, ApiServerResult } from '../../api/types.js';
 import { HttpServerResponse } from '../../http/server/index.js';
 import type { ObjectSchemaOrType, SchemaTestable } from '../../schema/index.js';
-import type { Record, Type } from '../../types.js';
+import type { Record, Type } from '../../types/index.js';
 import type { AuthenticationApiDefinition } from '../authentication.api.js';
 import type { TokenResult } from './authentication.service.js';
 import { AuthenticationService } from './authentication.service.js';
+/**
+ * API controller for authentication.
+ *
+ * @template AdditionalTokenPayload Type of additional token payload
+ * @template AuthenticationData Type of additional authentication data
+ * @template AdditionalInitSecretResetData Type of additional secret reset data
+ */
 export declare class AuthenticationApiController<AdditionalTokenPayload extends Record, AuthenticationData, AdditionalInitSecretResetData = void> implements ApiController<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>> {
     readonly authenticationService: AuthenticationService<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>;
     constructor(authenticationService: AuthenticationService<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>);
+    /**
+     * Get a token for a subject and secret.
+     * @param parameters The parameters for the request.
+     * @returns The token result.
+     * @throws {InvalidCredentialsError} If the credentials are invalid.
+     */
     getToken({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'getToken'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'getToken'>>;
+    /**
+     * Refresh a token.
+     * @param request The request context.
+     * @param parameters The parameters for the request.
+     * @returns The token result.
+     */
     refresh({ request, parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'refresh'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'refresh'>>;
+    /**
+     * Impersonate a subject.
+     * @param request The request context.
+     * @param parameters The parameters for the request.
+     * @returns The token result.
+     */
     impersonate({ request, parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'impersonate'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'impersonate'>>;
+    /**
+     * Unimpersonate a subject.
+     * @param request The request context.
+     * @param parameters The parameters for the request.
+     * @returns The token result.
+     */
     unimpersonate({ request, parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'unimpersonate'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'unimpersonate'>>;
+    /**
+     * End a session.
+     * @param request The request context.
+     * @returns 'ok' if the session was ended.
+     */
     endSession({ request }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'endSession'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'endSession'>>;
+    /**
+     * Initialize a secret reset.
+     * @param parameters The parameters for the request.
+     * @returns 'ok' if the secret reset was initialized.
+     */
     initSecretReset({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'initSecretReset'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'initSecretReset'>>;
+    /**
+     * Reset a secret.
+     * @param parameters The parameters for the request.
+     * @returns 'ok' if the secret was reset.
+     */
     resetSecret({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'resetSecret'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'resetSecret'>>;
+    /**
+     * Check a secret.
+     * @param parameters The parameters for the request.
+     * @returns The result of the secret check.
+     */
     checkSecret({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'checkSecret'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'checkSecret'>>;
+    /**
+     * Get the current server timestamp.
+     * @returns The current server timestamp.
+     */
     timestamp(): ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'timestamp'>;
     protected getTokenResponse({ token, jsonToken, refreshToken, omitImpersonatorRefreshToken, impersonatorRefreshToken, impersonatorRefreshTokenExpiration }: TokenResult<AdditionalTokenPayload>): HttpServerResponse;
 }
+/**
+ * Get an authentication API controller.
+ * @param additionalTokenPayloadSchema Schema for additional token payload.
+ * @param authenticationDataSchema Schema for additional authentication data.
+ * @param additionalInitSecretResetData Schema for additional secret reset data.
+ * @returns An authentication API controller.
+ * @template AdditionalTokenPayload Type of additional token payload.
+ * @template AuthenticationData Type of additional authentication data.
+ * @template AdditionalInitSecretResetData Type of additional secret reset data.
+ */
 export declare function getAuthenticationApiController<AdditionalTokenPayload extends Record, AuthenticationData, AdditionalInitSecretResetData = void>(// eslint-disable-line @typescript-eslint/explicit-function-return-type
 additionalTokenPayloadSchema: ObjectSchemaOrType<AdditionalTokenPayload>, authenticationDataSchema: SchemaTestable<AuthenticationData>, additionalInitSecretResetData: SchemaTestable<AdditionalInitSecretResetData>): Type<AuthenticationApiController<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>>;