complexqa_frontend_core 1.21.2 → 1.21.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.21.2",
+  "version": "1.21.4",
   "description": "core of web ",
   "type": "module",
   "exports": {

package/publish/api/index.js

@@ -21,6 +21,7 @@ import { ContextLocaleApi } from "./context/context_locale_api.js";
 import { ContextOsApi } from "./context/context_os_api.js";
 import { ContextScreenResolutionApi } from "./context/context_screen_resolution_api.js";
 import { BrowserToolsUtilExecutionApi } from "./util/browser_tools_util_execution_api.js";
+import { BrowserToolsScreenshotMultiApi } from "./util/browser_tools_screenshot_multi_api.js";
 
 /**
  * Обертка над axios
@@ -158,7 +159,8 @@ export class Api
 		this.bug                          = new BugApi(payload);
 		this.bug_relation                 = new BugRelationApi(payload);
 		this.execution_context            = new ExecutionContextApi(payload);
-		this.browser_tools_util_execution = new BrowserToolsUtilExecutionApi(payload);
+		this.browser_tools_util_execution  = new BrowserToolsUtilExecutionApi(payload);
+		this.browser_tools_screenshot_multi = new BrowserToolsScreenshotMultiApi(payload);
 
 		this.reference = this.bootstrap_reference(payload)
 	}

package/publish/api/util/browser_tools_screenshot_multi_api.js

@@ -0,0 +1,55 @@
+import { ApiAbstractElementClass } from "../api_abstract_element_class.js";
+import { typeUtilExecutionScreenshotMulti } from "../../types/family_utils/typeUtilExecutionScreenshotMulti.js";
+import { typeUtilExecution } from "../../types/family_utils/typeUtilExecution.js";
+
+
+/**
+ * Browser Tools — screenshot.multi util execution (create / details).
+ *
+ * Base path: /web_api/util/browser_tools/util_executions/screenshot.multi
+ *
+ * @version			v.2.0 (26/06/2026)
+ */
+export class BrowserToolsScreenshotMultiApi extends ApiAbstractElementClass
+{
+	module_prefix = 'util/browser_tools/util_executions/screenshot.multi';
+
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeUtilExecutionScreenshotMulti);
+	}
+
+
+	/**
+	 * GET details/{util_execution_id}?project_id=
+	 *
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload, response: ReturnType<typeof typeUtilExecution.composeDetails>|false}>}
+	 */
+	async details(payload)
+	{
+		let util_execution_id = payload?.util_execution_id;
+
+		if (!util_execution_id)
+		{
+			throw new Error('util_execution_id is required for details');
+		}
+
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/details/${ util_execution_id }`;
+
+		payload      = this.handle_request_payload(payload);
+		const prev_method = this.method;
+		this.method       = 'get';
+		let response      = this.api_request(url, payload, 'GET');
+		this.method       = prev_method;
+		response          = await this.handle_response(response, false);
+
+		return {
+			response: typeUtilExecution.composeDetails(response),
+			payload : payload,
+		};
+	}
+}

package/publish/api/util/browser_tools_util_execution_api.js

@@ -1,14 +1,16 @@
 import { ApiAbstractElementClass } from "../api_abstract_element_class.js";
-import { is_array } from "../../utils/utils.js";
 import { typeUtilExecution } from "../../types/family_utils/typeUtilExecution.js";
+import { typeUtilExecutionScreenshotMulti } from "../../types/family_utils/typeUtilExecutionScreenshotMulti.js";
 
 
 /**
- * Browser Tools — util executions (screenshot.multi).
+ * Browser Tools — util execution lifecycle (search, status, delete).
  *
  * Base path: /web_api/util/browser_tools/util_executions
  *
- * @version			v.1.0 (24/06/2026)
+ * Search rows — typeUtilExecutionScreenshotMulti (inherited search()).
+ *
+ * @version			v.2.1 (28/06/2026)
  */
 export class BrowserToolsUtilExecutionApi extends ApiAbstractElementClass
 {
@@ -18,63 +20,7 @@ export class BrowserToolsUtilExecutionApi extends ApiAbstractElementClass
 	constructor(options)
 	{
 		super(options);
-		this.set_element_class_instance(typeUtilExecution);
-	}
-
-
-	/**
-	 * GET listing?project_id=
-	 *
-	 * @param {object} payload
-	 *
-	 * @returns {Promise<{payload, response: object}>}
-	 */
-	async listing(payload)
-	{
-		let url = `/${ this.api_prefix }/${ this.module_prefix }/listing`;
-
-		payload      = this.handle_request_payload(payload);
-		let response = this.api_request(url, payload);
-		response     = this.handle_response(response, false);
-
-		if (response?.items && is_array(response.items))
-		{
-			response.items = response.items.map((row) => new typeUtilExecution(row));
-		}
-
-		return {
-			response: response,
-			payload : payload,
-		};
-	}
-
-
-	/**
-	 * GET details/{util_execution_id}?project_id=
-	 *
-	 * @param {object} payload
-	 *
-	 * @returns {Promise<{payload, response: typeUtilExecution|false}>}
-	 */
-	async details(payload)
-	{
-		let util_execution_id = payload?.util_execution_id;
-
-		if (!util_execution_id)
-		{
-			throw new Error('util_execution_id is required for details');
-		}
-
-		let url = `/${ this.api_prefix }/${ this.module_prefix }/details/${ util_execution_id }`;
-
-		payload      = this.handle_request_payload(payload);
-		let response = this.api_request(url, payload);
-		response     = this.handle_response(response, false);
-
-		return {
-			response: typeUtilExecution.hydrateDetails(response),
-			payload : payload,
-		};
+		this.set_element_class_instance(typeUtilExecutionScreenshotMulti);
 	}
 
 
@@ -96,9 +42,12 @@ export class BrowserToolsUtilExecutionApi extends ApiAbstractElementClass
 
 		let url = `/${ this.api_prefix }/${ this.module_prefix }/status/${ util_execution_id }`;
 
-		payload      = this.handle_request_payload(payload);
-		let response = this.api_request(url, payload);
-		response     = this.handle_response(response, false);
+		payload           = this.handle_request_payload(payload);
+		const prev_method = this.method;
+		this.method       = 'get';
+		let response      = this.api_request(url, payload, 'GET');
+		this.method       = prev_method;
+		response          = await this.handle_response(response, false);
 
 		return {
 			response: new typeUtilExecution(response),

package/publish/app_configuration/table/helpers/table_element_models.js

@@ -10,6 +10,7 @@ import { typeTeamMember } from '../../../types/family_elements/typeTeamMember.js
 import { typeTestCaseStep } from '../../../types/family_elements/typeTestCaseStep.js';
 import { typeUser } from '../../../types/family_elements/typeUser.js';
 import { typeTeam } from '../../../types/family_elements/typeTeam.js';
+import { typeUtilExecutionScreenshotMulti } from '../../../types/family_utils/typeUtilExecutionScreenshotMulti.js';
 
 /**
  * Реестр классов моделей по ключу `element_type`.
@@ -35,4 +36,5 @@ export const TABLE_ELEMENT_MODELS = {
 	test_case_step : typeTestCaseStep,
 	user           : typeUser,
 	team           : typeTeam,
+	util_execution : typeUtilExecutionScreenshotMulti,
 };

package/publish/app_configuration/table/sections/util_execution.js

@@ -0,0 +1,42 @@
+import { typeUtilExecutionScreenshotMulti } from '../../../types/family_utils/typeUtilExecutionScreenshotMulti.js';
+import { UserService } from '../../../services/UserService.js';
+import { createColumn, createGoToColumn, createPrimaryKeyColumn, createRowSelectColumn } from '../helpers/column_factory.js';
+import { createListingFor, registerSection } from '../helpers/section_registry.js';
+
+function build_util_execution_listing_columns(locale, { include_select = true } = {})
+{
+	const model = new typeUtilExecutionScreenshotMulti();
+	const columns = [];
+
+	if (include_select)
+	{
+		columns.push(createRowSelectColumn());
+	}
+
+	columns.push(createPrimaryKeyColumn(model, locale, { is_editable: false }));
+	columns.push(createColumn(model, locale, 'execution_status', { width: '150', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'page_url', { width: '360', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'screenshot_count', { width: '120', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'user_id', { width: '180', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'created_at', { width: '170', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'completed_at', { width: '170', is_editable: false, is_required: true }));
+	columns.push(createGoToColumn(model, locale));
+
+	return columns;
+}
+
+
+/**
+ * Секции `util_execution`: `listing`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
+export function bootstrap_util_execution(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'util_execution', 'listing', build_util_execution_listing_columns(locale), {
+		for: createListingFor([ 'project_id' ]),
+	});
+}

package/publish/app_configuration/table/table_configuration.js

@@ -7,6 +7,7 @@ import { bootstrap_test_run } from './sections/test_run.js';
 import { bootstrap_test_run_result } from './sections/test_run_result.js';
 import { bootstrap_test_account } from './sections/test_account.js';
 import { bootstrap_execution_context } from './sections/execution_context.js';
+import { bootstrap_util_execution } from './sections/util_execution.js';
 import { bootstrap_team_member } from './sections/team_member.js';
 import { bootstrap_user } from './sections/user.js';
 import { bootstrap_team } from './sections/team.js';
@@ -114,6 +115,7 @@ export class TableConfiguration extends abstractAppConfiguration
 		bootstrap_test_run_result(this.config);
 		bootstrap_test_account(this.config);
 		bootstrap_execution_context(this.config);
+		bootstrap_util_execution(this.config);
 		bootstrap_team_member(this.config);
 		bootstrap_user(this.config);
 		bootstrap_team(this.config);

package/publish/types/element_translate/typeUtilExecution.i18n.js

@@ -9,6 +9,8 @@ export const typeUtilExecution_i18n = {
 	attribute_name_translate_matrix: {
 		en: {
 			util_execution_id : 'ID',
+			util_action_id    : 'Action ID',
+			util_action_key   : 'Action',
 			team_id           : 'Team',
 			project_id        : 'Project',
 			user_id           : 'User',
@@ -26,6 +28,8 @@ export const typeUtilExecution_i18n = {
 		},
 		ru: {
 			util_execution_id : 'ID',
+			util_action_id    : 'ID действия',
+			util_action_key   : 'Действие',
 			team_id           : 'Команда',
 			project_id        : 'Проект',
 			user_id           : 'Пользователь',

package/publish/types/element_translate/typeUtilExecutionScreenshotMulti.i18n.js

@@ -9,6 +9,17 @@ export const typeUtilExecutionScreenshotMulti_i18n = {
 	attribute_name_translate_matrix: {
 		en: {
 			util_execution_id              : 'Execution',
+			util_action_id                 : 'Action ID',
+			util_action_key                : 'Action',
+			project_id                     : 'Project',
+			user_id                        : 'User',
+			execution_status               : 'Status',
+			external_job_id                : 'External job',
+			error_message                  : 'Error',
+			submitted_at                   : 'Submitted at',
+			completed_at                   : 'Completed at',
+			created_at                     : 'Created at',
+			screenshot_count               : 'Screenshots',
 			page_url                       : 'Page URL',
 			wait_until                     : 'Wait until',
 			full_page                      : 'Full page',
@@ -22,6 +33,17 @@ export const typeUtilExecutionScreenshotMulti_i18n = {
 		},
 		ru: {
 			util_execution_id              : 'Запуск',
+			util_action_id                 : 'ID действия',
+			util_action_key                : 'Действие',
+			project_id                     : 'Проект',
+			user_id                        : 'Пользователь',
+			execution_status               : 'Статус',
+			external_job_id                : 'Внешняя задача',
+			error_message                  : 'Ошибка',
+			submitted_at                   : 'Отправлено',
+			completed_at                   : 'Завершено',
+			created_at                     : 'Создано',
+			screenshot_count               : 'Скриншоты',
 			page_url                       : 'URL страницы',
 			wait_until                     : 'Ожидание загрузки',
 			full_page                      : 'Полная страница',

package/publish/types/family_utils/typeUtilExecution.js

@@ -9,15 +9,19 @@ import { typeUtilExecutionEvent } from "./typeUtilExecutionEvent.js";
 
 
 /**
- * Корневая сущность util execution (Browser Tools screenshot.multi и др.).
+ * Корневая сущность util execution (lifecycle, listing, status, delete).
+ *
+ * Create / action payload — через typeUtilExecutionScreenshotMulti.
  *
  * @see docs/Utils Layer/browser-tools-util-execution-docs.MD
  *
- * @version			v.1.0 (24/06/2026)
+ * @version			v.2.0 (26/06/2026)
  */
 export class typeUtilExecution extends familyUtil
 {
 	util_execution_id;
+	util_action_id;
+	util_action_key;
 	team_id;
 	project_id;
 	user_id;
@@ -30,7 +34,7 @@ export class typeUtilExecution extends familyUtil
 	completed_at;
 	created_at;
 
-	/** Поля listing (денормализация) */
+	/** Поля listing (денормализация screenshot.multi) */
 	page_url;
 	screenshot_count;
 
@@ -39,18 +43,13 @@ export class typeUtilExecution extends familyUtil
 	captures_succeeded;
 	captures_failed;
 
-	/** Вложенные данные GET details */
-	screenshot_multi;
-	captures;
-	screenshots;
-	capture_errors;
-	events;
-
 	primary_key = 'util_execution_id';
 	api_key     = 'browser_tools_util_execution';
 
 	structure_scheme = {
 		util_execution_id : 'integer | require',
+		util_action_id    : 'integer | optional',
+		util_action_key   : 'string | max:120 | optional',
 		team_id           : 'integer | optional',
 		project_id        : 'integer | require',
 		user_id           : 'integer | optional',
@@ -67,16 +66,6 @@ export class typeUtilExecution extends familyUtil
 		captures_failed   : 'integer | optional',
 	};
 
-	create_scheme = [
-		'project_id',
-		'page_url',
-		'capture_matrix_preset',
-		'captures',
-		'wait_until',
-		'full_page',
-		'navigation_timeout_milliseconds',
-	];
-
 	available_enum_values = {
 		execution_status: familyUtil.get_execution_status_values(),
 	};
@@ -105,27 +94,7 @@ export class typeUtilExecution extends familyUtil
 		{
 			_.mapObject(data, (value, key) =>
 			{
-				if (key === 'screenshot_multi' && value && is_object(value))
-				{
-					this.screenshot_multi = new typeUtilExecutionScreenshotMulti(value);
-				}
-				else if (key === 'captures' && Array.isArray(value))
-				{
-					this.captures = value.map((row) => new typeUtilExecutionScreenshotMultiCapture(row));
-				}
-				else if (key === 'screenshots' && Array.isArray(value))
-				{
-					this.screenshots = value.map((row) => new typeUtilExecutionScreenshotMultiScreenshot(row));
-				}
-				else if (key === 'capture_errors' && Array.isArray(value))
-				{
-					this.capture_errors = value.map((row) => new typeUtilExecutionScreenshotMultiCaptureError(row));
-				}
-				else if (key === 'events' && Array.isArray(value))
-				{
-					this.events = value.map((row) => new typeUtilExecutionEvent(row));
-				}
-				else if (this.hasOwnProperty(key))
+				if (this.hasOwnProperty(key))
 				{
 					this [ key ] = value;
 				}
@@ -137,17 +106,43 @@ export class typeUtilExecution extends familyUtil
 
 
 	/**
+	 * Compose lifecycle root + screenshot.multi payload (GET details wire).
+	 *
 	 * @param {object|false|undefined} data
 	 *
-	 * @returns {typeUtilExecution|false}
+	 * @returns {{
+	 *   execution: typeUtilExecution,
+	 *   screenshot_multi: typeUtilExecutionScreenshotMulti|null,
+	 *   captures: typeUtilExecutionScreenshotMultiCapture[],
+	 *   screenshots: typeUtilExecutionScreenshotMultiScreenshot[],
+	 *   capture_errors: typeUtilExecutionScreenshotMultiCaptureError[],
+	 *   events: typeUtilExecutionEvent[],
+	 * }|false}
 	 */
-	static hydrateDetails(data)
+	static composeDetails(data)
 	{
 		if (!data || !is_object(data))
 		{
 			return false;
 		}
 
-		return new typeUtilExecution(data);
+		return {
+			execution       : new typeUtilExecution(data),
+			screenshot_multi: data.screenshot_multi && is_object(data.screenshot_multi)
+				? new typeUtilExecutionScreenshotMulti(data.screenshot_multi)
+				: null,
+			captures        : Array.isArray(data.captures)
+				? data.captures.map((row) => new typeUtilExecutionScreenshotMultiCapture(row))
+				: [],
+			screenshots     : Array.isArray(data.screenshots)
+				? data.screenshots.map((row) => new typeUtilExecutionScreenshotMultiScreenshot(row))
+				: [],
+			capture_errors  : Array.isArray(data.capture_errors)
+				? data.capture_errors.map((row) => new typeUtilExecutionScreenshotMultiCaptureError(row))
+				: [],
+			events          : Array.isArray(data.events)
+				? data.events.map((row) => new typeUtilExecutionEvent(row))
+				: [],
+		};
 	}
 }

package/publish/types/family_utils/typeUtilExecutionScreenshotMulti.js

@@ -1,16 +1,35 @@
 import { familyUtil } from "./familyUtil.js";
 import { is_object } from "../../utils/utils.js";
 import { typeUtilExecutionScreenshotMulti_i18n } from "../element_translate/typeUtilExecutionScreenshotMulti.i18n.js";
+import { typeUtilExecutionScreenshotMultiCapture } from "./typeUtilExecutionScreenshotMultiCapture.js";
+import { familyUtil_i18n } from "../element_translate/_familyUtil.i18n.js";
 
 
 /**
- * Параметры и результат action screenshot.multi (1:1 к util_execution).
+ * Action screenshot.multi — entry point для create и typed payload (1:1 к util_execution).
  *
- * @version			v.1.0 (24/06/2026)
+ * Listing row = lifecycle + action fields (flat wire для таблицы).
+ *
+ * @version			v.2.1 (28/06/2026)
  */
 export class typeUtilExecutionScreenshotMulti extends familyUtil
 {
+	static UTIL_ACTION_ID  = 1;
+	static UTIL_ACTION_KEY = 'screenshot.multi';
+
 	util_execution_id;
+	util_action_id;
+	util_action_key;
+	project_id;
+	user_id;
+	execution_status;
+	external_job_id;
+	error_message;
+	submitted_at;
+	completed_at;
+	created_at;
+	screenshot_count;
+
 	page_url;
 	wait_until;
 	full_page;
@@ -22,10 +41,25 @@ export class typeUtilExecutionScreenshotMulti extends familyUtil
 	captures_failed;
 	duration_milliseconds;
 
+	/** Input matrix rows (create custom / details) */
+	captures;
+
 	primary_key = 'util_execution_id';
+	api_key     = 'browser_tools_screenshot_multi';
 
 	structure_scheme = {
-		util_execution_id              : 'integer | require',
+		util_execution_id              : 'integer | optional',
+		util_action_id                 : 'integer | optional',
+		util_action_key                : 'string | max:120 | optional',
+		project_id                     : 'integer | optional',
+		user_id                        : 'integer | optional',
+		execution_status               : 'string | enum | optional',
+		external_job_id                : 'string | max:120 | optional',
+		error_message                  : 'string | optional',
+		submitted_at                   : 'timestamp | optional',
+		completed_at                   : 'timestamp | optional',
+		created_at                     : 'timestamp | optional',
+		screenshot_count               : 'integer | optional',
 		page_url                       : 'string | max:2048 | require',
 		wait_until                     : 'string | enum | optional',
 		full_page                      : 'integer | optional',
@@ -38,16 +72,39 @@ export class typeUtilExecutionScreenshotMulti extends familyUtil
 		duration_milliseconds          : 'integer | optional',
 	};
 
+	create_scheme = [
+		'util_action_id',
+		'project_id',
+		'page_url',
+		'capture_matrix_preset',
+		'captures',
+		'wait_until',
+		'full_page',
+		'navigation_timeout_milliseconds',
+	];
+
 	available_enum_values = {
+		execution_status     : familyUtil.get_execution_status_values(),
 		capture_matrix_preset: [ 'default', 'custom' ],
 		wait_until           : [ 'load', 'domcontentloaded', 'networkidle', 'commit' ],
 		last_callback_status : [ 'completed', 'failed' ],
 	};
 
-	enum_value_translate_matrix = typeUtilExecutionScreenshotMulti_i18n.enum_value_translate_matrix;
+	enum_value_translate_matrix = {
+		...typeUtilExecutionScreenshotMulti_i18n.enum_value_translate_matrix,
+		execution_status: familyUtil_i18n.execution_status,
+	};
 
 	attribute_name_translate_matrix = typeUtilExecutionScreenshotMulti_i18n.attribute_name_translate_matrix;
 
+	status_color = {
+		pending      : '#4D92FA',
+		submit_failed: '#E66565',
+		queued       : '#009688',
+		completed    : '#009688',
+		failed       : '#E66565',
+	};
+
 
 	/**
 	 * @param {object|false|undefined} data
@@ -60,7 +117,11 @@ export class typeUtilExecutionScreenshotMulti extends familyUtil
 		{
 			_.mapObject(data, (value, key) =>
 			{
-				if (this.hasOwnProperty(key))
+				if (key === 'captures' && Array.isArray(value))
+				{
+					this.captures = value.map((row) => new typeUtilExecutionScreenshotMultiCapture(row));
+				}
+				else if (this.hasOwnProperty(key))
 				{
 					this [ key ] = value;
 				}
@@ -69,4 +130,30 @@ export class typeUtilExecutionScreenshotMulti extends familyUtil
 
 		return this;
 	}
+
+
+	/**
+	 * @param {object} payload
+	 *
+	 * @returns {object}
+	 */
+	static withDefaultActionId(payload = {})
+	{
+		return {
+			util_action_id: typeUtilExecutionScreenshotMulti.UTIL_ACTION_ID,
+			...payload,
+		};
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {Function|false} [callback]
+	 *
+	 * @returns {Promise<*>}
+	 */
+	async create(payload, callback = false)
+	{
+		return super.create(typeUtilExecutionScreenshotMulti.withDefaultActionId(payload), callback);
+	}
 }