oneentry 1.0.136 → 1.0.138

package/dist/auth-provider/authProviderApi.d.ts

@@ -1,7 +1,7 @@
 import AsyncModules from '../base/asyncModules';
 import type StateModule from '../base/stateModule';
 import type { IError } from '../base/utils';
-import type { IActiveSession, IAuthEntity, IAuthPostBody, IAuthProvider, IAuthProvidersEntity, IOAuthSignUpData, ISignUpData, ISignUpEntity } from './authProvidersInterfaces';
+import type { IActiveSession, IAuthEntity, IAuthPostBody, IAuthProvider, IAuthProvidersEntity, IOauthData, ISignUpData, ISignUpEntity } from './authProvidersInterfaces';
 /**
  * Controllers for working with auth services.
  * @handle /api/content/users-auth-providers
@@ -27,19 +27,19 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
           "formIdentifier": "reg",
           "authData": [
             {
-            "marker": "login",
-            "value": "example@oneentry.cloud"
+              "marker": "login",
+              "value": "example@oneentry.cloud"
             },
             {
-            "marker": "password",
-            "value": "12345"
+              "marker": "password",
+              "value": "12345"
             }
           ],
           "formData": [
             {
-            "marker": "last_name",
-            "type": "string",
-            "value": "Name"
+              "marker": "last_name",
+              "type": "string",
+              "value": "Name"
             }
           ],
           "notificationData": {
@@ -75,9 +75,12 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
           "phonePush": ["+99999999999"],
           "phoneSMS": "+99999999999"
         }
+     * @param {string} body.notificationData.email - The email address to which the notification will be sent.
+     * @param {Array<string>} [body.notificationData.phonePush] - An array of phone numbers for push notifications. Optional.
+     * @param {string} [body.notificationData.phoneSMS] - The phone number for SMS notifications. Optional.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ISignUpEntity} Returns a user object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (❗️For a provider with user activation, the activation code is sent through the corresponding user notification method).
      */
     signUp(marker: string, body: ISignUpData, langCode?: string): Promise<ISignUpEntity | IError>;
@@ -87,8 +90,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} userIdentifier - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} eventIdentifier - Text identifier of the event object for which the code is generated. Example: "user_registration".
-     * @returns {void} Returns void if the code is successfully generated, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<void | IError>} Returns void if the code is successfully generated, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Obtaining a code to activate the user.
      */
     generateCode(marker: string, userIdentifier: string, eventIdentifier: string): Promise<void | IError>;
@@ -99,8 +102,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @param {string} userIdentifier  - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} eventIdentifier - Text identifier of the event object for which the code is generated. Example: "user_registration".
      * @param {string} code - Service code. Example: "123456".
-     * @returns {boolean} Returns true if the code is correct, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the code is correct, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Checking the user activation code
      */
     checkCode(marker: string, userIdentifier: string, eventIdentifier: string, code: string): Promise<boolean | IError>;
@@ -110,8 +113,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} userIdentifier - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} code - Service code. Example: "123456".
-     * @returns {boolean} Returns true if the user was successfully activated, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the user was successfully activated, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User activation.
      */
     activateUser(marker: string, userIdentifier: string, code: string): Promise<boolean | IError>;
@@ -124,12 +127,12 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
         {
           "authData": [
             {
-            "marker": "login",
-            "value": "example@oneentry.cloud"
+              "marker": "login",
+              "value": "example@oneentry.cloud"
             },
             {
-            "marker": "password",
-            "value": "12345"
+              "marker": "password",
+              "value": "12345"
             }
           ]
         }
@@ -143,8 +146,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
         ]
      * @param {string} body.authData[index].marker - The marker for the authentication data. Example: "login".
      * @param {string} body.authData[index].value  - The value for the authentication data. Example: "user@example.com".
-     * @returns {IAuthEntity} Returns an auth entity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User authorization.
      */
     auth(marker: string, body: IAuthPostBody): Promise<IAuthEntity | IError>;
