complexqa_frontend_core 1.29.1 → 1.30.2

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

@@ -0,0 +1,56 @@
+/**
+ * Explicit locator kinds. Same ids as PHP AutotestStepLocatorKind.
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export const AUTOTEST_STEP_LOCATOR_KINDS = [
+	'ROLE',
+	'LABEL',
+	'PLACEHOLDER',
+	'TESTID',
+	'TEXT',
+	'CSS',
+	'ID',
+	'NAME',
+	'XPATH',
+	'SELECTOR',
+];
+
+
+/**
+ * Playwright getByRole names. Subset used in the Role select.
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export const AUTOTEST_STEP_PLAYWRIGHT_ROLES = [
+	'alert',
+	'alertdialog',
+	'button',
+	'checkbox',
+	'combobox',
+	'dialog',
+	'heading',
+	'img',
+	'link',
+	'list',
+	'listitem',
+	'menuitem',
+	'navigation',
+	'option',
+	'radio',
+	'searchbox',
+	'switch',
+	'tab',
+	'table',
+	'textbox',
+];
+
+
+/**
+ * @param {string} kind
+ * @returns {boolean}
+ */
+export function is_autotest_step_locator_kind(kind)
+{
+	return AUTOTEST_STEP_LOCATOR_KINDS.indexOf(String(kind || '').toUpperCase()) !== -1;
+}

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

@@ -0,0 +1,134 @@
+import { is_autotest_step_locator_kind, AUTOTEST_STEP_LOCATOR_KINDS } from './autotestStepLocatorKind.js';
+import { is_object } from '../../../utils/utils.js';
+
+
+const LEGACY_KIND_ORDER = [
+	[ 'selector', 'SELECTOR' ],
+	[ 'css', 'CSS' ],
+	[ 'id', 'ID' ],
+	[ 'name', 'NAME' ],
+	[ 'placeholder', 'PLACEHOLDER' ],
+	[ 'label', 'LABEL' ],
+	[ 'testid', 'TESTID' ],
+	[ 'role', 'ROLE' ],
+	[ 'accessible_name', 'TEXT' ],
+	[ 'text', 'TEXT' ],
+	[ 'xpath', 'XPATH' ],
+];
+
+
+/**
+ * Canonical target: { kind, value, name? }. expected_value is a sibling of the locator in storage JSON.
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export function hydrate_autotest_step_target(decoded)
+{
+	if (!decoded || !is_object(decoded))
+	{
+		return { target: null, expected_value: null };
+	}
+
+	const copy = { ...decoded };
+	let expected_value = null;
+	if (Object.prototype.hasOwnProperty.call(copy, 'expected_value'))
+	{
+		if (copy.expected_value !== null && copy.expected_value !== '')
+		{
+			expected_value = String(copy.expected_value);
+		}
+		delete copy.expected_value;
+	}
+
+	return {
+		target        : locator_from_decoded(copy),
+		expected_value: expected_value,
+	};
+}
+
+
+/**
+ * @param {object|null} target
+ * @param {string|null} expected_value
+ * @returns {object|null}
+ */
+export function build_autotest_step_target_storage(target, expected_value)
+{
+	const payload = {};
+	if (target && is_object(target))
+	{
+		const kind = String(target.kind || '').toUpperCase();
+		if (kind && is_autotest_step_locator_kind(kind))
+		{
+			payload.kind  = kind;
+			payload.value = String(target.value ?? '');
+			if (target.name)
+			{
+				payload.name = String(target.name);
+			}
+		}
+	}
+	if (expected_value !== null && expected_value !== undefined && expected_value !== '')
+	{
+		payload.expected_value = String(expected_value);
+	}
+
+	return Object.keys(payload).length ? payload : null;
+}
+
+
+/**
+ * @param {object} decoded
+ * @returns {object|null}
+ */
+function locator_from_decoded(decoded)
+{
+	const kind = String(decoded.kind || '').toUpperCase();
+	if (kind)
+	{
+		if (!is_autotest_step_locator_kind(kind))
+		{
+			return null;
+		}
+		const locator = {
+			kind : kind,
+			value: String(decoded.value ?? ''),
+		};
+		const name = decoded.name || decoded.accessible_name || '';
+		if (name)
+		{
+			locator.name = String(name);
+		}
+
+		return locator;
+	}
+
+	for (let i = 0; i < LEGACY_KIND_ORDER.length; i++)
+	{
+		const key  = LEGACY_KIND_ORDER[ i ][ 0 ];
+		const map  = LEGACY_KIND_ORDER[ i ][ 1 ];
+		if (decoded[ key ] === undefined || decoded[ key ] === null || decoded[ key ] === '')
+		{
+			continue;
+		}
+		const locator = {
+			kind : map,
+			value: String(decoded[ key ]),
+		};
+		if (map === 'ROLE')
+		{
+			const name = decoded.accessible_name || decoded.text || '';
+			if (name)
+			{
+				locator.name = String(name);
+			}
+		}
+
+		return locator;
+	}
+
+	return null;
+}
+
+
+export { AUTOTEST_STEP_LOCATOR_KINDS };

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

@@ -0,0 +1,35 @@
+/**
+ * Base ACTION type. Shell (sort, clone, delete, timeout) lives on typeAutotestStep.
+ * Subclasses own only action fields and target rules.
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export class typeAutotestStepAction
+{
+	static type_id = 'ACTION';
+	static action_name = '';
+	static group = 'page';
+	static value_need = 'unused';
+	static target_need = 'unused';
+	static has_expected_value = false;
+	static value_field_key = 'value_text';
+
+
+	/**
+	 * @returns {object}
+	 */
+	catalog_entry()
+	{
+		const ctor = this.constructor;
+
+		return {
+			type_id           : ctor.action_name || ctor.type_id,
+			action_name       : ctor.action_name,
+			group             : ctor.group,
+			value_need        : ctor.value_need,
+			target_need       : ctor.target_need,
+			has_expected_value: ctor.has_expected_value,
+			value_field_key   : ctor.value_field_key,
+		};
+	}
+}

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;
+	}
+}