complexqa_frontend_core 1.28.1 → 1.30.1

package/publish/types/family_elements/autotest_step_actions/typeAutotestStepActionVariants.js

@@ -0,0 +1,148 @@
+import { typeAutotestStepAction } from './typeAutotestStepAction.js';
+import { typeAutotestStepLocatorAction } from './typeAutotestStepLocatorAction.js';
+import { typeAutotestStepLocatorValueAction } from './typeAutotestStepLocatorValueAction.js';
+
+
+export class typeAutotestStepGoto extends typeAutotestStepAction
+{
+	static action_name = 'goto';
+	static value_need = 'optional';
+	static value_field_key = 'url';
+}
+
+export class typeAutotestStepClick extends typeAutotestStepLocatorAction
+{
+	static action_name = 'click';
+}
+
+export class typeAutotestStepDblclick extends typeAutotestStepLocatorAction
+{
+	static action_name = 'dblclick';
+}
+
+export class typeAutotestStepFill extends typeAutotestStepLocatorValueAction
+{
+	static action_name = 'fill';
+}
+
+export class typeAutotestStepType extends typeAutotestStepLocatorValueAction
+{
+	static action_name = 'type';
+}
+
+export class typeAutotestStepPress extends typeAutotestStepLocatorValueAction
+{
+	static action_name = 'press';
+	static value_field_key = 'key';
+}
+
+export class typeAutotestStepCheck extends typeAutotestStepLocatorAction
+{
+	static action_name = 'check';
+}
+
+export class typeAutotestStepUncheck extends typeAutotestStepLocatorAction
+{
+	static action_name = 'uncheck';
+}
+
+export class typeAutotestStepSelectOption extends typeAutotestStepLocatorValueAction
+{
+	static action_name = 'selectOption';
+}
+
+export class typeAutotestStepHover extends typeAutotestStepLocatorAction
+{
+	static action_name = 'hover';
+}
+
+export class typeAutotestStepFocus extends typeAutotestStepLocatorAction
+{
+	static action_name = 'focus';
+}
+
+export class typeAutotestStepWaitForSelector extends typeAutotestStepLocatorAction
+{
+	static action_name = 'waitForSelector';
+}
+
+export class typeAutotestStepWaitForURL extends typeAutotestStepAction
+{
+	static action_name = 'waitForURL';
+	static value_need = 'required';
+	static value_field_key = 'url';
+}
+
+export class typeAutotestStepWaitForTimeout extends typeAutotestStepAction
+{
+	static action_name = 'waitForTimeout';
+	static value_need = 'required';
+	static value_field_key = 'duration_ms';
+}
+
+export class typeAutotestStepGoBack extends typeAutotestStepAction
+{
+	static action_name = 'goBack';
+}
+
+export class typeAutotestStepGoForward extends typeAutotestStepAction
+{
+	static action_name = 'goForward';
+}
+
+export class typeAutotestStepReload extends typeAutotestStepAction
+{
+	static action_name = 'reload';
+}
+
+export class typeAutotestStepToBeVisible extends typeAutotestStepLocatorAction
+{
+	static action_name = 'toBeVisible';
+	static group = 'expect';
+}
+
+export class typeAutotestStepToHaveText extends typeAutotestStepLocatorValueAction
+{
+	static action_name = 'toHaveText';
+	static group = 'expect';
+}
+
+export class typeAutotestStepToHaveURL extends typeAutotestStepAction
+{
+	static action_name = 'toHaveURL';
+	static group = 'expect';
+	static value_need = 'required';
+	static value_field_key = 'url';
+}
+
+export class typeAutotestStepToHaveAttribute extends typeAutotestStepLocatorValueAction
+{
+	static action_name = 'toHaveAttribute';
+	static group = 'expect';
+	static value_field_key = 'attribute_name';
+	static has_expected_value = true;
+}
+
+export const AUTOTEST_STEP_ACTION_CLASSES = [
+	typeAutotestStepGoto,
+	typeAutotestStepClick,
+	typeAutotestStepDblclick,
+	typeAutotestStepFill,
+	typeAutotestStepType,
+	typeAutotestStepPress,
+	typeAutotestStepCheck,
+	typeAutotestStepUncheck,
+	typeAutotestStepSelectOption,
+	typeAutotestStepHover,
+	typeAutotestStepFocus,
+	typeAutotestStepWaitForSelector,
+	typeAutotestStepWaitForURL,
+	typeAutotestStepWaitForTimeout,
+	typeAutotestStepGoBack,
+	typeAutotestStepGoForward,
+	typeAutotestStepReload,
+	typeAutotestStepToBeVisible,
+	typeAutotestStepToHaveText,
+	typeAutotestStepToHaveURL,
+	typeAutotestStepToHaveAttribute,
+];

