oneentry 1.0.136 → 1.0.137

package/README.md

@@ -155,6 +155,12 @@ const api = defineOneEntry('your-url', {
 })
 ```
 
+## Optional Features
+
+### API Response Validation
+
+OneEntry SDK supports optional validation of API responses using Zod. This feature is disabled by default and can be enabled for development or critical operations.
+
 ### Errors
 
 If you want to escape errors inside the sc, leave the "errors" property by default.
@@ -174,9 +180,15 @@ const api = defineOneEntry('your-url', {
     errors: {
         isShell: false,
         customErrors: {
-            400: (error) => console.error(error.message),
-            404: (error) => console.error(error.message),
-            500: (error) => console.error(error.message),
+            400: (error) => console.error('Bad Request:', error.message),
+            401: (error) => console.error('Unauthorized:', error.message),
+            403: (error) => console.error('Forbidden:', error.message),
+            404: (error) => console.error('Not Found:', error.message),
+            429: (error) => console.error('Rate Limit Exceeded:', error.message),
+            500: (error) => console.error('Server Error:', error.message),
+            502: (error) => console.error('Bad Gateway:', error.message),
+            503: (error) => console.error('Service Unavailable:', error.message),
+            504: (error) => console.error('Gateway Timeout:', error.message),
         },
     },
 })

package/configure.js

@@ -1,3 +1,23 @@
+#!/usr/bin/env node
+
+/**
+ * OneEntry SDK Configuration Tool
+ *
+ * Interactive CLI tool for initial SDK setup. Prompts the user for:
+ * - Project URL (must include https://)
+ * - Authentication token
+ *
+ * Generates an example.ts file with a TypeScript interface template
+ * containing the provided configuration values.
+ *
+ * Usage:
+ *   npx oneentry
+ *   or
+ *   oneentry (if installed globally)
+ *
+ * @see {@link https://github.com/OneEntry/oneentry-sdk} for more information
+ */
+
 /* eslint-disable no-undef */
 /* eslint-disable @typescript-eslint/no-require-imports */
 
@@ -19,9 +39,13 @@ rl.question('Enter project name with https://... : ', (name) => {
 });
 
 /**
- * Create interface
- * @param {*} name name
- * @param {*} token token
+ * Creates an example TypeScript interface file with SDK configuration
+ *
+ * Generates an example.ts file containing a BuildInterface type and
+ * IAttributesList interface with the provided project name and token.
+ *
+ * @param {string} name - Project URL with https:// (e.g., "https://example.oneentry.cloud")
+ * @param {string} token - Authentication token for API access
  */
 function createInterface(name, token) {
   const filePath = 'example.ts';

package/dist/admins/adminsApi.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+const adminsSchemas_1 = require("./adminsSchemas");
 /**
  * Controllers for working with users - admins.
  * @class AdminsApi
@@ -56,7 +57,9 @@ class AdminsApi extends asyncModules_1.default {
             limit,
         };
         const response = await this._fetchPost(`?` + this._queryParamsToString(query), body);
-        return this._normalizeData(response, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(response, adminsSchemas_1.AdminsResponseSchema);
+        return this._normalizeData(validated, langCode);
     }
 }
 exports.default = AdminsApi;

package/dist/admins/adminsInterfaces.d.ts

@@ -31,7 +31,7 @@ interface IAdmins {
      * @returns {IAdminEntity[]} Returns an array of admin objects.
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      */
-    getAdminsInfo(body: AttributeType[], langCode: string, offset: number, limit: number): Promise<IAdminEntity[] | IError>;
+    getAdminsInfo(body?: AttributeType[], langCode?: string, offset?: number, limit?: number): Promise<IAdminEntity[] | IError>;
 }
 /**
  * Interface representing a Position entity.

package/dist/admins/adminsSchemas.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Validation schemas for Admins module
+ * @description Zod schemas for validating admins-related API responses
+ */
+import { z } from 'zod';
+/**
+ * Admin entity schema
+ * Includes all fields returned by the API
+ */
+export declare const AdminEntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    attributeSetId: z.ZodNullable<z.ZodNumber>;
+    identifier: z.ZodString;
+    attributeSetIdentifier: z.ZodNullable<z.ZodString>;
+    position: z.ZodNullable<z.ZodNumber>;
+    isSync: z.ZodBoolean;
+    attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$catchall<z.ZodAny>>;
+/**
+ * Admins response schema (array of admin entities)
+ */
+export declare const AdminsResponseSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodNumber;
+    attributeSetId: z.ZodNullable<z.ZodNumber>;
+    identifier: z.ZodString;
+    attributeSetIdentifier: z.ZodNullable<z.ZodString>;
+    position: z.ZodNullable<z.ZodNumber>;
+    isSync: z.ZodBoolean;
+    attributeValues: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$catchall<z.ZodAny>>>;

package/dist/admins/adminsSchemas.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminsResponseSchema = exports.AdminEntitySchema = void 0;
+/**
+ * Validation schemas for Admins module
+ * @description Zod schemas for validating admins-related API responses
+ */
+const zod_1 = require("zod");
+/**
+ * Admin entity schema
+ * Includes all fields returned by the API
+ */
+exports.AdminEntitySchema = zod_1.z
+    .object({
+    id: zod_1.z.number(),
+    attributeSetId: zod_1.z.number().nullable(),
+    identifier: zod_1.z.string(),
+    attributeSetIdentifier: zod_1.z.string().nullable(),
+    position: zod_1.z.number().nullable(),
+    isSync: zod_1.z.boolean(),
+    attributeValues: zod_1.z.record(zod_1.z.string(), zod_1.z.any()),
+})
+    .catchall(zod_1.z.any()); // Allow additional dynamic properties
+/**
+ * Admins response schema (array of admin entities)
+ */
+exports.AdminsResponseSchema = zod_1.z.array(exports.AdminEntitySchema);

package/dist/attribute-sets/attributeSetsApi.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const asyncModules_1 = __importDefault(require("../base/asyncModules"));
+const attributeSetsSchemas_1 = require("./attributeSetsSchemas");
 /**
  * Controllers for working with attributes - AttributesSetsApi.
  * @class AttributesSetsApi
@@ -46,7 +47,9 @@ class AttributesSetsApi extends asyncModules_1.default {
             sortBy,
         };
         const result = await this._fetchGet(`?` + this._queryParamsToString(query));
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeSetsResponseSchema);
+        return this._dataPostProcess(validated, langCode);
     }
     /**
      * Getting all attributes with data from the attribute set.
@@ -58,7 +61,9 @@ class AttributesSetsApi extends asyncModules_1.default {
      */
     async getAttributesByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${marker}/attributes?langCode=${langCode}`);
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributesArrayResponseSchema);
+        return this._dataPostProcess(validated, langCode);
     }
     /**
      * Get a single attribute with data from the attribute sets.
@@ -71,7 +76,9 @@ class AttributesSetsApi extends asyncModules_1.default {
      */
     async getSingleAttributeByMarkerSet(setMarker, attributeMarker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/${setMarker}/attributes/${attributeMarker}?langCode=${langCode}`);
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeEntitySchema);
+        return this._dataPostProcess(validated, langCode);
     }
     /**
      * Getting a single object from a set of attributes by marker.
@@ -83,7 +90,9 @@ class AttributesSetsApi extends asyncModules_1.default {
      */
     async getAttributeSetByMarker(marker, langCode = this.state.lang) {
         const result = await this._fetchGet(`/marker/${marker}?langCode=${langCode}`);
-        return this._dataPostProcess(result, langCode);
+        // Validate response if validation is enabled
+        const validated = this._validateResponse(result, attributeSetsSchemas_1.AttributeSetEntitySchema);
+        return this._dataPostProcess(validated, langCode);
     }
 }
 exports.default = AttributesSetsApi;

package/dist/attribute-sets/attributeSetsSchemas.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Validation schemas for AttributeSets module
+ * @description Zod schemas for validating attribute sets-related API responses
+ */
+import { z } from 'zod';
+/**
+ * List title schema for list and radioButton attributes
+ */
+export declare const ListTitleSchema: z.ZodObject<{
+    title: z.ZodString;
+    value: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    position: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+    extended: z.ZodObject<{
+        value: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Attribute entity schema (single attribute from a set)
+ */
+export declare const AttributeEntitySchema: z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodOptional<z.ZodAny>;
+    initialValue: z.ZodAny;
+    marker: z.ZodString;
+    position: z.ZodNumber;
+    listTitles: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+    validators: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+    localizeInfos: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>;
+    additionalFields: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+    settings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+}, z.core.$strip>;
+/**
+ * Attribute set entity schema (attribute set object)
+ */
+export declare const AttributeSetEntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    createdDate: z.ZodString;
+    updatedDate: z.ZodString;
+    version: z.ZodNumber;
+    identifier: z.ZodString;
+    typeId: z.ZodNumber;
+    title: z.ZodString;
+    schema: z.ZodObject<{}, z.core.$loose>;
+    isVisible: z.ZodBoolean;
+    properties: z.ZodObject<{}, z.core.$loose>;
+    type: z.ZodObject<{
+        id: z.ZodNumber;
+        type: z.ZodString;
+    }, z.core.$strip>;
+    position: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Attributes response schema (for getAttributes method)
+ */
+export declare const AttributeSetsResponseSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        createdDate: z.ZodString;
+        updatedDate: z.ZodString;
+        version: z.ZodNumber;
+        identifier: z.ZodString;
+        typeId: z.ZodNumber;
+        title: z.ZodString;
+        schema: z.ZodObject<{}, z.core.$loose>;
+        isVisible: z.ZodBoolean;
+        properties: z.ZodObject<{}, z.core.$loose>;
+        type: z.ZodObject<{
+            id: z.ZodNumber;
+            type: z.ZodString;
+        }, z.core.$strip>;
+        position: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Attributes array response schema (for getAttributesByMarker method)
+ */
+export declare const AttributesArrayResponseSchema: z.ZodArray<z.ZodObject<{
+    type: z.ZodString;
+    value: z.ZodOptional<z.ZodAny>;
+    initialValue: z.ZodAny;
+    marker: z.ZodString;
+    position: z.ZodNumber;
+    listTitles: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodAny>, z.ZodRecord<z.ZodString, z.ZodAny>]>>;
+    validators: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+    localizeInfos: z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>;
+    additionalFields: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+    settings: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny>]>>;
+}, z.core.$strip>>;

package/dist/attribute-sets/attributeSetsSchemas.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributesArrayResponseSchema = exports.AttributeSetsResponseSchema = exports.AttributeSetEntitySchema = exports.AttributeEntitySchema = exports.ListTitleSchema = void 0;
+/**
+ * Validation schemas for AttributeSets module
+ * @description Zod schemas for validating attribute sets-related API responses
+ */
+const zod_1 = require("zod");
+/**
+ * List title schema for list and radioButton attributes
+ */
+exports.ListTitleSchema = zod_1.z.object({
+    title: zod_1.z.string(),
+    value: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]),
+    position: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.null()]),
+    extended: zod_1.z.object({
+        value: zod_1.z.string().nullable(),
+        type: zod_1.z.string().nullable(),
+    }),
+});
+/**
+ * Attribute entity schema (single attribute from a set)
+ */
+exports.AttributeEntitySchema = zod_1.z.object({
+    type: zod_1.z.string(),
+    value: zod_1.z.any().optional(),
+    initialValue: zod_1.z.any(),
+    marker: zod_1.z.string(),
+    position: zod_1.z.number(),
+    listTitles: zod_1.z
+        .union([zod_1.z.array(zod_1.z.any()), zod_1.z.record(zod_1.z.string(), zod_1.z.any())])
+        .optional(),
+    validators: zod_1.z
+        .union([zod_1.z.record(zod_1.z.string(), zod_1.z.any()), zod_1.z.array(zod_1.z.any())])
+        .optional(),
+    localizeInfos: zod_1.z.union([zod_1.z.record(zod_1.z.string(), zod_1.z.any()), zod_1.z.array(zod_1.z.any())]),
+    additionalFields: zod_1.z
+        .union([zod_1.z.record(zod_1.z.string(), zod_1.z.any()), zod_1.z.array(zod_1.z.any())])
+        .optional(),
+    settings: zod_1.z
+        .union([zod_1.z.record(zod_1.z.string(), zod_1.z.any()), zod_1.z.array(zod_1.z.any())])
+        .optional(),
+});
+/**
+ * Attribute set entity schema (attribute set object)
+ */
+exports.AttributeSetEntitySchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    createdDate: zod_1.z.string(),
+    updatedDate: zod_1.z.string(),
+    version: zod_1.z.number(),
+    identifier: zod_1.z.string(),
+    typeId: zod_1.z.number(),
+    title: zod_1.z.string(),
+    schema: zod_1.z.object({}).passthrough(),
+    isVisible: zod_1.z.boolean(),
+    properties: zod_1.z.object({}).passthrough(),
+    type: zod_1.z.object({
+        id: zod_1.z.number(),
+        type: zod_1.z.string(),
+    }),
+    position: zod_1.z.number(),
+});
+/**
+ * Attributes response schema (for getAttributes method)
+ */
+exports.AttributeSetsResponseSchema = zod_1.z.object({
+    total: zod_1.z.number(),
+    items: zod_1.z.array(exports.AttributeSetEntitySchema),
+});
+/**
+ * Attributes array response schema (for getAttributesByMarker method)
+ */
+exports.AttributesArrayResponseSchema = zod_1.z.array(exports.AttributeEntitySchema);

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
@@ -75,6 +75,9 @@ 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.
@@ -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"
             }
           ]
         }
@@ -226,9 +229,9 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
     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",
@@ -242,5 +245,5 @@ export default class AuthProviderApi extends AsyncModules implements IAuthProvid
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @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
@@ -79,6 +80,9 @@ 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.
@@ -87,7 +91,9 @@ class AuthProviderApi extends asyncModules_1.default {
     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.
@@ -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"
             }
           ]
         }
@@ -179,13 +185,15 @@ class AuthProviderApi extends asyncModules_1.default {
      */
     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.
@@ -288,7 +296,9 @@ class AuthProviderApi extends asyncModules_1.default {
      */
     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.
@@ -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",
@@ -333,7 +343,7 @@ class AuthProviderApi extends asyncModules_1.default {
      * @throws {IError} - If there is an error during the fetch operation, it will return an error object.
      * @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>>;