cordova-digital-onboarding 1.1.0 → 1.2.0

package/lib/index.d.ts

@@ -1,280 +1,3 @@
-/** For request that needs to identify the current process. */
-interface WDOProcessRequest {
-    processId: string;
-}
-/** Onboarding process response */
-interface WDOProcessResponse {
-    /** ID of the process */
-    processId: string;
-    /** Status of the process */
-    onboardingStatus: WDOOnboardingStatus;
-    /**
-     * Activation code used during the activation process.
-     * If not present, the activation is created later on in the onboarding process.
-     */
-    activationCode?: string;
-}
-/** Status of the onboarding */
-declare enum WDOOnboardingStatus {
-    /** Activation part of the process is in progress */
-    activationInProgress = "ACTIVATION_IN_PROGRESS",
-    /** Verification part of the process is in progress */
-    verificationInProgress = "VERIFICATION_IN_PROGRESS",
-    /** Onboarding process has failed */
-    failed = "FAILED",
-    /** Onboarding process is completed */
-    finished = "FINISHED"
-}
-interface WDOIdentityStatusResponse {
-    processId: string;
-    identityVerificationStatus: WDOIdentityVerificationStatus;
-    identityVerificationPhase?: WDOIdentityVerificationPhase;
-    config: WDOIdentityConfig;
-    consentRequired: boolean;
-}
-/** Configuration for identity verification */
-interface WDOIdentityConfig {
-    /** Period after which the OTP can be resent, in seconds */
-    otpResendPeriodSeconds: number;
-}
-/** Status of the current identity verification */
-declare enum WDOIdentityVerificationStatus {
-    /** Identity verification is waiting for initialization */
-    notInitialized = "NOT_INITIALIZED",
-    /** All submitted documents are waiting for verification */
-    verificationPending = "VERIFICATION_PENDING",
-    /** Identity verification is in progress */
-    inProgress = "IN_PROGRESS",
-    /** Identity verification was successfully completed */
-    accepted = "ACCEPTED",
-    /** Identity verification has failed, an error occurred */
-    failed = "FAILED",
-    /** Identity verification was rejected */
-    rejected = "REJECTED"
-}
-/** Phase of the current identity verification */
-declare enum WDOIdentityVerificationPhase {
-    /** Document upload is in progress */
-    documentUpload = "DOCUMENT_UPLOAD",
-    /** Presence check is in progress */
-    presenceCheck = "PRESENCE_CHECK",
-    /** Backend is verifying documents */
-    clientEvaluation = "CLIENT_EVALUATION",
-    /** Document verification is in progress */
-    documentVerification = "DOCUMENT_VERIFICATION",
-    /** Cross check on documents is in progress */
-    documentVerificationFinal = "DOCUMENT_VERIFICATION_FINAL",
-    /** OTP verification needed */
-    otp = "OTP_VERIFICATION",
-    /** Completed */
-    completed = "COMPLETED"
-}
-/** Types of available documents */
-declare enum WDODocumentSubmitFileType {
-    /** National ID card */
-    idCard = "ID_CARD",
-    /** Passport */
-    passport = "PASSPORT",
-    /** Driving license */
-    driversLicense = "DRIVING_LICENSE",
-    /** Selfie photo */
-    selfiePhoto = "SELFIE_PHOTO"
-}
-/** Side of the file */
-declare enum WDODocumentSubmitFileSide {
-    /** Front side of an document. Usually the one with the picture */
-    front = "FRONT",
-    /** Back side of an document */
-    back = "BACK"
-}
-/** Submitted document metadata */
-interface WDODocument {
-    /** Name of the file (with path within the submit ZIP file). */
-    filename: string;
-    /** Unique ID of the file */
-    id: string;
-    /** Type of the file */
-    type: WDODocumentSubmitFileType;
-    /** Side of the file */
-    side: WDODocumentSubmitFileSide;
-    /** Status of the processing */
-    status: WDODocumentStatus;
-    /** Possible errors */
-    errors?: string[];
-}
-/** Status of the document */
-declare enum WDODocumentStatus {
-    /** Document was accepted */
-    accepted = "ACCEPTED",
-    /** Document is being uploaded to the verification system by the backend */
-    uploadInProgress = "UPLOAD_IN_PROGRESS",
-    /** Document are being processed */
-    inProgress = "IN_PROGRESS",
-    /** Document is pending verification */
-    verificationPending = "VERIFICATION_PENDING",
-    /** Document is being verified */
-    verificationInProgress = "VERIFICATION_IN_PROGRESS",
-    /** Document was rejected */
-    rejected = "REJECTED",
-    /** Verification of the document failed */
-    failed = "FAILED"
-}
-/** Metadata for file inside ZIP (in `DocumentSubmitRequest.data`). */
-interface WDODocumentSubmitFile {
-    /** Name of the file (with path) */
-    filename: string;
-    /** Type of the document */
-    type: WDODocumentSubmitFileType;
-    /** Side of the document (for example front side of the ID card) */
-    side: WDODocumentSubmitFileSide;
-    /** Original document ID in case of re-upload */
-    originalDocumentId?: string;
-    /** Base64 encoded data image. */
-    data: Base64URLString;
-}
-/** Status of the documents */
-interface WDODocumentStatusResponse {
-    /** Overall status */
-    status: WDODocumentStatus;
-    /** Status for each document. */
-    documents: WDODocument[];
-}
-/** Response of the OTP verify */
-interface WDOVerifyOTPResponse {
-    /** ID of the process */
-    processId: string;
-    /** Current onboarding status */
-    onboardingStatus: WDOOnboardingStatus;
-    /** Was OTP verified? */
-    verified: boolean;
-    /** Is OTP expired */
-    expired: boolean;
-    /** How many attempts are remaining */
-    remainingAttempts: number;
-}
-/** Configuration for a document */
-interface WDOConfigurationDocument {
-    /** Type of the document */
-    type: string;
-    /** Is the document mandatory */
-    mandatory: boolean;
-    /** Number of sides the document has */
-    sideCount: number;
-}
-/** Configuration for the onboarding process */
-interface WDOConfigurationResponse {
-    /** Is the onboarding process enabled */
-    enabled: boolean;
-    /** Is OTP required for the first part - identification/activation. */
-    otpForIdentification: boolean;
-    /** Is OTP required for the second part - identity verification. */
-    otpForIdentityVerification: boolean;
-    /** Documents required for identity verification. */
-    documents: {
-        /** Number of required documents */
-        requiredDocumentsCount: number;
-        /** List of documents */
-        items: Array<WDOConfigurationDocument>;
-    };
-}
-
-/** Duck-typed PowerAuthActivationResult for WDO space */
-interface WDOPowerAuthActivationResult {
-    /** Decimalized fingerprint calculated from device's and server's public keys. */
-    activationFingerprint: string;
-    /** When available, contents of this object depends of your enrollment server configuration. */
-    customAttributes?: any;
-}
-/**
- * Service that can activate PowerAuth instance by user weak credentials (like his email, phone number or client ID) + optional SMS OTP.
- *
- * When the PowerAuth is activated with this service, `WDOVerificationService.isVerificationRequired` will be `true`
- * and you will need to verify the PowerAuth instance via `WDOVerificationService`.
- *
- * This service operates against Wultra Onboarding server (usually ending with `/enrollment-onboarding-server`) and you need to configure networking service with the right URL.
- */
-declare abstract class WDOBaseActivationService {
-    /**
-     * If the activation process is in progress.
-     *
-     * Note that even if this property is `true` it can be already discontinued on the server.
-     * Calling `status()` for example after the app is launched in this case is recommended.
-     */
-    hasActiveProcess(): Promise<boolean>;
-    /**
-     * Accept language for the outgoing requests headers.
-     * Default value is "en".
-     *
-     * Standard RFC "Accept-Language" https://tools.ietf.org/html/rfc7231#section-5.3.5
-     * Response texts are based on this setting. For example when "de" is set, server
-     * will return error texts and other in german (if available).
-     */
-    changeAcceptLanguage(language: string): void;
-    /**
-     * Retrieves status of the onboarding activation.
-     *
-     * @return Promise resolved with onboarding status.
-     */
-    status(): Promise<WDOOnboardingStatus>;
-    /**
-     * Start onboarding activation with user credentials.
-     *
-     * For example, when you require email and birth date, your object would look like this:
-     * ```
-     * {
-     *   email: "<user_email>",
-     *   birthdate: "<user_birth_date>"
-     * }
-     * ```
-     * @param credentials Object with credentials. Which credentials are needed should be provided by a system/backend provider.
-     * @param processType The process type identification. If not specified, the default process type will be used.
-     */
-    start(credentials: any, processType?: string): Promise<void>;
-    /**
-     * Cancel the activation process (issues a cancel request to the backend and clears the local process ID).
-     *
-     * @param forceCancel When true, the process will be canceled in the SDK even when fails on backend. `true` by default.
-     */
-    cancel(forceCancel?: boolean): Promise<void>;
-    /** Clear the stored data (without networking call). */
-    clear(): Promise<void>;
-    /**
-     * OTP resend request.
-     *
-     * This is intended to be displayed for the user to use in case of the OTP is not received.
-     * For example, when the user does not receive SMS after some time, there should be a button to "send again".
-     */
-    resendOTP(): Promise<void>;
-    /**
-     * Activate the PowerAuth instance that was passed in the initializer.
-     *
-     * @param activationName Name of the activation. Usually something like John's iPhone or similar.
-     * @param otp OTP code received by the user (via SMS or email). Optional when not required.
-     * @return Promise resolved with activation result.
-     */
-    activate(activationName: string, otp?: string): Promise<WDOPowerAuthActivationResult>;
-}
-
-/**
- * Service that can activate PowerAuth instance by user weak credentials (like his email, phone number or client ID) + optional SMS OTP.
- *
- * When the PowerAuth is activated with this service, `WDOVerificationService.isVerificationRequired` will be `true`
- * and you will need to verify the PowerAuth instance via `WDOVerificationService`.
- *
- * This service operates against Wultra Onboarding server (usually ending with `/enrollment-onboarding-server`) and you need to configure networking service with the right URL.
- */
-declare class WDOActivationService extends WDOBaseActivationService {
-    /** PowerAuth instance */
-    readonly powerauth: PowerAuth;
-    /**
-     * Creates service instance
-     *
-     * @param powerauth Configured PowerAuth instance. This instance needs to be without valid activation.
-     * @param baseUrl Base URL of the Wultra Digital Onboarding server. Usually ending with `/enrollment-onboarding-server`.
-     */
-    constructor(powerauth: PowerAuth, baseUrl: string);
-}
-
 /** String that contains a Base64 encoded JPEG image */
 type Base64EncodedJPEG = string;
 /** Image of a document that can be sent to the backend for Identity Verification. */
