complexqa_frontend_core 1.3.1 → 1.4.1

package/package.json

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

package/publish/api/api_abstract_element_class.js

@@ -1,4 +1,4 @@
-import { clone_object, echo, is_array } from "../utils/utils";
+import { clone_object, echo, is_array, is_object } from "../utils/utils";
 import axios from "axios";
 import * as qs from "query-string";
 import { ApiException } from "../exceptions/ApiException";
@@ -85,9 +85,9 @@ export class ApiAbstractElementClass
 
 		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);
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
 
 		return {
 			response: response,
@@ -158,9 +158,9 @@ export class ApiAbstractElementClass
 
 		let url = `/${ this.api_prefix }/${ this.module_prefix }/create`;
 
-		payload      = this.#handle_request_payload(payload);
-		let response = this.#api_request(url, payload);
-		response     = this.#handle_response(response);
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
 
 		return {
 			response: response,
@@ -206,9 +206,9 @@ export class ApiAbstractElementClass
 
 		let url = `/${ this.api_prefix }/${ this.module_prefix }/update_property`;
 
-		payload      = this.#handle_request_payload(payload);
-		let response = this.#api_request(url, payload);
-		response     = this.#handle_response(response);
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
 
 		return {
 			response: response,
@@ -239,9 +239,9 @@ export class ApiAbstractElementClass
 
 		let url = `/${ this.api_prefix }/${ this.module_prefix }/delete`;
 
-		payload      = this.#handle_request_payload(payload);
-		let response = this.#api_request(url, payload);
-		response     = this.#handle_response(response);
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
 
 		return {
 			response: response,
@@ -255,12 +255,12 @@ export class ApiAbstractElementClass
 
 	/******************************************************************************************/
 
-	#handle_request_payload(payload)
+	handle_request_payload(payload)
 	{
-		return this.#object_replace_null_recursively(payload);
+		return this.object_replace_null_recursively(payload);
 	}
 
-	#object_replace_null_recursively(object)
+	object_replace_null_recursively(object)
 	{
 		let result = clone_object(object);
 		for (let key in result)
@@ -271,7 +271,7 @@ export class ApiAbstractElementClass
 			}
 			else if (( result[ key ]?.constructor === Object ) || ( result[ key ]?.constructor === Array ))
 			{
-				result[ key ] = this.#object_replace_null_recursively(result[ key ]);
+				result[ key ] = this.object_replace_null_recursively(result[ key ]);
 			}
 		}
 
@@ -286,8 +286,9 @@ export class ApiAbstractElementClass
 	 * @param method
 	 * @returns {Promise<Promise<axios.AxiosResponse<any>> | *>}
 	 * @version			v.0.2 (26/01/2025)
+	 * @todo - валидация входящих параметров
 	 */
-	async #api_request(url, payload, method = 'POST')
+	async api_request(url, payload, method = 'POST')
 	{
 		let request_params;
 		if (!payload)
@@ -299,9 +300,9 @@ export class ApiAbstractElementClass
 			request_params = clone_object(payload)
 		}
 
-		request_params = this.#mixin_service_params(request_params);
+		request_params = this.mixin_service_params(request_params);
 
-		console.log({payload, request_params});
+		//console.log({payload, request_params});
 
 
 		if (this.host_api)
@@ -335,6 +336,7 @@ export class ApiAbstractElementClass
 	 *
 	 * @param object
 	 * @returns {string}
+	 * @todo - валидация входящих параметров
 	 */
 	object_to_string(object)
 	{
@@ -344,7 +346,7 @@ export class ApiAbstractElementClass
 	}
 
 
-	#mixin_service_params(params)
+	mixin_service_params(params)
 	{
 		params.client = 'webapp';
 		return params;
@@ -357,7 +359,7 @@ export class ApiAbstractElementClass
 	 * @returns {Promise<any>}
 	 * @version			v.0.1 (01/06/2024)
 	 */
-	#handle_response(response)
+	handle_response(response)
 	{
 		response = response.then((api_response) =>
 		{
@@ -379,15 +381,19 @@ export class ApiAbstractElementClass
 
 				if (( api_code >= 200 ) && ( api_code <= 299 ))
 				{
-					if (is_array(api_response?.data) && this.element_class_instance)
+					if (is_array(api_response?.data?.api_result) && this.element_class_instance)
 					{
-						let result = api_response?.data.map((row) =>
+						let result = api_response?.data.api_result.map((row) =>
 						{
 							return new this.element_class_instance(row);
 						});
 
 						return result;
 					}
+					else if (is_object(api_response?.data?.api_result))
+					{
+						return api_response?.data?.api_result;
+					}
 					else
 					{
 						return api_response?.data;

package/publish/api/project_api.js

@@ -14,4 +14,29 @@ export class ProjectApi extends ApiAbstractElementClass
 		super(options);
 		this.set_element_class_instance(typeProject);
 	}
+
+
+
+
+	/**
+	 *
+	 * All test cases + suites
+	 *
+	 * @version        v.1.0 (23/08/2025)
+	 * @param payload
+	 * @todo - валидация входящих параметров
+	 */
+	async get_test_structure(payload)
+	{
+		let url = `/web_api/project/get/test_structure`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
+
+		return {
+			response: response,
+			payload : payload
+		};
+	}
 }

package/publish/app_configuration/abstract_app_configuration.js

@@ -0,0 +1,33 @@
+/**
+ *
+ * @version			v.0.1 (19/08/2025)
+ */
+export class abstractAppConfiguration
+{
+	static init_options = false;
+
+	static config = {};
+
+	static state = {
+		loaded: false
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (19/08/2025)
+	 * @param init_options - надо ли?
+	 */
+	constructor(init_options = false)
+	{}
+
+	/**
+	 *
+	 * @version			v.0.1 (19/08/2025)
+	 * @param element_type
+	 * @param section
+	 * @param lang ???
+	 */
+	static get_config(element_type = false, section = false, lang = false)
+	{}
+}

package/publish/app_configuration/menu_configuration_main.js

@@ -0,0 +1,119 @@
+import { abstractAppConfiguration } from "./abstract_app_configuration.js";
+import { typeMenuElement } from "../types/family_service/typeMenuElement.js";
+import { UserService } from "../services/UserService.js";
+
+/**
+ * Основное меню (верхнее)
+ *
+ * @version			v.0.1 (19/08/2025)
+ */
+export class MenuConfigurationMain extends abstractAppConfiguration
+{
+	static config = {};
+
+	static state = {
+		loaded: false
+	}
+
+
+	/**
+	 *
+	 * @param init_options
+	 */
+	constructor(init_options = false)
+	{
+		super();
+		if (this.constructor._instance)
+		{
+			return this.constructor._instance;
+		}
+
+		this.init_options = init_options;
+
+		this.constructor._instance = this;
+
+		MenuConfigurationMain.bootstrap();
+	}
+
+
+	/**
+	 * Не понятно пока как лучше организовать
+	 * @version			v.0.1 (17/08/2025)
+	 */
+	static bootstrap()
+	{
+		if (this.state.loaded)
+		{
+			return;
+		}
+
+		this.bootstrap_menu();
+
+		this.state.loaded = true;
+	}
+
+	static bootstrap_menu()
+	{
+		this.config.menu_elements = this.bootstrap_menu_elements();
+	}
+
+
+	/**
+	 *
+	 * @returns {boolean|*}
+	 */
+	static get_config()
+	{
+		if (!this.state.loaded)
+		{
+			this.bootstrap();
+		}
+
+		return this.config;
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (19/08/2025)
+	 * @returns {[typeMenuElement]}
+	 */
+	static bootstrap_menu_elements()
+	{
+		let locale = UserService.get_current_language();
+
+		// @todo - use serviceTranslate
+
+		let response = [];
+
+		response.push(new typeMenuElement({
+			link      : `/web/${ locale }/project/listing`,
+			text      : 'Projects',
+			icon      : '?',
+			sort_order: 1,
+		}));
+
+		response.push(new typeMenuElement({
+			link      : `/web/${ locale }/test_case/listing`,
+			text      : 'Test Cases',
+			icon      : '?',
+			sort_order: 2,
+		}));
+
+		response.push(new typeMenuElement({
+			link      : `/web/${ locale }/test_run/listing`,
+			text      : 'Test Runs',
+			icon      : '?',
+			sort_order: 3,
+		}));
+
+		/*response.push(new typeMenuElement({
+			link      : `/web/${ locale }/task/listing`,
+			text      : 'To Do',
+			icon      : '?',
+			sort_order: 4,
+		}));*/
+
+		return response;
+	}
+}

package/publish/app_configuration/menu_configuration_secondary.js

@@ -0,0 +1,140 @@
+import { abstractAppConfiguration } from "./abstract_app_configuration.js";
+import { UserService } from "../services/UserService.js";
+import { typeMenuElement } from "../types/family_service/typeMenuElement.js";
+
+/**
+ * Дополнительное меню (нижнее)
+ *
+ * @version			v.0.1 (19/08/2025)
+ */
+export class MenuConfigurationSecondary extends abstractAppConfiguration
+{
+	static config = {};
+
+	static state = {
+		loaded: false
+	}
+
+
+
+	/**
+	 *
+	 * @param init_options
+	 */
+	constructor(init_options = false)
+	{
+		super();
+		if (this.constructor._instance)
+		{
+			return this.constructor._instance;
+		}
+
+		this.init_options = init_options;
+
+		this.constructor._instance = this;
+
+		MenuConfigurationSecondary.bootstrap();
+	}
+
+
+
+
+	/**
+	 * Не понятно пока как лучше организовать
+	 * @version			v.0.1 (17/08/2025)
+	 */
+	static bootstrap()
+	{
+		if (this.state.loaded)
+		{
+			return;
+		}
+
+		this.bootstrap_menu();
+
+		this.state.loaded = true;
+	}
+
+	static bootstrap_menu()
+	{
+		this.config.menu_elements = this.bootstrap_menu_elements();
+	}
+
+
+	/**
+	 *
+	 * @returns {boolean|*}
+	 */
+	static get_config()
+	{
+		if (!this.state.loaded)
+		{
+			this.bootstrap();
+		}
+
+		return this.config;
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (19/08/2025)
+	 * @returns {[typeMenuElement]}
+	 */
+	static bootstrap_menu_elements()
+	{
+		let locale = UserService.get_current_language();
+
+		// @todo - use serviceTranslate
+
+		let response = [];
+
+		response.push(new typeMenuElement({
+			link      : `/web/${ locale }/user_profile`,
+			text      : 'User Settings',
+			icon      : '?',
+			sort_order: 1,
+		}));
+
+		let lang_sub_menu = [];
+
+		lang_sub_menu.push(new typeMenuElement({
+			link      : `/web/en`, // @todo - get current routing and replace $lang
+			text      : `EN`,
+			icon      : '?',
+			sort_order: 1,
+			reload: true,
+		}));
+
+		lang_sub_menu.push(new typeMenuElement({
+			link      : `/web/ru`, // @todo - get current routing and replace $lang
+			text      : `RU`,
+			icon      : '?',
+			sort_order: 2,
+			reload: true,
+		}));
+
+		response.push(new typeMenuElement({
+			link      : false,
+			text      : `Language ${ locale }`,
+			icon      : '?',
+			sort_order: 2,
+			sub_menu : lang_sub_menu
+		}));
+
+		response.push(new typeMenuElement({
+			link      : `/web/${ locale }/team_management/team/listing`,
+			text      : 'Teams',
+			icon      : '?',
+			sort_order: 3,
+		}));
+
+		/*
+			feedback
+			docs
+			admins
+		*/
+
+		return response;
+	}
+}

package/publish/app_configuration/table_configuration.js

@@ -1,15 +1,13 @@
 import { typeTableConfiguration } from "../types/family_service/typeTableConfiguration.js";
 import { typeTableColumn } from "../types/family_service/typeTableColumn.js";
+import { abstractAppConfiguration } from "./abstract_app_configuration.js";
 
 /**
  *
  * @version			v.0.1 (17/08/2025)
  */
-export class TableConfiguration
+export class TableConfiguration extends abstractAppConfiguration
 {
-
-	static init_options = false;
-
 	static config = {};
 
 	static state = {
@@ -22,6 +20,7 @@ export class TableConfiguration
 	 */
 	constructor(init_options = false)
 	{
+		super();
 		if (this.constructor._instance)
 		{
 			return this.constructor._instance;
@@ -31,7 +30,7 @@ export class TableConfiguration
 
 		this.constructor._instance = this;
 
-		this.#bootstrap();
+		TableConfiguration.bootstrap();
 	}
 
 
@@ -48,7 +47,7 @@ export class TableConfiguration
 	{
 		if (!this.state.loaded)
 		{
-			this.#bootstrap();
+			this.bootstrap();
 		}
 
 		if (this.config?.[ element_type ]?.[ section ])
@@ -72,14 +71,14 @@ export class TableConfiguration
 	 * Не понятно пока как лучше организовать
 	 * @version			v.0.1 (17/08/2025)
 	 */
-	static #bootstrap()
+	static bootstrap()
 	{
 		if (this.state.loaded)
 		{
 			return;
 		}
 
-		this.#bootstrap_test_case();
+		this.bootstrap_test_case();
 
 		this.state.loaded = true;
 	}
@@ -89,11 +88,11 @@ export class TableConfiguration
 	 *
 	 * @version			v.0.1 (17/08/2025)
 	 */
-	static #bootstrap_test_case()
+	static bootstrap_test_case()
 	{
 		let payload_listing = {};
 
-		let columns = this.#bootstrap_test_case_columns();
+		let columns = this.bootstrap_test_case_columns();
 
 		payload_listing.config = new typeTableConfiguration({
 			columns: columns
@@ -109,7 +108,7 @@ export class TableConfiguration
 	 *
 	 * @version			v.0.1 (17/08/2025)
 	 */
-	static #bootstrap_test_case_columns()
+	static bootstrap_test_case_columns()
 	{
 		let response = [];
 

package/publish/services/serviceTranslate.js

@@ -1,6 +1,7 @@
 import { abstractService } from "./abstractService";
 import i18next from 'i18next';
 import { Api } from "../api";
+import { echo, in_array } from "../utils/utils.js";
 
 /**
  *

package/publish/types/family_elements/typeProject.js

@@ -21,10 +21,10 @@ export class typeProject extends familyGeneralElement
 	api_key     = 'project';
 
 	structure_scheme = {
-		project_id            : 'integer | require',
-		project_name          : 'string | require',
-		project_description   : 'string | optional',
-		project_status        : 'string | enum | require',
+		project_id         : 'integer | require',
+		project_name       : 'string | require',
+		project_description: 'string | optional',
+		project_status     : 'string | enum | require',
 		team_id            : 'integer | require',
 		//reference_document_ids: 'array | reference | optional',
 	};
@@ -87,6 +87,48 @@ export class typeProject extends familyGeneralElement
 
 	/******************************************************************************************/
 
+	/**
+	 *
+	 * All test cases + suites
+	 * @version        v.1.0 (23/08/2025)
+	 * @param project_id
+	 * @param callback
+	 * @returns {Promise<any>}
+	 */
+	async get_test_structure(project_id = false, callback = {})
+	{
+		if (!project_id)
+		{
+			project_id = this.project_id;
+		}
+
+		let payload = {
+			project_id: project_id
+		}
+		/**
+		 * {Api} ApiService
+		 */
+		return ApiService[ this.api_key ].get_test_structure(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback?.success({ response, payload })
+			}
+		}).catch((error) =>
+		{
+			echo({ error });
+			if (typeof callback?.error === 'function')
+			{
+				callback?.error({ error, payload })
+			}
+		}).finally((response) =>
+		{
+			if (typeof callback?.final === 'function')
+			{
+				callback?.final({ response, payload })
+			}
+		});
+	}
 
 	/**
 	 *

package/publish/types/family_service/typeMenuElement.js

@@ -0,0 +1,32 @@
+import { familyService } from "./familyService.js";
+
+/**
+ *
+ * @version			v.0.1 (19/08/2025)
+ */
+export class typeMenuElement extends familyService
+{
+	link       = false; // при FALSE - нет <a>
+	text;
+	icon       = false;
+	sort_order = 0;
+	sub_menu   = false;
+	reload     = false; // при TRUE - надо полностью перезагрузить
+
+	constructor(data = false)
+	{
+		super();
+		if (data && typeof data === 'object')
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}