complexqa_frontend_core 1.29.1 → 1.30.1

package/publish/types/family_elements/typeAutotestRun.js

@@ -0,0 +1,165 @@
+import { echo, is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeAutotestRun_i18n } from "../element_translate/typeAutotestRun.i18n.js";
+import _ from 'underscore';
+
+
+/**
+ * Запуск пачки автотестов. Контекст выполнения - браузер; стартовый домен - team_domain_id.
+ *
+ * @version			v.1.0 (04/09/2026)
+ */
+export class typeAutotestRun extends familyTestAutomation
+{
+	autotest_run_id;
+	team_id;
+	project_id;
+	execution_context_id;
+	team_domain_id;
+	autotest_run_status;
+	pass_percent;
+	result_counts;
+	autotest_case_ids;
+	max_threads;
+	retry_count;
+	step_timeout_ms;
+	case_timeout_ms;
+	run_timeout_ms;
+	screenshot_on_failure;
+	consecutive_error_stop;
+	created_by_user_id;
+	started_at;
+	finished_at;
+	created_at;
+	updated_at;
+
+	primary_key = 'autotest_run_id';
+	api_key     = 'autotest_run';
+
+	structure_scheme = {
+		autotest_run_id        : 'integer | require',
+		team_id                : 'integer | require',
+		project_id             : 'integer | require',
+		execution_context_id   : 'integer | require',
+		team_domain_id         : 'integer | require',
+		autotest_run_status    : 'string | enum | optional',
+		pass_percent           : 'integer | optional',
+		result_counts          : 'array | optional',
+		autotest_case_ids      : 'array | optional',
+		max_threads            : 'integer | optional',
+		retry_count            : 'integer | optional',
+		step_timeout_ms        : 'integer | optional',
+		case_timeout_ms        : 'integer | optional',
+		run_timeout_ms         : 'integer | optional',
+		screenshot_on_failure  : 'integer | optional',
+		consecutive_error_stop : 'integer | optional',
+		created_by_user_id     : 'integer | optional',
+		started_at             : 'timestamp | optional',
+		finished_at            : 'timestamp | optional',
+		created_at             : 'timestamp | optional',
+		updated_at             : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'execution_context_id',
+		'team_domain_id',
+		'autotest_case_ids',
+		'max_threads',
+		'retry_count',
+		'step_timeout_ms',
+		'case_timeout_ms',
+		'run_timeout_ms',
+		'screenshot_on_failure',
+		'consecutive_error_stop',
+	];
+
+	available_enum_values = {
+		autotest_run_status: [ 'PENDING', 'IN_PROGRESS', 'COMPLETED', 'CLOSED', 'CANCELLED' ],
+	};
+
+	enum_value_translate_matrix = typeAutotestRun_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeAutotestRun_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		PENDING    : '#C4B040',
+		IN_PROGRESS: '#FD9A4F',
+		COMPLETED  : '#009688',
+		CLOSED     : '#E0E0E0',
+		CANCELLED  : '#9E9E9E',
+	};
+
+
+	/**
+	 * @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;
+	}
+
+
+	/**
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return String(this.autotest_run_id ?? '');
+	}
+
+
+	/**
+	 * @param {object|typeFunctionCallback} callback
+	 * @returns {Promise<void>}
+	 */
+	async cancel(callback)
+	{
+		if (!this.autotest_run_id)
+		{
+			throw new Error('Error #165-2216 - element has no autotest_run_id');
+		}
+
+		const payload = {
+			autotest_run_id: this.autotest_run_id,
+		};
+
+		if (typeof callback?.before === 'function')
+		{
+			callback.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].cancel(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/typeAutotestStep.js

@@ -0,0 +1,297 @@
+import { echo, is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeAutotestStep_i18n } from "../element_translate/typeAutotestStep.i18n.js";
+import _ from 'underscore';
+
+
+/**
+ * Шаг исполняемого автотеста. action_name - белый список интерпретатора Playwright.
+ *
+ * @version			v.1.0 (04/09/2026)
+ */
+export class typeAutotestStep extends familyTestAutomation
+{
+	autotest_step_id;
+	autotest_case_id;
+	team_id;
+	sort_order;
+	action_name;
+	target;
+	value_text;
+	timeout_ms;
+	expected_value;
+	object_repository_page_id;
+	object_repository_element_id;
+	value_source_type;
+	value_source_field;
+	created_at;
+	updated_at;
+
+	primary_key = 'autotest_step_id';
+	api_key     = 'autotest_step';
+
+	structure_scheme = {
+		autotest_step_id: 'integer | require',
+		autotest_case_id: 'integer | require',
+		team_id         : 'integer | require',
+		sort_order      : 'integer | optional',
+		action_name     : 'string | enum | require',
+		target          : 'typeAutotestStepTarget | optional',
+		value_text      : 'string | optional',
+		timeout_ms      : 'integer | optional',
+		expected_value  : 'string | optional',
+		object_repository_page_id   : 'integer | optional',
+		object_repository_element_id: 'integer | optional',
+		value_source_type           : 'string | enum | optional',
+		value_source_field          : 'string | optional',
+		created_at      : 'timestamp | optional',
+		updated_at      : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'autotest_case_id',
+		'action_name',
+		'sort_order',
+		'target',
+		'value_text',
+		'timeout_ms',
+		'expected_value',
+		'object_repository_page_id',
+		'object_repository_element_id',
+		'value_source_type',
+		'value_source_field',
+	];
+
+	available_enum_values = {
+		action_name: [
+			'goto',
+			'click',
+			'dblclick',
+			'fill',
+			'type',
+			'press',
+			'check',
+			'uncheck',
+			'selectOption',
+			'hover',
+			'focus',
+			'waitForSelector',
+			'waitForURL',
+			'waitForTimeout',
+			'goBack',
+			'goForward',
+			'reload',
+			'toBeVisible',
+			'toHaveText',
+			'toHaveURL',
+			'toHaveAttribute',
+		],
+		value_source_type: [
+			'INLINE',
+			'TEST_ACCOUNT',
+		],
+	};
+
+	enum_value_translate_matrix = typeAutotestStep_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeAutotestStep_i18n.attribute_name_translate_matrix;
+
+
+	/**
+	 * @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;
+	}
+
+
+	/**
+	 * @version        v.1.0 (05/09/2026)
+	 * @param element
+	 * @param callback
+	 */
+	increase_sort_order(element = false, callback)
+	{
+		if (!element)
+		{
+			element = this;
+		}
+
+		let payload = {
+			autotest_step_id: element.autotest_step_id
+		};
+
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].increase_sort_order(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 })
+			}
+		});
+	}
+
+
+	/**
+	 * @version        v.1.0 (05/09/2026)
+	 * @param element
+	 * @param callback
+	 */
+	decrease_sort_order(element = false, callback)
+	{
+		if (!element)
+		{
+			element = this;
+		}
+
+		let payload = {
+			autotest_step_id: element.autotest_step_id
+		};
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].decrease_sort_order(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 })
+			}
+		});
+	}
+
+
+	/**
+	 * Save action fields and target for one step.
+	 *
+	 * @version        v.1.0 (05/09/2026)
+	 * @param {object} payload
+	 * @param {object} callback
+	 */
+	save(payload = false, callback)
+	{
+		if (!payload)
+		{
+			payload = {
+				autotest_step_id: this.autotest_step_id,
+				action_name     : this.action_name,
+				target          : this.target,
+				value_text      : this.value_text,
+				timeout_ms      : this.timeout_ms,
+				expected_value  : this.expected_value,
+				object_repository_page_id   : this.object_repository_page_id,
+				object_repository_element_id: this.object_repository_element_id,
+				value_source_type           : this.value_source_type,
+				value_source_field          : this.value_source_field,
+				sort_order      : this.sort_order,
+			};
+		}
+
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].save(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 })
+			}
+		});
+	}
+
+
+	/**
+	 * Save a JSON array of steps. Each item must include autotest_step_id.
+	 *
+	 * @version        v.1.0 (05/09/2026)
+	 * @param {object} payload
+	 * @param {object} callback
+	 */
+	save_json(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].save_json(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/typeAutotestStepTarget.js

@@ -0,0 +1,50 @@
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { is_object } from "../../utils/utils.js";
+import { AUTOTEST_STEP_LOCATOR_KINDS } from "./autotest_step_actions/autotestStepLocatorKind.js";
+import _ from 'underscore';
+
+
+/**
+ * Цель шага автотеста (вложена в typeAutotestStep.target). Без API.
+ * Канон: kind + value + optional name.
+ *
+ * @version			v.1.1 (05/09/2026)
+ */
+export class typeAutotestStepTarget extends familyTestAutomation
+{
+	kind;
+	value;
+	name;
+
+	structure_scheme = {
+		kind : 'string | enum | optional',
+		value: 'string | optional',
+		name : 'string | optional',
+	};
+
+	available_enum_values = {
+		kind: AUTOTEST_STEP_LOCATOR_KINDS,
+	};
+
+
+	/**
+	 * @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/typeAutotestSuite.js

@@ -0,0 +1,74 @@
+import { is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeAutotestSuite_i18n } from "../element_translate/typeAutotestSuite.i18n.js";
+import _ from 'underscore';
+
+
+/**
+ * Дерево сьютов автотестов.
+ *
+ * @version			v.1.0 (04/09/2026)
+ */
+export class typeAutotestSuite extends familyTestAutomation
+{
+	autotest_suite_id;
+	team_id;
+	project_id;
+	parent_autotest_suite_id;
+	autotest_suite_title;
+	created_at;
+	updated_at;
+
+	primary_key = 'autotest_suite_id';
+	api_key     = 'autotest_suite';
+
+	structure_scheme = {
+		autotest_suite_id       : 'integer | require',
+		team_id                 : 'integer | require',
+		project_id              : 'integer | require',
+		parent_autotest_suite_id: 'integer | optional',
+		autotest_suite_title    : 'string | optional',
+		created_at              : 'timestamp | optional',
+		updated_at              : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'autotest_suite_title',
+		'parent_autotest_suite_id',
+	];
+
+	enum_value_translate_matrix = typeAutotestSuite_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeAutotestSuite_i18n.attribute_name_translate_matrix;
+
+
+	/**
+	 * @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;
+	}
+
+
+	/**
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.autotest_suite_title;
+	}
+}

package/publish/types/family_elements/typeCustomProperty.js

@@ -77,7 +77,7 @@ export class typeCustomProperty extends familyTestDocumentation
 
 	static get_element_type_values()
 	{
-		return [ 'test_case', 'bug' ];
+		return [ 'test_case', 'bug', 'autotest_case', 'autotest_run', 'object_repository_page', 'object_repository_element', 'object_repository_folder' ];
 	}
 
 

package/publish/types/family_elements/typeObjectRepositoryElement.js

@@ -0,0 +1,88 @@
+import { is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeObjectRepositoryElement_i18n } from "../element_translate/typeObjectRepositoryElement.i18n.js";
+import { AUTOTEST_STEP_LOCATOR_KINDS } from "./autotest_step_actions/autotestStepLocatorKind.js";
+import _ from 'underscore';
+
+
+/**
+ * Object Repository element. Live locator: locator_kind + locator_value (+ locator_name for ROLE).
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export class typeObjectRepositoryElement extends familyTestAutomation
+{
+	object_repository_element_id;
+	team_id;
+	project_id;
+	object_repository_folder_id;
+	object_repository_element_title;
+	locator_kind;
+	locator_value;
+	locator_name;
+	created_at;
+	updated_at;
+
+	primary_key = 'object_repository_element_id';
+	api_key     = 'object_repository_element';
+
+	structure_scheme = {
+		object_repository_element_id   : 'integer | require',
+		team_id                        : 'integer | require',
+		project_id                     : 'integer | require',
+		object_repository_folder_id    : 'integer | optional',
+		object_repository_element_title: 'string | optional',
+		locator_kind                   : 'string | enum | require',
+		locator_value                  : 'string | optional',
+		locator_name                   : 'string | optional',
+		created_at                     : 'timestamp | optional',
+		updated_at                     : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'object_repository_element_title',
+		'object_repository_folder_id',
+		'locator_kind',
+		'locator_value',
+		'locator_name',
+	];
+
+	available_enum_values = {
+		locator_kind: AUTOTEST_STEP_LOCATOR_KINDS.slice(),
+	};
+
+	enum_value_translate_matrix = typeObjectRepositoryElement_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeObjectRepositoryElement_i18n.attribute_name_translate_matrix;
+
+
+	/**
+	 * @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;
+	}
+
+
+	/**
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.object_repository_element_title;
+	}
+}