/*
 * Copyright (c) Microsoft Corporation. All rights reserved.
 * Licensed under the MIT License.
 */

import {
    MfaAwaitingStateParameters,
    MfaStateParameters,
    MfaVerificationRequiredStateParameters,
} from "./MfaStateParameters.js";
import { MfaSubmitChallengeResult } from "../result/MfaSubmitChallengeResult.js";
import { MfaRequestChallengeResult } from "../result/MfaRequestChallengeResult.js";
import {
    MfaSubmitChallengeParams,
    MfaRequestChallengeParams,
} from "../../../interaction_client/mfa/parameter/MfaClientParameters.js";
import { CustomAuthAccountData } from "../../../../get_account/auth_flow/CustomAuthAccountData.js";
import { MfaCompletedState } from "./MfaCompletedState.js";
import { ensureArgumentIsNotEmptyString } from "../../../utils/ArgumentValidator.js";
import { AuthenticationMethod } from "../../../network_client/custom_auth_api/types/ApiResponseTypes.js";
import { AuthFlowActionRequiredStateBase } from "../../AuthFlowState.js";
import {
    MFA_AWAITING_STATE_TYPE,
    MFA_VERIFICATION_REQUIRED_STATE_TYPE,
} from "../../AuthFlowStateTypes.js";

abstract class MfaState<
    TParameters extends MfaStateParameters
> extends AuthFlowActionRequiredStateBase<TParameters> {
    /**
     * Requests an MFA challenge for a specific authentication method.
     * @param authMethodId The authentication method ID to use for the challenge.
     * @returns Promise that resolves to MfaRequestChallengeResult.
     * @warning This API is experimental. It may be changed in the future without notice. Do not use in production applications.
     */
    async requestChallenge(
        authMethodId: string
    ): Promise<MfaRequestChallengeResult> {
        try {
            ensureArgumentIsNotEmptyString("authMethodId", authMethodId);

            this.stateParameters.logger.verbose(
                `Requesting MFA challenge with authentication method - '${authMethodId}'.`,
                this.stateParameters.correlationId
            );

            const requestParams: MfaRequestChallengeParams = {
                correlationId: this.stateParameters.correlationId,
                continuationToken: this.stateParameters.continuationToken ?? "",
                challengeType:
                    this.stateParameters.config.customAuth.challengeTypes ?? [],
                authMethodId: authMethodId,
            };

            const result =
                await this.stateParameters.mfaClient.requestChallenge(
                    requestParams
                );

            this.stateParameters.logger.verbose(
                "MFA challenge requested successfully.",
                this.stateParameters.correlationId
            );

            return new MfaRequestChallengeResult(
                new MfaVerificationRequiredState({
                    correlationId: result.correlationId,
                    continuationToken: result.continuationToken,
                    config: this.stateParameters.config,
                    logger: this.stateParameters.logger,
                    mfaClient: this.stateParameters.mfaClient,
                    cacheClient: this.stateParameters.cacheClient,
                    challengeChannel: result.challengeChannel,
                    challengeTargetLabel: result.challengeTargetLabel,
                    codeLength: result.codeLength,
                    selectedAuthMethodId: authMethodId,
                    scopes: this.stateParameters.scopes ?? [],
                })
            );
        } catch (error) {
            this.stateParameters.logger.errorPii(
                `Failed to request MFA challenge. Error: '${error}'.`,
                this.stateParameters.correlationId
            );

            return MfaRequestChallengeResult.createWithError(error);
        }
    }
}

/**
 * State indicating that MFA is required and awaiting user action.
 * This state allows the developer to pause execution before sending the code to the user's email.
 */
export class MfaAwaitingState extends MfaState<MfaAwaitingStateParameters> {
    /**
     * The type of the state.
     */
    stateType = MFA_AWAITING_STATE_TYPE;

    /**
     * Gets the available authentication methods for MFA.
     * @returns Array of available authentication methods.
     * @warning This API is experimental. It may be changed in the future without notice. Do not use in production applications.
     */
    getAuthMethods(): AuthenticationMethod[] {
        return this.stateParameters.authMethods;
    }
}

/**
 * State indicating that MFA verification is required.
 * The challenge has been sent and the user needs to provide the code.
 */
export class MfaVerificationRequiredState extends MfaState<MfaVerificationRequiredStateParameters> {
    /**
     * The type of the state.
     */
    stateType = MFA_VERIFICATION_REQUIRED_STATE_TYPE;

    /**
     * Gets the length of the code that the user needs to provide.
     * @returns The expected code length.
     * @warning This API is experimental. It may be changed in the future without notice. Do not use in production applications.
     */
    getCodeLength(): number {
        return this.stateParameters.codeLength;
    }

    /**
     * Gets the channel through which the challenge was sent.
     * @returns The challenge channel (e.g., "email").
     * @warning This API is experimental. It may be changed in the future without notice. Do not use in production applications.
     */
    getChannel(): string {
        return this.stateParameters.challengeChannel;
    }

    /**
     * Gets the target label indicating where the challenge was sent.
     * @returns The challenge target label (e.g., masked email address).
     * @warning This API is experimental. It may be changed in the future without notice. Do not use in production applications.
     */
    getSentTo(): string {
        return this.stateParameters.challengeTargetLabel;
    }

    /**
     * Submits the MFA challenge (e.g., OTP code) to complete the authentication.
     * @param challenge The challenge code (e.g., OTP code) entered by the user.
     * @returns Promise that resolves to MfaSubmitChallengeResult.
     * @warning This API is experimental. It may be changed in the future without notice. Do not use in production applications.
     */
    async submitChallenge(
        challenge: string
    ): Promise<MfaSubmitChallengeResult> {
        try {
            this.ensureCodeIsValid(challenge, this.getCodeLength());

            this.stateParameters.logger.verbose(
                "Submitting MFA challenge.",
                this.stateParameters.correlationId
            );

            const submitParams: MfaSubmitChallengeParams = {
                correlationId: this.stateParameters.correlationId,
                continuationToken: this.stateParameters.continuationToken ?? "",
                scopes: this.stateParameters.scopes ?? [],
                challenge: challenge,
            };

            const result = await this.stateParameters.mfaClient.submitChallenge(
                submitParams
            );

            this.stateParameters.logger.verbose(
                "MFA challenge submitted successfully.",
                this.stateParameters.correlationId
            );

            const accountInfo = new CustomAuthAccountData(
                result.authenticationResult.account,
                this.stateParameters.config,
                this.stateParameters.cacheClient,
                this.stateParameters.logger,
                this.stateParameters.correlationId
            );

            return new MfaSubmitChallengeResult(
                new MfaCompletedState(),
                accountInfo
            );
        } catch (error) {
            this.stateParameters.logger.errorPii(
                `Failed to submit MFA challenge. Error: '${error}'.`,
                this.stateParameters.correlationId
            );

            return MfaSubmitChallengeResult.createWithError(error);
        }
    }
}
