complexqa_frontend_core 1.21.2 → 1.21.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.21.2",
+  "version": "1.21.3",
   "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,52 @@
+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);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response, false);
+
+		return {
+			response: typeUtilExecution.composeDetails(response),
+			payload : payload,
+		};
+	}
+}

package/publish/api/util/browser_tools_util_execution_api.js

@@ -4,11 +4,11 @@ import { typeUtilExecution } from "../../types/family_utils/typeUtilExecution.js
 
 
 /**
- * Browser Tools — util executions (screenshot.multi).
+ * Browser Tools — util execution lifecycle (listing, status, delete).
  *
  * Base path: /web_api/util/browser_tools/util_executions
  *
- * @version			v.1.0 (24/06/2026)
+ * @version			v.2.0 (26/06/2026)
  */
 export class BrowserToolsUtilExecutionApi extends ApiAbstractElementClass
 {
@@ -49,35 +49,6 @@ export class BrowserToolsUtilExecutionApi extends ApiAbstractElementClass
 	}
 
 
-	/**
-	 * 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,
-		};
-	}
-
-
 	/**
 	 * GET status/{util_execution_id}?project_id=
 	 *

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

@@ -0,0 +1,42 @@
+import { typeUtilExecution } from '../../../types/family_utils/typeUtilExecution.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 typeUtilExecution();
+	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/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,15 +1,19 @@
 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";
 
 
 /**
- * Параметры и результат 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)
+ * @version			v.2.0 (26/06/2026)
  */
 export class typeUtilExecutionScreenshotMulti extends familyUtil
 {
+	static UTIL_ACTION_ID  = 1;
+	static UTIL_ACTION_KEY = 'screenshot.multi';
+
 	util_execution_id;
 	page_url;
 	wait_until;
@@ -22,10 +26,14 @@ 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',
 		page_url                       : 'string | max:2048 | require',
 		wait_until                     : 'string | enum | optional',
 		full_page                      : 'integer | optional',
@@ -38,6 +46,17 @@ 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 = {
 		capture_matrix_preset: [ 'default', 'custom' ],
 		wait_until           : [ 'load', 'domcontentloaded', 'networkidle', 'commit' ],
@@ -60,7 +79,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 +92,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);
+	}
 }