package/publish/types/family_elements/autotest_step_actions/typeAutotestStepLocatorAction.js

@@ -0,0 +1,12 @@
+import { typeAutotestStepAction } from './typeAutotestStepAction.js';
+
+
+/**
+ * ACTION with a required locator target.
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export class typeAutotestStepLocatorAction extends typeAutotestStepAction
+{
+	static target_need = 'required';
+}

package/publish/types/family_elements/autotest_step_actions/typeAutotestStepLocatorValueAction.js

@@ -0,0 +1,13 @@
+import { typeAutotestStepLocatorAction } from './typeAutotestStepLocatorAction.js';
+
+
+/**
+ * ACTION with locator target and value_text.
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export class typeAutotestStepLocatorValueAction extends typeAutotestStepLocatorAction
+{
+	static value_need = 'required';
+	static value_field_key = 'text';
+}

package/publish/types/family_elements/typeAttachment.js

@@ -72,7 +72,7 @@ export class typeAttachment extends familyGeneralElement
 	 */
 	static get_element_type_values()
 	{
-		return [ 'bug' ];
+		return [ 'bug', 'autotest_result' ];
 	}
 
 

package/publish/types/family_elements/typeAutotestCase.js

@@ -0,0 +1,220 @@
+import { is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeAutotestCase_i18n } from "../element_translate/typeAutotestCase.i18n.js";
+import _ from 'underscore';
+
+
+/**
+ * Исполняемый автотест платформы (не Git-спека).
+ *
+ * @version			v.1.0 (04/09/2026)
+ */
+export class typeAutotestCase extends familyTestAutomation
+{
+	autotest_case_id;
+	team_id;
+	project_id;
+	autotest_suite_id;
+	test_case_id;
+	execution_context_id;
+	autotest_case_title;
+	autotest_case_description;
+	autotest_case_status;
+	autotest_case_kind;
+	test_account_id;
+	pre_autotest_case_ids;
+	created_at;
+	updated_at;
+
+	primary_key = 'autotest_case_id';
+	api_key     = 'autotest_case';
+
+	structure_scheme = {
+		autotest_case_id     : 'integer | require',
+		team_id              : 'integer | require',
+		project_id           : 'integer | require',
+		autotest_suite_id    : 'integer | optional',
+		test_case_id         : 'integer | optional',
+		execution_context_id : 'integer | optional',
+		autotest_case_title      : 'string | optional',
+		autotest_case_description: 'string | optional',
+		autotest_case_status     : 'string | enum | optional',
+		autotest_case_kind       : 'string | enum | optional',
+		test_account_id      : 'integer | optional',
+		pre_autotest_case_ids: 'array | optional',
+		created_at           : 'timestamp | optional',
+		updated_at           : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'autotest_case_title',
+		'autotest_suite_id',
+		'test_case_id',
+		'test_account_id',
+		'autotest_case_kind',
+		'pre_autotest_case_ids',
+	];
+
+	available_enum_values = {
+		autotest_case_status: [ 'PENDING', 'READY', 'DISABLED' ],
+		autotest_case_kind  : [ 'CASE', 'COMMON' ],
+	};
+
+	enum_value_translate_matrix = typeAutotestCase_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeAutotestCase_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		PENDING : '#C4B040',
+		READY   : '#009688',
+		DISABLED: '#E0E0E0',
+	};
+
+	kind_color = {
+		CASE  : '#009688',
+		COMMON: '#5C6BC0',
+	};
+
+
+	/**
+	 * @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_case_title;
+	}
+
+
+	/**
+	 * Compile from typeTestCase. Separate entry from empty create.
+	 *
+	 * @param {object} payload
+	 * @param {number} payload.test_case_id
+	 * @param {object|typeFunctionCallback} callback
+	 * @returns {Promise<void>}
+	 */
+	async create_from_test_case(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].create_from_test_case(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback.success({ response, payload });
+			}
+		}).catch((error) =>
+		{
+			if (typeof callback?.error === 'function')
+			{
+				callback.error({ error, payload });
+			}
+		}).finally((response) =>
+		{
+			if (typeof callback?.final === 'function')
+			{
+				callback.final({ response, payload });
+			}
+		});
+	}
+
+
+	/**
+	 * Replace explicit predecessors. Dedicated entry: not update_property.
+	 *
+	 * @param {object} payload
+	 * @param {number} payload.autotest_case_id
+	 * @param {array} payload.pre_autotest_case_ids
+	 * @param {object} callback
+	 * @returns {Promise<void>}
+	 */
+	async replace_pre_cases(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].replace_pre_cases(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback.success({ response, payload });
+			}
+		}).catch((error) =>
+		{
+			if (typeof callback?.error === 'function')
+			{
+				callback.error({ error, payload });
+			}
+		}).finally((response) =>
+		{
+			if (typeof callback?.final === 'function')
+			{
+				callback.final({ response, payload });
+			}
+		});
+	}
+
+
+	/**
+	 * Read-only syntax of stored steps. Does not open the target site.
+	 *
+	 * @param {object} payload
+	 * @param {number} payload.autotest_case_id
+	 * @param {object} callback
+	 * @returns {Promise<void>}
+	 */
+	async check_syntax(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].check_syntax(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback.success({ response, payload });
+			}
+		}).catch((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/typeAutotestResult.js

@@ -0,0 +1,81 @@
+import { is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeAutotestResult_i18n } from "../element_translate/typeAutotestResult.i18n.js";
+import _ from 'underscore';
+
+
+/**
+ * Результат одного автотеста в запуске. FAILED = шаг на странице; ERROR = инфра / allowlist.
+ *
+ * @version			v.1.0 (04/09/2026)
+ */
+export class typeAutotestResult extends familyTestAutomation
+{
+	autotest_result_id;
+	autotest_run_id;
+	autotest_case_id;
+	team_id;
+	autotest_result_status;
+	report_json;
+	screenshot_file_uuid;
+	started_at;
+	finished_at;
+	created_at;
+	updated_at;
+
+	primary_key = 'autotest_result_id';
+	api_key     = 'autotest_result';
+
+	structure_scheme = {
+		autotest_result_id     : 'integer | require',
+		autotest_run_id        : 'integer | require',
+		autotest_case_id       : 'integer | require',
+		team_id                : 'integer | require',
+		autotest_result_status : 'string | enum | optional',
+		report_json            : 'string | optional',
+		screenshot_file_uuid   : 'string | optional',
+		started_at             : 'timestamp | optional',
+		finished_at            : 'timestamp | optional',
+		created_at             : 'timestamp | optional',
+		updated_at             : 'timestamp | optional',
+	};
+
+	create_scheme = [];
+
+	available_enum_values = {
+		autotest_result_status: [ 'PENDING', 'PASSED', 'FAILED', 'SKIPPED', 'ERROR' ],
+	};
+
+	enum_value_translate_matrix = typeAutotestResult_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeAutotestResult_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		PENDING: '#C4B040',
+		PASSED : '#009688',
+		FAILED : '#E53935',
+		SKIPPED: '#90A4AE',
+		ERROR  : '#6A1B9A',
+	};
+
+
+	/**
+	 * @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/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 });
+			}
+		});
+	}
+}