@@ -327,13 +50,6 @@ declare enum WDODocumentType {
     /** Drivers license */
     driversLicense = "driversLicense"
 }
-/**
- * Available sides of the document
- *
- * Front and back for ID card.
- * For passport and drivers license front only.
- */
-declare function WDODocumentTypeSides(type: WDODocumentType): WDODocumentSide[];
 /** Side of the document */
 declare enum WDODocumentSide {
     /** Front side of a document. Usually the one with the picture.
@@ -344,10 +60,6 @@ declare enum WDODocumentSide {
     /** Back side of a document */
     back = "back"
 }
-/** Converts WDODocumentType to WDODocumentSubmitFileType */
-declare function WDODocumentTypeToSubmitType(type: WDODocumentType): WDODocumentSubmitFileType;
-/** Converts WDODocumentSide to DocumentSubmitFileSide */
-declare function WDOCreateDocumentSubmitFileSide(side: WDODocumentSide): WDODocumentSubmitFileSide;
 
 /** Describes the state of documents that need to be uploaded to the server. */
 declare class WDOVerificationScanProcess {
@@ -394,14 +106,14 @@ declare class Side {
  * Usage:
  *
  * ```
- * const state = await verificationService.status();
+ * const state = await verificationService.status()
  * if (state.type === WDOVerificationStateType.scanDocument ) {
  *   // We are in the scan document state, access specific properties
- *   const process = state.process;
+ *   const process = state.process
  * }
  * ```
  */
-type WDOVerificationState = WDOIntroState | WDODocumentsToScanSelectState | WDOScanDocumentState | WDOProcessingState | WDOPresenceCheckState | WDOOtpState | WDOFailedState | WDOEndStateState | WDOSuccessState;
+type WDOVerificationState = WDOIntroState | WDODocumentsToScanSelectState | WDOScanDocumentState | WDOProcessingState | WDOPresenceCheckState | WDOOtpState | WDOFinishActivation | WDOFailedState | WDOEndStateState | WDOSuccessState;
 /**
  * Show the verification introduction screen where the user can start the activation.
  *
@@ -462,6 +174,14 @@ interface WDOOtpState {
     /** Number of remaining attempts to enter the correct OTP */
     remainingAttempts?: number;
 }
+/**
+ * Show "finish activation" with PIN prompt screen.
+ *
+ * The next step should be calling the `finishActivation` with user entered PIN.
+ */
+interface WDOFinishActivation {
+    type: WDOVerificationStateType.finishActivation;
+}
 /**
  * Verification failed and can be restarted
  *
@@ -529,6 +249,12 @@ declare enum WDOVerificationStateType {
      * The OTP is usually SMS or email.
      */
     otp = "otp",
+    /**
+     * Show "finish activation" with PIN prompt screen.
+     *
+     * The next step should be calling the `finishActivation` with user entered PIN.
+     */
+    finishActivation = "finishActivation",
     /**
      * Verification failed and can be restarted
      *
@@ -579,21 +305,40 @@ declare enum WDOStatusCheckReason {
     clientAccepted = "clientAccepted",
     verifyingPresence = "verifyingPresence"
 }
-
-/**
- * ######################################
- * This file contains duck-typed representation of PowerAuthActivationStatus
- * to avoid direct dependency on PowerAuth types in the shared library.
- * ######################################
- */
+/** Internal multiplatform PowerAuth representation */
+interface WDOPowerAuth {
+    fetchActivationStatus(): Promise<WDOPowerAuthActivationStatus>;
+    validatePassword(password: WDOPowerAuthPassword | string): Promise<void>;
+    createActivation(activation: WDOPowerAuthActivation): Promise<WDOPowerAuthCreateActivationResult>;
+    persistActivation(authentication: WDOPowerAuthAuthentication): Promise<void>;
+    canStartActivation(): Promise<boolean>;
+    removeActivationLocal(): Promise<void>;
+    get instanceId(): string;
+}
+/** Internal multiplatform PowerAuthPassword representation */
+interface WDOPowerAuthPassword {
+    clear(): Promise<void>;
+}
+/** Internal multiplatform WDOPowerAuthActivation representation */
+interface WDOPowerAuthActivation {
+}
+/** Internal multiplatform WDOPowerAuthAuthentication representation */
+interface WDOPowerAuthAuthentication {
+}
+/** Internal multiplatform WDOPowerAuthCreateActivationResult representation */
+interface WDOPowerAuthCreateActivationResult {
+    activationFingerprint: string;
+    customAttributes?: any;
+}
 /**
+ *
  * The `WDOPowerAuthActivationStatus` object represents complete status of the activation.
  */
 interface WDOPowerAuthActivationStatus {
     /**
      * State of the activation.
      */
-    state: WDOPowerAuthActivationState;
+    state: "CREATED" | "PENDING_COMMIT" | "ACTIVE" | "BLOCKED" | "REMOVED" | "DEADLOCK";
     /**
      * Number of failed authentication attempts in a row.
      */
@@ -611,38 +356,6 @@ interface WDOPowerAuthActivationStatus {
      */
     customObject?: any;
 }
-/**
- * The `WDOPowerAuthActivationState` enum defines all possible states of activation.
- * The state is a part of information received together with the rest
- * of the `WDOPowerAuthActivationStatus` object.
- */
-declare enum WDOPowerAuthActivationState {
-    /**
-     * The activation is just created.
-     */
-    CREATED = "CREATED",
-    /**
-     * The activation is not completed yet on the server.
-     */
-    PENDING_COMMIT = "PENDING_COMMIT",
-    /**
-     * The shared secure context is valid and active.
-     */
-    ACTIVE = "ACTIVE",
-    /**
-     * The activation is blocked.
-     */
-    BLOCKED = "BLOCKED",
-    /**
-     * The activation doesn't exist anymore.
-     */
-    REMOVED = "REMOVED",
-    /**
-     * The activation is technically blocked. You cannot use it anymore
-     * for the signature calculations.
-     */
-    DEADLOCK = "DEADLOCK"
-}
 
 /**
  * Listener of the Verification Service that can listen on Verification Status and PowerAuth Status changes.
@@ -654,9 +367,9 @@ interface WDOVerificationServiceListener {
      *  Note that this happens only when error is returned in some of the Verification endpoints and this error indicates PowerAuth status change. For
      * example when the service finds out during the API call that the PowerAuth activation was removed or blocked on the server
      */
-    powerAuthActivationStatusChanged(sender: WDOBaseVerificationService, status: WDOPowerAuthActivationStatus): void;
+    powerAuthActivationStatusChanged(senderService: any, status: WDOPowerAuthActivationStatus): void;
     /** Called when state of the verification has changed. */
-    verificationStatusChanged(sender: WDOBaseVerificationService, status: WDOVerificationState): void;
+    verificationStatusChanged(senderService: any, status: WDOVerificationState): void;
 }
 /** Possible results of the user consent. */
 declare enum WDOConsentResponse {
@@ -675,7 +388,19 @@ declare enum WDOConsentResponse {
  *
  * This service operates against Wultra Onboarding server (usually ending with `/enrollment-onboarding-server`) and you need to configure networking service with the right URL.
  */
-declare abstract class WDOBaseVerificationService {
+declare abstract class WDOBaseVerificationService<TPowerAuth extends WDOPowerAuth, TPowerAuthPassword extends WDOPowerAuthPassword> {
+    /** Checks if verification is required based on PowerAuth activation status */
+    protected static isVerificationRequiredInternal(paStatus: WDOPowerAuthActivationStatus): boolean;
+    /** PowerAuth instance */
+    readonly powerauth: TPowerAuth;
+    private readonly api;
+    /**
+     * Creates service instance
+     *
+     * @param powerauth Configured PowerAuth instance. This instance needs to be without valid activation.
+     * @param baseUrl Base URL of the Wultra Digital Onboarding server. Usually ending with `/enrollment-onboarding-server`.
+     */
+    constructor(powerauth: TPowerAuth, baseUrl: string);
     /**
      * Accept language for the outgoing requests headers.
      * Default value is "en".
@@ -761,56 +486,31 @@ declare abstract class WDOBaseVerificationService {
      */
     verifyOTP(otp: string): Promise<WDOVerificationState>;
     /**
-     * Request OTP resend.
+     * Finishes verification by creating a new PowerAuth activation on given `newPowerAuthInstance`.
      *
-     * Since SMS or emails can fail to deliver, use this to send the OTP again.
-     */
-    resendOTP(): Promise<void>;
-}
-
-/**
- * Service that can verify previously activated PowerAuth instance.
- *
- * When PowerAuth instance was activated with weak credentials via `WDOActivationService`, user needs to verify his genuine presence.
- *
- * This service operates against Wultra Onboarding server (usually ending with `/enrollment-onboarding-server`) and you need to configure networking service with the right URL.
- */
-declare class WDOVerificationService extends WDOBaseVerificationService {
-    /** PowerAuth instance */
-    readonly powerauth: PowerAuth;
-    /** Checks if verification is required based on PowerAuth activation status */
-    static isVerificationRequired(paStatus: PowerAuthActivationStatus): boolean;
-    /**
-     * Creates service instance
+     * Needs to be called when "activationFinish" next step is returned from the `status()` call.
      *
-     * @param powerauth Configured PowerAuth instance. This instance needs to be without valid activation.
-     * @param baseUrl Base URL of the Wultra Digital Onboarding server. Usually ending with `/enrollment-onboarding-server`.
-     */
-    constructor(powerauth: PowerAuth, baseUrl: string);
-}
-
-/** Service that provides configuration for the Wultra Digital Onboarding SDK. */
-declare abstract class WDOBaseConfigurationService {
-    /**
-     * Fetches configuration for the given process type from the server.
+     * The method verifies that the provided `password` is the same as used in the original activation
+     * (if `validatePassword` is set to `true`), then it calls the server API to finish
+     * the verification and obtain the activation code for the new activation. Finally, it creates
+     * a new activation on `newPowerAuthInstance` using the obtained activation code and persists it
+     * with the provided `newPassword`.
      *
-     * @param processType Type of the process for which to fetch configuration.
-     * @returns Configuration response from the server.
+     * After successful completion, the original PowerAuth instance becomes invalid (`REMOVED` state) and cannot be used anymore.
+     *
+     * @param newPowerAuthInstance PowerAuth instance where to create new activation. This instance must not have an existing activation.
+     * @param newActivationName Name of the new activation to be created on `newPowerAuthInstance`.
+     * @param newPassword Password to protect the new activation. In case `validatePassword` is `true`, this password must match the password of the original activation and must be reusable (not destroyed on use).
+     * @param validatePassword If set to `true`, the method verifies that the provided `newPassword` matches the password of the original activation.
+     * @param userIdentification Optional user identification object to be sent to the server during the finish activation process.
      */
-    getConfiguration(processType: string): Promise<WDOConfigurationResponse>;
-}
-
-/** Service that provides configuration for the Wultra Digital Onboarding SDK. */
-declare class WDOConfigurationService extends WDOBaseConfigurationService {
-    /** PowerAuth instance */
-    readonly powerauth: PowerAuth;
+    finishActivation(newPowerAuthInstance: TPowerAuth, newActivationName: string, newPassword: TPowerAuthPassword, validatePassword: boolean, userIdentification?: any): Promise<WDOVerificationState>;
     /**
-     * Creates service instance
+     * Request OTP resend.
      *
-     * @param powerauth Configured PowerAuth instance.
-     * @param baseUrl Base URL of the Wultra Digital Onboarding server. Usually ending with `/enrollment-onboarding-server`.
+     * Since SMS or emails can fail to deliver, use this to send the OTP again.
      */
-    constructor(powerauth: PowerAuth, baseUrl: string);
+    resendOTP(): Promise<void>;
 }
 
 /** Log levels for Wultra Digital Onboarding. */
@@ -833,6 +533,48 @@ interface WDOLoggerListener {
     log(level: WDOLogLevel, message: string): void;
 }
 
+/** Status of the onboarding */
+declare enum WDOOnboardingStatus {
+    /** Activation part of the process is in progress */
+    activationInProgress = "ACTIVATION_IN_PROGRESS",
+    /** Verification part of the process is in progress */
+    verificationInProgress = "VERIFICATION_IN_PROGRESS",
+    /** Onboarding process has failed */
+    failed = "FAILED",
+    /** Onboarding process is completed */
+    finished = "FINISHED"
+}
+/** Configuration for a document */
+interface WDOConfigurationDocument {
+    /** Type of the document */
+    type: string;
+    /** Number of sides the document has */
+    sideCount: number;
+}
+/** Group of documents in the configuration */
+interface WDOConfigurationDocumentGroup {
+    /** Number of required documents in the group */
+    requiredDocumentsCount: number;
+    /** Documents in the group */
+    items: Array<WDOConfigurationDocument>;
+}
+/** Configuration for the onboarding process */
+interface WDOConfigurationResponse {
+    /** Is the onboarding process enabled */
+    enabled: boolean;
+    /** Is OTP required for the first part - identification/activation. */
+    otpForIdentification: boolean;
+    /** Is OTP required for the second part - identity verification. */
+    otpForIdentityVerification: boolean;
+    /** Documents required for identity verification. */
+    documents: {
+        /** Number of total required documents */
+        totalRequiredDocumentsCount: number;
+        /** Groups of documents */
+        groups: Array<WDOConfigurationDocumentGroup>;
+    };
+}
+
 /** Represent error thrown from a WDO library */
 declare class WDOError {
     /** Reason for the error */
@@ -868,10 +610,139 @@ declare enum WDOErrorReason {
     processNotInProgress = "PROCESS_NOT_IN_PROGRESS",
     /** The PowerAuth instance is already activated when trying to activate it again */
     powerauthAlreadyActivated = "POWERAUTH_ALREADY_ACTIVATED",
+    /** The PowerAuth instance is not configured properly */
+    powerAuthNotConfigured = "POWERAUTH_NOT_CONFIGURED",
     /** The PowerAuth instance is not activated when trying to use it */
     powerauthNotActivated = "POWERAUTH_NOT_ACTIVATED",
     /** OTP verification failed */
-    otpFailed = "OTP_FAILED"
+    otpFailed = "OTP_FAILED",
+    /** Invalid parameter */
+    invalidParameter = "INVALID_PARAMETER"
+}
+
+/**
+ * Service that can activate PowerAuth instance by user weak credentials (like his email, phone number or client ID) + optional SMS OTP.
+ *
+ * When the PowerAuth is activated with this service, `WDOVerificationService.isVerificationRequired` will be `true`
+ * and you will need to verify the PowerAuth instance via `WDOVerificationService`.
+ *
+ * This service operates against Wultra Onboarding server (usually ending with `/enrollment-onboarding-server`) and you need to configure networking service with the right URL.
+ */
+declare abstract class WDOBaseActivationService<TPowerAuth extends WDOPowerAuth> {
+    /** PowerAuth instance */
+    readonly powerauth: TPowerAuth;
+    /**
+     * Creates service instance
+     *
+     * @param powerauth Configured PowerAuth instance. This instance needs to be without valid activation.
+     * @param baseUrl Base URL of the Wultra Digital Onboarding server. Usually ending with `/enrollment-onboarding-server`.
+     */
+    constructor(powerauth: TPowerAuth, baseUrl: string);
+    /**
+     * If the activation process is in progress.
+     *
+     * Note that even if this property is `true` it can be already discontinued on the server.
+     * Calling `status()` after the app is launched is recommended.
+     */
+    hasActiveProcess(): Promise<boolean>;
+    /**
+     * Accept language for the outgoing requests headers.
+     * Default value is "en".
+     *
+     * Standard RFC "Accept-Language" https://tools.ietf.org/html/rfc7231#section-5.3.5
+     * Response texts are based on this setting. For example when "de" is set, server
+     * will return error texts and other in german (if available).
+     */
+    changeAcceptLanguage(language: string): void;
+    /**
+     * Retrieves status of the onboarding activation.
+     *
+     * @return Promise resolved with onboarding status.
+     */
+    status(): Promise<WDOOnboardingStatus>;
+    /**
+     * Start onboarding activation with user credentials.
+     *
+     * For example, when you require email and birth date, your object would look like this:
+     * ```
+     * {
+     *   email: "<user_email>",
+     *   birthdate: "<user_birth_date>"
+     * }
+     * ```
+     * @param credentials Object with credentials. Which credentials are needed should be provided by a system/backend provider.
+     * @param processType The process type identification. If not specified, the default process type will be used.
+     */
+    start(credentials: any, processType?: string): Promise<void>;
+    /**
+     * Cancel the activation process (issues a cancel request to the backend and clears the local process ID).
+     *
+     * @param forceCancel When true, the process will be canceled in the SDK even when fails on backend. `true` by default.
+     */
+    cancel(forceCancel?: boolean): Promise<void>;
+    /** Clear the stored data (without networking call). */
+    clear(): Promise<void>;
+    /**
+     * OTP resend request.
+     *
+     * This is intended to be displayed for the user to use in case of the OTP is not received.
+     * For example, when the user does not receive SMS after some time, there should be a button to "send again".
+     * There is a server-side rate limit applied to this operation to prevent abuse; it is good practice to disable the button temporarily while the OTP is being sent.
+     */
+    resendOTP(): Promise<void>;
+    /**
+     * Activate the PowerAuth instance that was passed in the initializer.
+     *
+     * @param activationName Name of the activation. Usually something like John's iPhone or similar.
+     * @param otp OTP code received by the user (via SMS or email). Optional when not required.
+     * @return Promise resolved with activation result.
+     */
+    activate(activationName: string, otp?: string): Promise<WDOPowerAuthCreateActivationResult>;
+}
+
+/** Service that provides configuration for the Wultra Digital Onboarding SDK. */
+declare abstract class WDOBaseConfigurationService<TPowerAuth extends WDOPowerAuth> {
+    /** PowerAuth instance */
+    readonly powerauth: TPowerAuth;
+    /**
+     * Creates service instance
+     *
+     * @param powerauth Configured PowerAuth instance.
+     * @param baseUrl Base URL of the Wultra Digital Onboarding server. Usually ending with `/enrollment-onboarding-server`.
+     */
+    constructor(powerauth: TPowerAuth, baseUrl: string);
+    /**
+     * Fetches configuration for the given process type from the server.
+     *
+     * @param processType Type of the process for which to fetch configuration.
+     * @returns Configuration response from the server.
+     */
+    getConfiguration(processType: string): Promise<WDOConfigurationResponse>;
+}
+
+/**
+ * Service that can activate PowerAuth instance by user weak credentials (like his email, phone number or client ID) + optional SMS OTP.
+ *
+ * When the PowerAuth is activated with this service, `WDOVerificationService.isVerificationRequired` will be `true`
+ * and you will need to verify the PowerAuth instance via `WDOVerificationService`.
+ *
+ * This service operates against Wultra Onboarding server (usually ending with `/enrollment-onboarding-server`) and you need to configure networking service with the right URL.
+ */
+declare class WDOActivationService extends WDOBaseActivationService<PowerAuth> {
+}
+/**
+ * Service that can verify previously activated PowerAuth instance.
+ *
+ * When PowerAuth instance was activated with weak credentials via `WDOActivationService`, user needs to verify his genuine presence.
+ *
+ * This service operates against Wultra Onboarding server (usually ending with `/enrollment-onboarding-server`) and you need to configure networking service with the right URL.
+ */
+declare class WDOVerificationService extends WDOBaseVerificationService<PowerAuth, PowerAuthPassword> {
+    /** Checks if verification is required based on PowerAuth activation status */
+    static isVerificationRequired(paStatus: PowerAuthActivationStatus): boolean;
+}
+/** Service that provides configuration for the Wultra Digital Onboarding SDK. */
+declare class WDOConfigurationService extends WDOBaseConfigurationService<PowerAuth> {
 }
-export { Side, UploadState, WDOActivationService, WDOConfigurationService, WDOConsentResponse, WDOCreateDocumentSubmitFileSide, WDODocumentFile, WDODocumentSide, WDODocumentStatus, WDODocumentSubmitFileSide, WDODocumentSubmitFileType, WDODocumentType, WDODocumentTypeSides, WDODocumentTypeToSubmitType, WDOEndStateReason, WDOError, WDOErrorReason, WDOIdentityVerificationPhase, WDOIdentityVerificationStatus, WDOLogLevel, WDOLogger, WDOOnboardingStatus, WDOScannedDocument, WDOStatusCheckReason, WDOVerificationScanProcess, WDOVerificationService, WDOVerificationStateType };
-export type { Base64EncodedJPEG, WDOConfigurationDocument, WDOConfigurationResponse, WDODocument, WDODocumentStatusResponse, WDODocumentSubmitFile, WDODocumentsToScanSelectState, WDOEndStateState, WDOFailedState, WDOIdentityConfig, WDOIdentityStatusResponse, WDOIntroState, WDOLoggerListener, WDOOtpState, WDOPresenceCheckState, WDOProcessRequest, WDOProcessResponse, WDOProcessingState, WDOScanDocumentState, WDOSuccessState, WDOVerificationServiceListener, WDOVerificationState, WDOVerifyOTPResponse };
+export { Side, UploadState, WDOActivationService, WDOConfigurationService, WDOConsentResponse, WDODocumentFile, WDODocumentSide, WDODocumentType, WDOEndStateReason, WDOError, WDOErrorReason, WDOLogLevel, WDOLogger, WDOOnboardingStatus, WDOScannedDocument, WDOStatusCheckReason, WDOVerificationScanProcess, WDOVerificationService, WDOVerificationStateType };
+export type { Base64EncodedJPEG, WDOConfigurationDocument, WDOConfigurationDocumentGroup, WDOConfigurationResponse, WDODocumentsToScanSelectState, WDOEndStateState, WDOFailedState, WDOFinishActivation, WDOIntroState, WDOLoggerListener, WDOOtpState, WDOPresenceCheckState, WDOProcessingState, WDOScanDocumentState, WDOSuccessState, WDOVerificationServiceListener, WDOVerificationState };