@@ -153,8 +156,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @handleName refresh
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} token - Refresh token. Example: "abcdef123456".
-     * @returns {IAuthEntity} Returns an auth entity object with the following values: accessToken, refreshToken, user, and other auth-related data.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object with the following values: accessToken, refreshToken, user, and other auth-related data.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User token refresh.
      */
     refresh(marker: string, token: string): Promise<IAuthEntity | IError>;
@@ -163,8 +166,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @handleName logout
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} token - Refresh token. Example: "abcdef123456".
-     * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the logout was successful, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -173,8 +176,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * Logout of user account on all devices.
      * @handleName logoutAll
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the logout was successful, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -189,8 +192,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @param {string} code - Service code. Example: "123456".
      * @param {string} newPassword - New password. Example: "newPassword123".
      * @param {string} [repeatPassword] - Optional variable contains repeat new password for validation. Example: "newPassword123".
-     * @returns {boolean} Returns true if the password was successfully changed, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the password was successfully changed, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User password change (only for tariffs with account activation and the Activation feature enabled).
      */
     changePassword(marker: string, userIdentifier: string, eventIdentifier: string, type: number, code: string, newPassword: string, repeatPassword?: string): Promise<boolean | IError>;
@@ -200,8 +203,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IAuthProvidersEntity[]} Returns an array of auth provider objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthProvidersEntity[] | IError>} Returns an array of auth provider objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting all objects of authorization providers.
      */
     getAuthProviders(langCode?: string, offset?: number, limit?: number): Promise<IAuthProvidersEntity[] | IError>;
@@ -210,8 +213,8 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @handleName getAuthProviderByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IAuthProvidersEntity} Returns an auth provider object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthProvidersEntity | IError>} Returns an auth provider object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
      */
     getAuthProviderByMarker(marker: string, langCode?: string): Promise<IAuthProvidersEntity | IError>;
@@ -219,16 +222,16 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * Getting active user sessions data.
      * @handleName getActiveSessionsByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {IActiveSession[]} Returns an auth provider object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
      */
     getActiveSessionsByMarker(marker: string): Promise<IActiveSession[] | IError>;
     /**
      * User registration (authorization) via OAUTH.
-     * @handleName oauthSignUp
+     * @handleName oauth
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @param {IOAuthSignUpData} body - Object contains OAuth information for registration.
+     * @param {IOauthData} body - Object contains OAuth information for registration.
      * @example
         {
           "client_id": "34346983-luuct343473qdkqidjopdfp3eb3k4thp.apps.googleusercontent.com",
@@ -238,9 +241,9 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
           "redirect_uri": "http://localhost:3000"
         }
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ISignUpEntity} Returns a user object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (authorization) via OAUTH.
      */
-    oauthSignUp(marker: string, body: IOAuthSignUpData, langCode?: string): Promise<IAuthEntity | IError>;
+    oauth(marker: string, body: IOauthData, langCode?: string): Promise<IAuthEntity | IError>;
 }

