complexqa_frontend_core 1.3.2 → 1.5.1

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.3.2",
+  "version": "1.5.1",
   "description": "core of web ",
   "type": "module",
   "exports": {
     ".": "./publish/index.js"
   },
   "files": [
-    "publish/"
+    "./publish"
   ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build_package": "rollup -c rollup.config.js"
   },
   "repository": {
     "type": "git",
@@ -28,7 +29,7 @@
     "@babel/plugin-transform-modules-commonjs": "^7.24.7",
     "@babel/plugin-transform-runtime": "^7.27.4",
     "@babel/preset-env": "^7.24.7",
-    "axios": "^1.7.2",
+    "axios": "^1.13.0",
     "gulp": "^5.0.0",
     "gulp-babel": "^8.0.0",
     "gulp-concat": "^2.6.1",
@@ -38,8 +39,8 @@
     "gulp-rollup": "^2.17.0",
     "gulp-strip-import-export": "^1.0.0",
     "gulp-uncomment": "^0.3.0",
-    "i18next": "^23.11.5",
-    "query-string": "^9.0.0",
+    "i18next": "^23.16.8",
+    "query-string": "^9.3.1",
     "uglify-js": "^3.19.3",
     "underscore": "^1.13.6"
   },
@@ -47,6 +48,7 @@
     "babel": "^6.23.0",
     "babel-plugin-module-resolver-standalone": "^0.0.2",
     "gulp-uglify": "^3.0.2",
-    "requirejs-babel": "^0.0.9"
+    "requirejs-babel": "^0.0.9",
+    "rollup-plugin-dts": "^6.2.3"
   }
 }

package/publish/api/api_abstract_element_class.js

