complexqa_frontend_core 1.28.1 → 1.30.1

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

package/publish/types/family_elements/typeObjectRepositoryFolder.js

@@ -0,0 +1,81 @@
+import { is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeObjectRepositoryFolder_i18n } from "../element_translate/typeObjectRepositoryFolder.i18n.js";
+import _ from 'underscore';
+
+
+/**
+ * Object Repository folder for one listing kind: PAGE or ELEMENT.
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export class typeObjectRepositoryFolder extends familyTestAutomation
+{
+	object_repository_folder_id;
+	team_id;
+	project_id;
+	parent_object_repository_folder_id;
+	object_repository_folder_kind;
+	object_repository_folder_title;
+	created_at;
+	updated_at;
+
+	primary_key = 'object_repository_folder_id';
+	api_key     = 'object_repository_folder';
+
+	structure_scheme = {
+		object_repository_folder_id       : 'integer | require',
+		team_id                           : 'integer | require',
+		project_id                        : 'integer | require',
+		parent_object_repository_folder_id: 'integer | optional',
+		object_repository_folder_kind     : 'string | enum | require',
+		object_repository_folder_title    : 'string | optional',
+		created_at                        : 'timestamp | optional',
+		updated_at                        : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'object_repository_folder_title',
+		'parent_object_repository_folder_id',
+		'object_repository_folder_kind',
+	];
+
+	available_enum_values = {
+		object_repository_folder_kind: [ 'PAGE', 'ELEMENT' ],
+	};
+
+	enum_value_translate_matrix = typeObjectRepositoryFolder_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeObjectRepositoryFolder_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_folder_title;
+	}
+}

package/publish/types/family_elements/typeObjectRepositoryPage.js

@@ -0,0 +1,77 @@
+import { is_object } from "../../utils/utils.js";
+import { familyTestAutomation } from "../core/1_familyTestAutomation.js";
+import { typeObjectRepositoryPage_i18n } from "../element_translate/typeObjectRepositoryPage.i18n.js";
+import _ from 'underscore';
+
+
+/**
+ * Object Repository page. path is the same canon as goto (path from team domain).
+ *
+ * @version			v.1.0 (05/09/2026)
+ */
+export class typeObjectRepositoryPage extends familyTestAutomation
+{
+	object_repository_page_id;
+	team_id;
+	project_id;
+	object_repository_folder_id;
+	object_repository_page_title;
+	path;
+	created_at;
+	updated_at;
+
+	primary_key = 'object_repository_page_id';
+	api_key     = 'object_repository_page';
+
+	structure_scheme = {
+		object_repository_page_id   : 'integer | require',
+		team_id                     : 'integer | require',
+		project_id                  : 'integer | require',
+		object_repository_folder_id : 'integer | optional',
+		object_repository_page_title: 'string | optional',
+		path                        : 'string | optional',
+		created_at                  : 'timestamp | optional',
+		updated_at                  : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'object_repository_page_title',
+		'object_repository_folder_id',
+		'path',
+	];
+
+	enum_value_translate_matrix = typeObjectRepositoryPage_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeObjectRepositoryPage_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_page_title;
+	}
+}

package/publish/types/family_elements/typeTestCase.js

@@ -17,10 +17,7 @@ export class typeTestCase extends familyTestDocumentation
 	functional_id;					// foreign key
 	test_case_status;
 	test_case_title;				// text 90
-	test_case_preconditions;		// text (взято у рельсов)
-	test_case_mission;				// text (взято у рельсов)
-	test_case_goals;				// text (взято у рельсов)
-	test_case_description;			// text 250
+	test_case_description;			// StringHtml, max 350 (DB)
 	test_case_time_to_execute; 		// время выполнения (в секундах) (оценочное) (для планирования работ)
 	test_case_complexity; 			// enum (для планирования работ)
 	test_case_importance;			// enum (для планирования работ)
@@ -28,7 +25,7 @@ export class typeTestCase extends familyTestDocumentation
 	test_case_presteps;				// pseudo //  foreign key - relations
 	_attachments;					// typeAttachments - <relations>
 	preconditions;					// text
-	excepted_result;				// text // ?? <goals>
+	expected_result;				// text // ?? <goals>
 	created_at;
 	updated_at;
 
@@ -46,10 +43,12 @@ export class typeTestCase extends familyTestDocumentation
 		functional_id            : 'integer | optional',
 		test_case_status         : 'string | enum | require',
 		test_case_title          : 'string | optional',
-		test_case_descriptions   : 'string | StringHtml | optional',
+		test_case_description    : 'string | StringHtml | optional',
 		test_case_time_to_execute: 'integer |  optional',
 		test_case_complexity     : 'string | enum | optional',
 		test_case_importance     : 'string | enum | optional',
+		preconditions            : 'string | StringHtml | optional',
+		expected_result          : 'string | StringHtml | optional',
 		created_at               : 'timestamp | require',
 		updated_at               : 'timestamp | optional',
 	};