complexqa_frontend_core 2.2.3 → 2.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "2.2.3",
+  "version": "2.3.1",
   "description": "core of web ",
   "type": "module",
   "exports": {

package/src/api/api_abstract_class.js

@@ -1,340 +1,340 @@
-import axios from 'axios';
-import qs from 'query-string';
-import { ApiException } from "../exceptions/ApiException.js";
-import { clone_object, echo, is_array, is_object } from "../utils/utils.js";
-import { UserService } from "../services/UserService.js";
-
-/**
- *
- * @version			v.1.0 (03/06/2026)
- */
-export class ApiAbstractClass
-{
-	init_options;
-	element_class_instance;
-	dev_stage_config;
-	parent_app;
-	host_api;
-	stage         = 'production';
-	/** @type {string|false} */
-	module_prefix = false;
-	api_prefix    = '';
-	method;
-	headers;
-	search_cache_enabled = false;
-
-
-	/**
-	 *
-	 * @version			v.1.0 (03/06/2026)
-	 * @param options
-	 */
-	constructor(options)
-	{
-		if (options?.init_options)
-		{
-			this.init_options = options?.init_options;
-		}
-		if (options?.stage)
-		{
-			this.stage = options?.stage;
-		}
-		if (options?.dev_stage_config)
-		{
-			this.dev_stage_config = options?.dev_stage_config;
-		}
-		if (options?.parent_app)
-		{
-			this.parent_app = options?.parent_app;
-		}
-		if (options?.host_api)
-		{
-			this.host_api = options?.host_api;
-		}
-	}
-
-
-	set_element_class_instance(element_class_instance)
-	{
-		this.element_class_instance = element_class_instance;
-	}
-
-
-
-	/**
-	 *
-	 * @version			v.0.1 (26/05/2024)
-	 * @param {object|import('../types/family_service/typeFOR.js').typeFOR} payload
-	 */
-	async search(payload)
-	{
-		if (!this.module_prefix)
-		{
-			throw new Error('Error #10-1152 in ApiAbstractClass');
-		}
-
-		if (this.stage === 'development')
-		{
-			let response = await this.mock_search(payload);
-			return {
-				response: response,
-				payload : payload
-			};
-		}
-
-		let url = `/${ this.api_prefix }/${ this.module_prefix }/search`;
-
-		payload      = this.handle_request_payload(payload);
-		let response = this.api_request(url, payload);
-		response     = this.handle_response(response);
-
-		return {
-			response: response,
-			payload : payload
-		};
-	}
-
-
-	/**
-	 *
-	 * @version			v.0.1 (27/06/2024)
-	 * @param payload
-	 * @returns {Promise<array>}
-	 */
-	async mock_search(payload)
-	{
-		// @todo - дописать
-		if (this.dev_stage_config.api_response_search_element_count > 0 && this.dev_stage_config.api_response_search_element_count < 999)
-		{
-
-		}
-		else
-		{
-			throw new Error('Error #100-154');
-		}
-
-		let model    = new this.element_class_instance();
-		let response = model.get_random_demo_data(this.dev_stage_config.api_response_search_element_count)
-
-		return response;
-
-	}
-
-
-
-
-	/******************************************************************************************/
-	/******************************************************************************************/
-
-	/******************************************************************************************/
-
-	/**
-	 *
-	 * @param payload
-	 * @returns {*}
-	 */
-	handle_request_payload(payload)
-	{
-		return this.object_replace_null_recursively(payload);
-	}
-
-
-	/**
-	 *
-	 * @param object
-	 * @returns {*}
-	 */
-	object_replace_null_recursively(object)
-	{
-		let result = clone_object(object);
-		for (let key in result)
-		{
-			if (result[ key ] === null)
-			{
-				result[ key ] = 'NULL';
-			}
-			else if (( result[ key ]?.constructor === Object ) || ( result[ key ]?.constructor === Array ))
-			{
-				result[ key ] = this.object_replace_null_recursively(result[ key ]);
-			}
-		}
-
-		return result;
-	}
-
-
-	/**
-	 *
-	 * @param url
-	 * @param payload
-	 * @param method
-	 * @returns {Promise<Promise<axios.AxiosResponse<any>> | *>}
-	 * @version			v.0.2 (26/01/2025)
-	 * @todo - валидация входящих параметров
-	 */
-	async api_request(url, payload, method = 'POST')
-	{
-		let request_params;
-		if (!payload)
-		{
-			request_params = {};
-		}
-		else
-		{
-			request_params = clone_object(payload)
-		}
-
-		request_params = this.mixin_service_params(request_params);
-
-		if (this.host_api)
-		{
-			const page_hostname = (typeof window !== 'undefined' && window.location)
-				? window.location.hostname
-				: '';
-			const api_hostname = String(this.host_api).split(':')[0];
-			if (!page_hostname || page_hostname !== api_hostname)
-			{
-				url = 'https://' + this.host_api + url;
-			}
-		}
-
-		const headers = { ...(this.headers || {}) };
-		const csrf_token = UserService.get_csrf_token();
-		if (csrf_token)
-		{
-			headers['X-CSRF-TOKEN'] = csrf_token;
-		}
-
-		let request_options = {
-			method : method,
-			headers: headers,
-			url    : url
-		};
-
-		if (method === 'get' || method === 'GET')
-		{
-			request_options.paramsSerializer = this.object_to_string;
-			request_options.params           = request_params;
-		}
-		else
-		{
-			request_options.data = (request_params);
-		}
-
-		let config = {};
-
-		return axios(request_options, config);
-	}
-
-
-	/**
-	 *
-	 * @param object
-	 * @returns {string}
-	 * @todo - валидация входящих параметров
-	 */
-	object_to_string(object)
-	{
-		let result = qs.stringify(object, { array_format: 'indices' });
-
-		return result;
-	}
-
-
-	mixin_service_params(params)
-	{
-		params.client = 'webapp';
-		return params;
-	}
-
-
-	/**
-	 *
-	 * @param {object} response
-	 * @param {object} init_class_instance
-	 * @returns {Promise<any>}
-	 * @version			v.0.1 (04/03/2026)
-	 */
-	handle_response(response, init_class_instance = true)
-	{
-		response = response.then((api_response) =>
-		{
-			let error_payload = {
-				api_response: api_response?.data?.api_response,
-				api_code    : api_response?.data?.api_code,
-				api_result  : api_response?.data?.api_result,
-				api_error   : api_response?.data?.api_error,
-				hint        : api_response?.data?.hint
-			};
-
-			if (api_response?.data?.api_error?.adapted_message)
-			{
-				error_payload.message = api_response.data.api_error.adapted_message
-				throw new ApiException(error_payload);
-			}
-			else if (api_response?.data?.api_code)
-			{
-				let api_code = api_response.data.api_code;
-
-				if (( api_code >= 200 ) && ( api_code <= 299 ))
-				{
-					if (is_array(api_response?.data?.api_result) && this.element_class_instance)
-					{
-						let result = api_response?.data.api_result.map((row) =>
-						{
-							if (init_class_instance)
-							{
-								return new this.element_class_instance(row);
-							}
-							else
-							{
-								return row;
-							}
-						});
-
-						return result;
-					}
-					else if (is_object(api_response?.data?.api_result))
-					{
-						return api_response?.data?.api_result;
-					}
-					else if (api_response?.data?.api_result === false)
-					{
-						return api_response?.data?.api_result;
-					}
-					else
-					{
-						return api_response?.data;
-					}
-				}
-				else if (api_response?.data?.api_result === false)
-				{
-					throw new ApiException(error_payload);
-				}
-				else
-				{
-					throw new ApiException(error_payload);
-				}
-			}
-			else
-			{
-				return api_response?.data;
-			}
-		})
-			.catch((error) =>
-			{
-
-				echo({ app: this });
-				console.error(error);
-				if (error instanceof ApiException)
-				{
-					throw error;
-				}
-
-
-				throw new ApiException({ error: error });
-			});
-
-		return response;
-	}
+import axios from 'axios';
+import qs from 'query-string';
+import { ApiException } from "../exceptions/ApiException.js";
+import { clone_object, echo, is_array, is_object } from "../utils/utils.js";
+import { UserService } from "../services/UserService.js";
+
+/**
+ *
+ * @version			v.1.0 (03/06/2026)
+ */
+export class ApiAbstractClass
+{
+	init_options;
+	element_class_instance;
+	dev_stage_config;
+	parent_app;
+	host_api;
+	stage         = 'production';
+	/** @type {string|false} */
+	module_prefix = false;
+	api_prefix    = '';
+	method;
+	headers;
+	search_cache_enabled = false;
+
+
+	/**
+	 *
+	 * @version			v.1.0 (03/06/2026)
+	 * @param options
+	 */
+	constructor(options)
+	{
+		if (options?.init_options)
+		{
+			this.init_options = options?.init_options;
+		}
+		if (options?.stage)
+		{
+			this.stage = options?.stage;
+		}
+		if (options?.dev_stage_config)
+		{
+			this.dev_stage_config = options?.dev_stage_config;
+		}
+		if (options?.parent_app)
+		{
+			this.parent_app = options?.parent_app;
+		}
+		if (options?.host_api)
+		{
+			this.host_api = options?.host_api;
+		}
+	}
+
+
+	set_element_class_instance(element_class_instance)
+	{
+		this.element_class_instance = element_class_instance;
+	}
+
+
+
+	/**
+	 *
+	 * @version			v.0.1 (26/05/2024)
+	 * @param {object|import('../types/family_service/typeFOR.js').typeFOR} payload
+	 */
+	async search(payload)
+	{
+		if (!this.module_prefix)
+		{
+			throw new Error('Error #10-1152 in ApiAbstractClass');
+		}
+
+		if (this.stage === 'development')
+		{
+			let response = await this.mock_search(payload);
+			return {
+				response: response,
+				payload : payload
+			};
+		}
+
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/search`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
+
+		return {
+			response: response,
+			payload : payload
+		};
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (27/06/2024)
+	 * @param payload
+	 * @returns {Promise<array>}
+	 */
+	async mock_search(payload)
+	{
+		// @todo - дописать
+		if (this.dev_stage_config.api_response_search_element_count > 0 && this.dev_stage_config.api_response_search_element_count < 999)
+		{
+
+		}
+		else
+		{
+			throw new Error('Error #100-154');
+		}
+
+		let model    = new this.element_class_instance();
+		let response = model.get_random_demo_data(this.dev_stage_config.api_response_search_element_count)
+
+		return response;
+
+	}
+
+
+
+
+	/******************************************************************************************/
+	/******************************************************************************************/
+
+	/******************************************************************************************/
+
+	/**
+	 *
+	 * @param payload
+	 * @returns {*}
+	 */
+	handle_request_payload(payload)
+	{
+		return this.object_replace_null_recursively(payload);
+	}
+
+
+	/**
+	 *
+	 * @param object
+	 * @returns {*}
+	 */
+	object_replace_null_recursively(object)
+	{
+		let result = clone_object(object);
+		for (let key in result)
+		{
+			if (result[ key ] === null)
+			{
+				result[ key ] = 'NULL';
+			}
+			else if (( result[ key ]?.constructor === Object ) || ( result[ key ]?.constructor === Array ))
+			{
+				result[ key ] = this.object_replace_null_recursively(result[ key ]);
+			}
+		}
+
+		return result;
+	}
+
+
+	/**
+	 *
+	 * @param url
+	 * @param payload
+	 * @param method
+	 * @returns {Promise<Promise<axios.AxiosResponse<any>> | *>}
+	 * @version			v.0.2 (26/01/2025)
+	 * @todo - валидация входящих параметров
+	 */
+	async api_request(url, payload, method = 'POST')
+	{
+		let request_params;
+		if (!payload)
+		{
+			request_params = {};
+		}
+		else
+		{
+			request_params = clone_object(payload)
+		}
+
+		request_params = this.mixin_service_params(request_params);
+
+		if (this.host_api)
+		{
+			const page_hostname = (typeof window !== 'undefined' && window.location)
+				? window.location.hostname
+				: '';
+			const api_hostname = String(this.host_api).split(':')[0];
+			if (!page_hostname || page_hostname !== api_hostname)
+			{
+				url = 'https://' + this.host_api + url;
+			}
+		}
+
+		const headers = { ...(this.headers || {}) };
+		const csrf_token = UserService.get_csrf_token();
+		if (csrf_token)
+		{
+			headers['X-CSRF-TOKEN'] = csrf_token;
+		}
+
+		let request_options = {
+			method : method,
+			headers: headers,
+			url    : url
+		};
+
+		if (method === 'get' || method === 'GET')
+		{
+			request_options.paramsSerializer = this.object_to_string;
+			request_options.params           = request_params;
+		}
+		else
+		{
+			request_options.data = (request_params);
+		}
+
+		let config = {};
+
+		return axios(request_options, config);
+	}
+
+
+	/**
+	 *
+	 * @param object
+	 * @returns {string}
+	 * @todo - валидация входящих параметров
+	 */
+	object_to_string(object)
+	{
+		let result = qs.stringify(object, { array_format: 'indices' });
+
+		return result;
+	}
+
+
+	mixin_service_params(params)
+	{
+		params.client = 'webapp';
+		return params;
+	}
+
+
+	/**
+	 *
+	 * @param {object} response
+	 * @param {object} init_class_instance
+	 * @returns {Promise<any>}
+	 * @version			v.0.1 (04/03/2026)
+	 */
+	handle_response(response, init_class_instance = true)
+	{
+		response = response.then((api_response) =>
+		{
+			let error_payload = {
+				api_response: api_response?.data?.api_response,
+				api_code    : api_response?.data?.api_code,
+				api_result  : api_response?.data?.api_result,
+				api_error   : api_response?.data?.api_error,
+				hint        : api_response?.data?.hint
+			};
+
+			if (api_response?.data?.api_error?.adapted_message)
+			{
+				error_payload.message = api_response.data.api_error.adapted_message
+				throw new ApiException(error_payload);
+			}
+			else if (api_response?.data?.api_code)
+			{
+				let api_code = api_response.data.api_code;
+
+				if (( api_code >= 200 ) && ( api_code <= 299 ))
+				{
+					if (is_array(api_response?.data?.api_result) && this.element_class_instance)
+					{
+						let result = api_response?.data.api_result.map((row) =>
+						{
+							if (init_class_instance)
+							{
+								return new this.element_class_instance(row);
+							}
+							else
+							{
+								return row;
+							}
+						});
+
+						return result;
+					}
+					else if (is_object(api_response?.data?.api_result))
+					{
+						return api_response?.data?.api_result;
+					}
+					else if (api_response?.data?.api_result === false)
+					{
+						return api_response?.data?.api_result;
+					}
+					else
+					{
+						return api_response?.data;
+					}
+				}
+				else if (api_response?.data?.api_result === false)
+				{
+					throw new ApiException(error_payload);
+				}
+				else
+				{
+					throw new ApiException(error_payload);
+				}
+			}
+			else
+			{
+				return api_response?.data;
+			}
+		})
+			.catch((error) =>
+			{
+
+				echo({ app: this });
+				console.error(error);
+				if (error instanceof ApiException)
+				{
+					throw error;
+				}
+
+
+				throw new ApiException({ error: error });
+			});
+
+		return response;
+	}
 }