@@ -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) =>
 		{

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/index.js

@@ -7,7 +7,7 @@ export { typeProject } from './types/family_elements/typeProject.js';
 export { typeTestCase } from './types/family_elements/typeTestCase.js';
 export { typeTestCaseStep } from './types/family_elements/typeTestCaseStep.js';
 export { UserService } from './services/UserService.js'
-export { Api } from "./api";
+export { Api } from "./api/index.js";
 
 
 /**

package/publish/services/serviceTranslate.js

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

package/publish/types/family_elements/1_familyTestAutomation.js

@@ -0,0 +1,20 @@
+import { familyGeneralElement } from "./0_familyGeneralElement.js";
+
+
+/**
+ * Семейство типов, относящееся к модулю автоматического тестирования
+ *
+ * @version			v.0.1 (29/11/2025)
+ */
+export class familyTestAutomation extends familyGeneralElement
+{
+
+	/**
+	 *
+	 * @param {any} data
+	 */
+	constructor(data = false)
+	{
+		super();
+	}
+}

package/publish/types/family_elements/1_familyTestDocumentation.js

@@ -0,0 +1,21 @@
+import { familyGeneralElement } from "./0_familyGeneralElement.js";
+
+
+/**
+ * Семейство типов, относящееся к модулю тестовой документации
+ *
+ * @version			v.0.1 (29/11/2025)
+ */
+export class familyTestDocumentation extends familyGeneralElement
+{
+
+	/**
+	 *
+	 * @param {any} data
+	 */
+	constructor(data = false)
+	{
+		super();
+	}
+
+}

package/publish/types/family_elements/typeAutomationTestEnvironment.js

@@ -0,0 +1,71 @@
+import { familyTestAutomation } from "./1_familyTestAutomation.js";
+import { is_object } from "../../utils/utils.js";
+
+/**
+ *
+ * @version			v.0.1 (29/11/2025)
+ */
+export class typeAutomationTestEnvironment extends familyTestAutomation
+{
+	automation_test_environment_id;
+	host;
+	protocol;
+	device_type;
+	browser_name;
+	browser_version;
+	display_preset;
+
+	primary_key = 'automation_test_environment_id';
+
+	structure_scheme = {
+		automation_test_environment_id: 'integer | require',
+		host                          : 'string | require',
+		protocol                      : 'string | require',
+		device_type                   : 'string | enum | require',
+		browser_name                  : 'string | enum | optional',
+		browser_version               : 'string | optional',
+		display_preset                : 'string | enum | optional',
+	};
+
+
+	available_enum_values = {
+		device_type: [
+			'desktop',
+			'mobile',
+		],
+		browser_name: [
+			'chrome',
+			'firefox',
+			'webkit',
+			'edge',
+		],
+		display_preset: [
+			'small',
+			'medium',
+			'large',
+		],
+	};
+
+
+	/**
+	 *
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}

package/publish/types/family_elements/typeAutomationTestPlan.js

@@ -0,0 +1,12 @@
+import { familyTestAutomation } from "./1_familyTestAutomation.js";
+
+/**
+ * Пока - просто коллекция typeAutomationTestStep
+ * Возможно, также окружение
+ *
+ * @version			v.0.1 (29/11/2025)
+ */
+export class typeAutomationTestPlan extends familyTestAutomation
+{
+	test_step_ids;
+}

package/publish/types/family_elements/typeAutomationTestStep.js

@@ -0,0 +1,62 @@
+import { familyTestAutomation } from "./1_familyTestAutomation.js";
+import { is_object } from "../../utils/utils.js";
+
+/**
+ *
+ * @version			v.0.1 (29/11/2025)
+ */
+export class typeAutomationTestStep extends familyTestAutomation
+{
+	automation_test_step_id;
+	target;	// typeAutomationTestStepTarget
+	action;
+	time;
+	screenshot;
+	url;
+
+	primary_key = 'automation_test_step_id';
+
+	structure_scheme = {
+		automation_test_step_id: 'integer | require',
+		target                 : 'typeAutomationTestStepTarget | optional',
+		action                 : 'string | enum | require',
+		time                   : 'integer | optional',
+		screenshot             : 'string | optional',
+		url                    : 'string | optional',
+	};
+
+	available_enum_values = {
+		action: [
+			'wait_element_located',
+			'wait',
+			'click',
+			'right_click',
+			'keypress',
+			'keypress_special',
+			'clear',
+			'load_page',
+		]
+	};
+
+	/**
+	 *
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}

package/publish/types/family_elements/typeAutomationTestStepTarget.js

@@ -0,0 +1,38 @@
+import { familyTestAutomation } from "./1_familyTestAutomation.js";
+import { is_object } from "../../utils/utils.js";
+
+/**
+ * По сути это enum
+ * Но тут есть (будут) проверки на корректность, потому это отдельный тип
+ * 
+ * @version			v.0.1 (29/11/2025)
+ */
+export class typeAutomationTestStepTarget extends familyTestAutomation
+{
+	partial_link_text;
+	css;
+	id;
+	name;
+
+	/**
+	 *
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}

package/publish/types/family_elements/typeFunctional.js

@@ -1,12 +1,13 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 
 /**
  *
  * @version			v.0.1 (23/06/2024)
  */
-export class typeFunctional extends familyGeneralElement
+export class typeFunctional extends familyTestDocumentation
 {
 	functional_id;
 	project_id;					// foreign key

package/publish/types/family_elements/typeFunctionalGroup.js

@@ -1,11 +1,12 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 
 /**
  * @version			v.0.2 (25/01/2025)
  */
-export class typeFunctionalGroup extends familyGeneralElement
+export class typeFunctionalGroup extends familyTestDocumentation
 {
 	functional_group_id;
 	project_id;							// foreign key

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_elements/typeTestCase.js

@@ -1,12 +1,13 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { echo, is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 
 /**
  *
  * @version			v.0.2 (10/12/2024)
  */
-export class typeTestCase extends familyGeneralElement
+export class typeTestCase extends familyTestDocumentation
 {
 	test_case_id;
 	test_suite_id;					// foreign key

package/publish/types/family_elements/typeTestCaseStep.js

@@ -1,12 +1,13 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 
 /**
  *
  * @version			v.1.1 (26/05/2024)
  */
-export class typeTestCaseStep extends familyGeneralElement
+export class typeTestCaseStep extends familyTestDocumentation
 {
 	test_case_step_id;
 	test_case_step_type;

package/publish/types/family_elements/typeTestPlan.js

@@ -1,5 +1,6 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 
 /**
@@ -7,7 +8,7 @@ import { is_object } from "../../utils/utils";
  *
  * @version			v.0.1 (26/05/2024)
  */
-export class typeTestPlan  extends familyGeneralElement
+export class typeTestPlan  extends familyTestDocumentation
 {
 
 

package/publish/types/family_elements/typeTestRun.js

@@ -1,5 +1,6 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 /**
  * Коллекция тестов для работы, она же parent для typeTestRunResult
@@ -8,13 +9,13 @@ import { is_object } from "../../utils/utils";
  *
  * @version			v.0.2 (21/01/2025)
  */
-export class typeTestRun extends familyGeneralElement
+export class typeTestRun extends familyTestDocumentation
 {
 	test_run_id;
 	test_run_name;
 	test_run_description;
 	milestone_id; /// ??
-	assigned_to;
+	assigned_to; // кому назначили выполнение, пока в той же таблице, только 1 член команды
 	test_case_ids; // массив тестов на запуск
 	test_run_status;
 	test_case_summary_statistic; // массив [key->value] по статусам вложенных тест-кейсов для визуализации

package/publish/types/family_elements/typeTestRunResult.js

@@ -1,5 +1,6 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 /**
  * 1 результат по каждому тест кейсу
@@ -8,7 +9,7 @@ import { is_object } from "../../utils/utils";
  *
  * @version			v.0.4 (10/12/2024)
  */
-export class typeTestRunResult extends familyGeneralElement
+export class typeTestRunResult extends familyTestDocumentation
 {
 	test_run_result_id;
 	test_case_id;

package/publish/types/family_elements/typeTestSuite.js

@@ -1,12 +1,13 @@
 import { familyGeneralElement } from "./0_familyGeneralElement";
 import { echo, is_object } from "../../utils/utils";
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
 
 /**
  * Структурная коллекция тестов
  *
  * @version			v.1.1 (23/06/2024)
  */
-export class typeTestSuite extends familyGeneralElement
+export class typeTestSuite extends familyTestDocumentation
 {
 	test_suite_id;
 	project_id;