package/dist/auth-provider/authProviderApi.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 /* eslint-disable jsdoc/no-undefined-types */
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+const authProviderSchemas_1 = require("./authProviderSchemas");
 /**
  * Controllers for working with auth services.
  * @handle /api/content/users-auth-providers
@@ -31,19 +32,19 @@ class AuthProviderApi extends asyncModules_1.default {
           "formIdentifier": "reg",
           "authData": [
             {
-            "marker": "login",
-            "value": "example@oneentry.cloud"
+              "marker": "login",
+              "value": "example@oneentry.cloud"
             },
             {
-            "marker": "password",
-            "value": "12345"
+              "marker": "password",
+              "value": "12345"
             }
           ],
           "formData": [
             {
-            "marker": "last_name",
-            "type": "string",
-            "value": "Name"
+              "marker": "last_name",
+              "type": "string",
+              "value": "Name"
             }
           ],
           "notificationData": {
@@ -79,15 +80,20 @@ class AuthProviderApi extends asyncModules_1.default {
           "phonePush": ["+99999999999"],
           "phoneSMS": "+99999999999"
         }
+     * @param {string} body.notificationData.email - The email address to which the notification will be sent.
+     * @param {Array<string>} [body.notificationData.phonePush] - An array of phone numbers for push notifications. Optional.
+     * @param {string} [body.notificationData.phoneSMS] - The phone number for SMS notifications. Optional.
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ISignUpEntity} Returns a user object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (❗️For a provider with user activation, the activation code is sent through the corresponding user notification method).
      */
     async signUp(marker, body, langCode = this.state.lang) {
         body['langCode'] = langCode;
         const result = await this._fetchPost(`/marker/${marker}/users/sign-up`, this._normalizePostBody(body, langCode));
-        return this._normalizeData(result);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, authProviderSchemas_1.SignUpResponseSchema);
+        return this._normalizeData(validated);
     }
     /**
      * Getting a user activation code. The code is returned via the appropriate user notification method.
@@ -95,8 +101,8 @@ class AuthProviderApi extends asyncModules_1.default {
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} userIdentifier - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} eventIdentifier - Text identifier of the event object for which the code is generated. Example: "user_registration".
-     * @returns {void} Returns void if the code is successfully generated, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<void | IError>} Returns void if the code is successfully generated, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Obtaining a code to activate the user.
      */
     async generateCode(marker, userIdentifier, eventIdentifier) {
@@ -114,8 +120,8 @@ class AuthProviderApi extends asyncModules_1.default {
      * @param {string} userIdentifier  - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} eventIdentifier - Text identifier of the event object for which the code is generated. Example: "user_registration".
      * @param {string} code - Service code. Example: "123456".
-     * @returns {boolean} Returns true if the code is correct, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the code is correct, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Checking the user activation code
      */
     async checkCode(marker, userIdentifier, eventIdentifier, code) {
@@ -133,8 +139,8 @@ class AuthProviderApi extends asyncModules_1.default {
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} userIdentifier - The text identifier of the user's object (user login). Example: "example@oneentry.cloud".
      * @param {string} code - Service code. Example: "123456".
-     * @returns {boolean} Returns true if the user was successfully activated, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the user was successfully activated, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User activation.
      */
     async activateUser(marker, userIdentifier, code) {
@@ -154,12 +160,12 @@ class AuthProviderApi extends asyncModules_1.default {
         {
           "authData": [
             {
-            "marker": "login",
-            "value": "example@oneentry.cloud"
+              "marker": "login",
+              "value": "example@oneentry.cloud"
             },
             {
-            "marker": "password",
-            "value": "12345"
+              "marker": "password",
+              "value": "12345"
             }
           ]
         }
@@ -173,27 +179,29 @@ class AuthProviderApi extends asyncModules_1.default {
         ]
      * @param {string} body.authData[index].marker - The marker for the authentication data. Example: "login".
      * @param {string} body.authData[index].value  - The value for the authentication data. Example: "user@example.com".
-     * @returns {IAuthEntity} Returns an auth entity object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User authorization.
      */
     async auth(marker, body) {
         const result = await this._fetchPost(`/marker/${marker}/users/auth`, body);
-        this.state.accessToken = result.accessToken;
-        this.state.refreshToken = result.refreshToken;
-        // console.log(result);
-        if (this.state.saveFunction) {
-            this.state.saveFunction(result.refreshToken);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, authProviderSchemas_1.AuthResponseSchema);
+        this.state.accessToken = validated.accessToken;
+        this.state.refreshToken = validated.refreshToken;
+        // console.log(validated);
+        if (this.state.saveFunction && validated.refreshToken) {
+            this.state.saveFunction(validated.refreshToken);
         }
-        return result;
+        return validated;
     }
     /**
      * Refresh token.
      * @handleName refresh
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} token - Refresh token. Example: "abcdef123456".
-     * @returns {IAuthEntity} Returns an auth entity object with the following values: accessToken, refreshToken, user, and other auth-related data.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthEntity | IError>} Returns an auth entity object with the following values: accessToken, refreshToken, user, and other auth-related data.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User token refresh.
      */
     async refresh(marker, token) {
@@ -211,8 +219,8 @@ class AuthProviderApi extends asyncModules_1.default {
      * @handleName logout
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} token - Refresh token. Example: "abcdef123456".
-     * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the logout was successful, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -234,8 +242,8 @@ class AuthProviderApi extends asyncModules_1.default {
      * Logout of user account on all devices.
      * @handleName logoutAll
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {boolean} Returns true if the logout was successful, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the logout was successful, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description This method requires user authorization.
      * @see For more information about configuring the {@link https://js-sdk.oneentry.cloud/docs/category/authprovider authorization module}, see the documentation in the  {@link https://js-sdk.oneentry.cloud/docs/category/authprovider configuration settings section of the SDK}.
      */
@@ -260,8 +268,8 @@ class AuthProviderApi extends asyncModules_1.default {
      * @param {string} code - Service code. Example: "123456".
      * @param {string} newPassword - New password. Example: "newPassword123".
      * @param {string} [repeatPassword] - Optional variable contains repeat new password for validation. Example: "newPassword123".
-     * @returns {boolean} Returns true if the password was successfully changed, or an error object if there was an issue.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<boolean | IError>} Returns true if the password was successfully changed, or an error object if there was an issue.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User password change (only for tariffs with account activation and the Activation feature enabled).
      */
     async changePassword(marker, userIdentifier, eventIdentifier, type, code, newPassword, repeatPassword) {
@@ -282,21 +290,23 @@ class AuthProviderApi extends asyncModules_1.default {
      * @param {string} [langCode] - Language code. Default: "en_US".
      * @param {number} [offset] - Parameter for pagination. Default: 0.
      * @param {number} [limit] - Parameter for pagination. Default: 30.
-     * @returns {IAuthProvidersEntity[]} Returns an array of auth provider objects.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthProvidersEntity[] | IError>} Returns an array of auth provider objects.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting all objects of authorization providers.
      */
     async getAuthProviders(langCode = this.state.lang, offset = 0, limit = 30) {
         const result = await this._fetchGet(`?langCode=${langCode}&offset=${offset}&limit=${limit}`);
-        return this._normalizeData(result);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, authProviderSchemas_1.AuthProvidersResponseSchema);
+        return this._normalizeData(validated);
     }
     /**
      * Get one auth provider object by marker.
      * @handleName getAuthProviderByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {IAuthProvidersEntity} Returns an auth provider object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IAuthProvidersEntity | IError>} Returns an auth provider object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
      */
     async getAuthProviderByMarker(marker, langCode = this.state.lang) {
@@ -307,8 +317,8 @@ class AuthProviderApi extends asyncModules_1.default {
      * Getting active user sessions data.
      * @handleName getActiveSessionsByMarker
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @returns {IActiveSession[]} Returns an auth provider object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<IActiveSession[] | IError>} Returns an auth provider object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description Getting a single authorization provider object by marker.
      */
     async getActiveSessionsByMarker(marker) {
@@ -317,9 +327,9 @@ class AuthProviderApi extends asyncModules_1.default {
     }
     /**
      * User registration (authorization) via OAUTH.
-     * @handleName oauthSignUp
+     * @handleName oauth
      * @param {string} marker - The text identifier of the authorization provider. Example: "email".
-     * @param {IOAuthSignUpData} body - Object contains OAuth information for registration.
+     * @param {IOauthData} body - Object contains OAuth information for registration.
      * @example
         {
           "client_id": "34346983-luuct343473qdkqidjopdfp3eb3k4thp.apps.googleusercontent.com",
@@ -329,11 +339,11 @@ class AuthProviderApi extends asyncModules_1.default {
           "redirect_uri": "http://localhost:3000"
         }
      * @param {string} [langCode] - Language code. Default: "en_US".
-     * @returns {ISignUpEntity} Returns a user object.
-     * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
+     * @returns {Promise<ISignUpEntity | IError>} Returns a user object.
+     * @throws {IError} When isShell=false and an error occurs during the fetch
      * @description User registration (authorization) via OAUTH.
      */
-    async oauthSignUp(marker, body, langCode = this.state.lang) {
+    async oauth(marker, body, langCode = this.state.lang) {
         const result = await this._fetchPost(`/marker/${marker}/oauth`, this._normalizePostBody(body, langCode));
         return result;
     }

package/dist/auth-provider/authProviderSchemas.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Validation schemas for Auth Provider module
+ * @description Zod schemas for validating auth-related API responses
+ */
+import { z } from 'zod';
+/**
+ * Sign up response schema
+ * @description Schema for validating sign up response
+ */
+export declare const SignUpResponseSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    identifier: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phoneMask: z.ZodOptional<z.ZodString>;
+    phoneCode: z.ZodOptional<z.ZodString>;
+    phoneNumber: z.ZodOptional<z.ZodString>;
+    statusMarker: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Auth response schema (login/refresh)
+ * @description Schema for validating auth response
+ */
+export declare const AuthResponseSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    refreshToken: z.ZodString;
+    userIdentifier: z.ZodOptional<z.ZodString>;
+    authProviderIdentifier: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodObject<{
+        id: z.ZodNumber;
+        identifier: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phoneMask: z.ZodOptional<z.ZodString>;
+        phoneCode: z.ZodOptional<z.ZodString>;
+        phoneNumber: z.ZodOptional<z.ZodString>;
+        statusMarker: z.ZodOptional<z.ZodString>;
+        formData: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+        total: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        authProviderIdentifier: z.ZodOptional<z.ZodString>;
+        formIdentifier: z.ZodOptional<z.ZodString>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        state: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * User response schema
+ * @description Schema for validating user response
+ */
+export declare const UserResponseSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    identifier: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phoneMask: z.ZodOptional<z.ZodString>;
+    phoneCode: z.ZodOptional<z.ZodString>;
+    phoneNumber: z.ZodOptional<z.ZodString>;
+    statusMarker: z.ZodOptional<z.ZodString>;
+    formData: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+    total: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    authProviderIdentifier: z.ZodOptional<z.ZodString>;
+    formIdentifier: z.ZodOptional<z.ZodString>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    state: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    moduleFormConfigs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+}, z.core.$strip>;
+/**
+ * Auth provider entity schema
+ * @description Schema for validating auth provider entity
+ * Includes all fields returned by the API
+ */
+export declare const AuthProviderEntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    identifier: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    formIdentifier: z.ZodOptional<z.ZodString>;
+    userGroupIdentifier: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodBoolean;
+    isCheckCode: z.ZodOptional<z.ZodBoolean>;
+    version: z.ZodOptional<z.ZodNumber>;
+    localizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    marker: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Auth providers list response schema
+ * @description Schema for validating auth providers list response
+ */
+export declare const AuthProvidersResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    identifier: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    formIdentifier: z.ZodOptional<z.ZodString>;
+    userGroupIdentifier: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodBoolean;
+    isCheckCode: z.ZodOptional<z.ZodBoolean>;
+    version: z.ZodOptional<z.ZodNumber>;
+    localizeInfos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    marker: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    position: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>>;
+/**
+ * Generate code response schema
+ * @description Schema for validating generate code response
+ */
+export declare const GenerateCodeResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Logout response schema
+ * @description Schema for validating logout response
+ */
+export declare const LogoutResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Active sessions response schema
+ * @description Schema for validating active sessions response
+ */
+export declare const ActiveSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    deviceInfo: z.ZodOptional<z.ZodString>;
+    ipAddress: z.ZodOptional<z.ZodString>;
+    lastActive: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const ActiveSessionsResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    deviceInfo: z.ZodOptional<z.ZodString>;
+    ipAddress: z.ZodOptional<z.ZodString>;
+    lastActive: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>>;