complexqa_frontend_core 1.24.1 → 1.26.1

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

@@ -0,0 +1,111 @@
+/**
+ * Переводы для typeUtilExecutionUrlInspectCheck.
+ *
+ * @see typeUtilExecutionUrlInspectCheck
+ */
+export const typeUtilExecutionUrlInspectCheck_i18n = {
+	attribute_name_translate_matrix: {
+		en: {
+			url_inspect_check_id: 'Check',
+			util_execution_id   : 'Run',
+			sort_order          : 'Order',
+			check_kind          : 'Kind',
+			check_status        : 'Status',
+			finding_code        : 'Finding',
+			summary_message     : 'Summary',
+			detail_message      : 'Detail',
+		},
+		ru: {
+			url_inspect_check_id: 'Проверка',
+			util_execution_id   : 'Запуск',
+			sort_order          : 'Порядок',
+			check_kind          : 'Вид',
+			check_status        : 'Статус',
+			finding_code        : 'Находка',
+			summary_message     : 'Кратко',
+			detail_message      : 'Подробности',
+		},
+	},
+	enum_value_translate_matrix: {
+		check_kind: {
+			en: {
+				DNS             : 'DNS',
+				TCP_80          : 'TCP 80',
+				TCP_443         : 'TCP 443',
+				TLS             : 'TLS',
+				HTTP            : 'HTTP',
+				HTTPS           : 'HTTPS',
+				SECURITY_HEADERS: 'Security headers',
+				BROWSER         : 'Browser',
+			},
+			ru: {
+				DNS             : 'DNS',
+				TCP_80          : 'TCP 80',
+				TCP_443         : 'TCP 443',
+				TLS             : 'TLS',
+				HTTP            : 'HTTP',
+				HTTPS           : 'HTTPS',
+				SECURITY_HEADERS: 'Заголовки безопасности',
+				BROWSER         : 'Браузер',
+			},
+		},
+		check_status: {
+			en: {
+				PENDING  : 'Pending',
+				QUEUED   : 'Queued',
+				RUNNING  : 'Running',
+				COMPLETED: 'Completed',
+				SKIPPED  : 'Skipped',
+				ERROR    : 'Error',
+			},
+			ru: {
+				PENDING  : 'Ожидает',
+				QUEUED   : 'В очереди',
+				RUNNING  : 'Выполняется',
+				COMPLETED: 'Завершена',
+				SKIPPED  : 'Пропущена',
+				ERROR    : 'Ошибка',
+			},
+		},
+		finding_code: {
+			en: {
+				SUCCESS                     : 'Success',
+				ERR_NAME_NOT_RESOLVED       : 'Name not resolved',
+				ERR_CONNECTION_REFUSED      : 'Connection refused',
+				ERR_CONNECTION_TIMED_OUT    : 'Connection timed out',
+				ERR_CERT_DATE_INVALID       : 'Certificate date invalid',
+				ERR_CERT_AUTHORITY_INVALID  : 'Certificate authority invalid',
+				ERR_CERT_COMMON_NAME_INVALID: 'Certificate name invalid',
+				ERR_SSL_PROTOCOL_ERROR      : 'TLS protocol error',
+				ERR_TOO_MANY_REDIRECTS      : 'Too many redirects',
+				HTTP_STATUS                 : 'HTTP status',
+				NO_TLS                      : 'No TLS',
+				EMPTY_BODY                  : 'Empty body',
+				PROTOTYPE_BROWSER_SKIPPED   : 'Browser skipped (prototype)',
+				NO_PUBLIC_ADDRESS           : 'No public address',
+				UNKNOWN_CHECK_KIND          : 'Unknown check kind',
+				BROWSER_FAILED              : 'Browser failed',
+				BROWSER_SUBMIT_FAILED       : 'Browser submit failed',
+			},
+			ru: {
+				SUCCESS                     : 'Успех',
+				ERR_NAME_NOT_RESOLVED       : 'Имя не резолвится',
+				ERR_CONNECTION_REFUSED      : 'Соединение отклонено',
+				ERR_CONNECTION_TIMED_OUT    : 'Таймаут соединения',
+				ERR_CERT_DATE_INVALID       : 'Срок сертификата недействителен',
+				ERR_CERT_AUTHORITY_INVALID  : 'Центр сертификации не принят',
+				ERR_CERT_COMMON_NAME_INVALID: 'Имя в сертификате не совпадает',
+				ERR_SSL_PROTOCOL_ERROR      : 'Ошибка протокола TLS',
+				ERR_TOO_MANY_REDIRECTS      : 'Слишком много редиректов',
+				HTTP_STATUS                 : 'HTTP-статус',
+				NO_TLS                      : 'Нет TLS',
+				EMPTY_BODY                  : 'Пустое тело',
+				PROTOTYPE_BROWSER_SKIPPED   : 'Браузер пропущен (прототип)',
+				NO_PUBLIC_ADDRESS           : 'Нет публичного адреса',
+				UNKNOWN_CHECK_KIND          : 'Неизвестный вид проверки',
+				BROWSER_FAILED              : 'Ошибка браузера',
+				BROWSER_SUBMIT_FAILED       : 'Не удалось поставить браузер в очередь',
+			},
+		},
+	},
+};

package/publish/types/family_contracts/typeTeamTotalStatistic.js

@@ -2,19 +2,15 @@ import { familyContracts } from "./familyContracts.js";
 import { typeTeamTotalStatistic_i18n } from "../element_translate/typeTeamTotalStatistic.i18n.js";
 
 /**
+ * Translation contract for team total_usage rows
+ * (`element_model` / `util_action_key` labels).
  *
- * @version			v.1.0 (31/03/2026)
+ * API row: { kind, element_model, count, price_limit }
+ *
+ * @version			v.1.1 (14/08/2026)
  */
 export class typeTeamTotalStatistic extends familyContracts
 {
-	project;
-	test_suite;
-	test_case;
-	test_case_step;
-	test_run;
-	team_member;
-
-
 	attribute_name_translate_matrix = typeTeamTotalStatistic_i18n.attribute_name_translate_matrix;
 
-}
+}

package/publish/types/family_elements/typeAttachment.js

@@ -0,0 +1,119 @@
+import { familyGeneralElement } from "../core/0_familyGeneralElement.js";
+import { is_object } from "../../utils/utils.js";
+import _ from 'underscore';
+import { typeAttachment_i18n } from "../element_translate/typeAttachment.i18n.js";
+
+/**
+ * First-class link entity: element ↔ File App file (`file_uuid`).
+ *
+ * Not a family_relation — polymorphic target via `element_type` + `element_id`,
+ * file identity via public `file_uuid` (not File App internal `file_id`).
+ *
+ * @see docs/Attachments/attachment-docs.MD
+ *
+ * @version			v.0.1 (13/08/2026)
+ */
+export class typeAttachment extends familyGeneralElement
+{
+	attachment_id;
+	team_id;
+	project_id;
+	element_type;
+	element_id;
+	file_uuid;
+	caption;
+	sort_order;
+	user_id;
+	created_at;
+	updated_at;
+
+	/** Hydrated via search options.add: ['files'] */
+	file;
+
+	primary_key = 'attachment_id';
+	api_key     = 'attachment';
+
+	structure_scheme = {
+		attachment_id: 'integer | require',
+		team_id      : 'integer | require',
+		project_id   : 'integer | require',
+		element_type : 'string | enum | require',
+		element_id   : 'integer | require',
+		file_uuid    : 'string | require',
+		caption      : 'string | optional',
+		sort_order   : 'integer | optional',
+		user_id      : 'integer | optional',
+		created_at   : 'timestamp | optional',
+		updated_at   : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'element_type',
+		'element_id',
+		'file_uuid',
+		'caption',
+		'sort_order',
+	];
+
+	available_enum_values = {
+		element_type: typeAttachment.get_element_type_values(),
+	};
+
+	enum_value_translate_matrix = typeAttachment_i18n.enum_value_translate_matrix;
+
+	attribute_name_translate_matrix = typeAttachment_i18n.attribute_name_translate_matrix;
+
+
+	/**
+	 * Canonical element_type values (WITHOUT `_id` suffix). MVP: bug only.
+	 *
+	 * @returns {string[]}
+	 */
+	static get_element_type_values()
+	{
+		return [ 'bug' ];
+	}
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 * @returns {typeAttachment}
+	 */
+	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()
+	{
+		if (this.caption)
+		{
+			return String(this.caption);
+		}
+
+		if (this.file_uuid)
+		{
+			return String(this.file_uuid);
+		}
+
+		return String(this.attachment_id ?? '');
+	}
+}

package/publish/types/family_elements/typeTeam.js

@@ -107,9 +107,12 @@ export class typeTeam extends familyGeneralElement
 
 
 	/**
-	 * Return {"project":1,"test_suite":1,"test_case":1,"test_case_step":1,"test_runs":1,"team_member":1}
+	 * Billing catalog usage for the current team.
 	 *
-	 * @version			v.0.1 (21/03/2026)
+	 * Rows: [{ kind, element_model, count, price_limit }, ...]
+	 * kind = entity | util; price_limit null = unlimited.
+	 *
+	 * @version			v.0.2 (14/08/2026)
 	 * @returns {Promise<object>}
 	 */
 	async get_team_total_statistic()

package/publish/types/family_elements/typeTeamDomain.js

@@ -0,0 +1,172 @@
+import { familyGeneralElement } from "../core/0_familyGeneralElement.js";
+import { echo, is_object } from "../../utils/utils.js";
+import { typeTeamDomain_i18n } from "../element_translate/typeTeamDomain.i18n.js";
+
+
+/**
+ * Team-owned domain (cqa_team.team_domains). Shared across projects of the team.
+ * Verify/revoke via ApiService.team_domain; url.inspect requires VERIFIED.
+ * Backend: test_site/docs/team/team-domains.md
+ *
+ * @version			v.0.1 (14/08/2026)
+ */
+export class typeTeamDomain extends familyGeneralElement
+{
+	team_domain_id;
+	team_id;
+	domain_canon;
+	display_name;
+	verification_method;
+	domain_status;
+	verification_token;
+	last_error_message;
+	verified_at;
+	created_at;
+	updated_at;
+	file_url_https;
+	file_url_http;
+	file_body;
+	dns_host;
+	dns_txt_value;
+	instruction;
+
+	primary_key = 'team_domain_id';
+	api_key     = 'team_domain';
+
+	structure_scheme = {
+		team_domain_id     : 'integer | optional',
+		team_id            : 'integer | optional',
+		domain_canon       : 'string | max:255 | require',
+		display_name       : 'string | max:255 | optional',
+		verification_method: 'string | enum | require',
+		domain_status      : 'string | enum | optional',
+		verification_token : 'string | optional',
+		last_error_message : 'string | optional',
+		verified_at        : 'timestamp | optional',
+		created_at         : 'timestamp | optional',
+		updated_at         : 'timestamp | optional',
+		file_url_https     : 'string | optional',
+		file_url_http      : 'string | optional',
+		file_body          : 'string | optional',
+		dns_host           : 'string | optional',
+		dns_txt_value      : 'string | optional',
+		instruction        : 'string | optional',
+	};
+
+	create_scheme = [
+		'domain_canon',
+		'display_name',
+		'verification_method',
+	];
+
+	available_enum_values = {
+		verification_method: [ 'FILE', 'DNS_TXT' ],
+		domain_status      : [ 'PENDING', 'VERIFIED', 'FAILED', 'REVOKED' ],
+	};
+
+	enum_value_translate_matrix = typeTeamDomain_i18n.enum_value_translate_matrix;
+	attribute_name_translate_matrix = typeTeamDomain_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		PENDING : '#4D92FA',
+		VERIFIED: '#009688',
+		FAILED  : '#E66565',
+		REVOKED : '#9E9E9E',
+	};
+
+	clone_element      = false;
+	delete_mass        = false;
+	update_properties  = false;
+	update             = false;
+	clone_element_mass = false;
+
+
+	/**
+	 * @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;
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {object} callback
+	 */
+	verify(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].verify(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 });
+			}
+		});
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {object} callback
+	 */
+	revoke(payload, callback)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].revoke(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_events/familyEvent.js

@@ -58,6 +58,7 @@ export class familyEvent extends familyGeneralElement
 			'task',
 			'bug',
 			'bug_relation',
+			'attachment',
 			'tag',
 			'tag_relation',
 			'test_account',

package/publish/types/family_files/typeFileScreenshot.js

@@ -21,8 +21,8 @@ export class typeFileScreenshot extends typeFile
 	 *
 	 * @param {object} payload
 	 * @param {File|Blob} payload.file
-	 * @param {string} payload.entity_type
-	 * @param {number} payload.entity_id
+	 * @param {string} [payload.entity_type] — omit / null / 0 for unbound upload (attachments)
+	 * @param {number} [payload.entity_id] — omit / null / 0 for unbound upload (attachments)
 	 * @param {string} [payload.original_name]
 	 *
 	 * @returns {Promise<typeFileScreenshot>}

package/publish/types/family_utils/typeUtilExecutionUrlInspect.js

@@ -0,0 +1,199 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+import { typeUtilExecutionUrlInspect_i18n } from "../element_translate/typeUtilExecutionUrlInspect.i18n.js";
+import { typeUtilExecutionUrlInspectCheck } from "./typeUtilExecutionUrlInspectCheck.js";
+import { familyUtil_i18n } from "../element_translate/_familyUtil.i18n.js";
+import { create_type_file_from_wire } from "../family_files/typeFileFactory.js";
+
+
+/**
+ * url.inspect suite — one "Check now" run (family of probes). Always has project_id.
+ * Create/details/search via ApiService.url_inspect, not browser_tools_* APIs.
+ * Backend: test_site/docs/util_service/api-url-inspect.md
+ *
+ * @version			v.0.1 (14/08/2026)
+ */
+export class typeUtilExecutionUrlInspect extends familyUtil
+{
+	util_execution_id;
+	util_action_id;
+	util_action_key;
+	project_id;
+	user_id;
+	team_id;
+	execution_status;
+	error_message;
+	submitted_at;
+	completed_at;
+	created_at;
+	team_domain_id;
+	domain_canon;
+	page_path;
+	suite_status;
+	checks;
+	browser;
+
+	primary_key = 'util_execution_id';
+	api_key     = 'url_inspect';
+
+	structure_scheme = {
+		util_execution_id: 'integer | optional',
+		util_action_id   : 'integer | optional',
+		util_action_key  : 'string | optional',
+		project_id       : 'integer | require',
+		user_id          : 'integer | optional',
+		team_id          : 'integer | optional',
+		execution_status : 'string | enum | optional',
+		error_message    : 'string | optional',
+		submitted_at     : 'timestamp | optional',
+		completed_at     : 'timestamp | optional',
+		created_at       : 'timestamp | optional',
+		team_domain_id   : 'integer | require',
+		domain_canon     : 'string | optional',
+		page_path        : 'string | optional',
+		suite_status     : 'string | enum | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'team_domain_id',
+		'page_path',
+	];
+
+	available_enum_values = {
+		execution_status: familyUtil.get_execution_status_values(),
+		suite_status    : [ 'CREATED', 'QUEUED', 'RUNNING', 'COMPLETED', 'PARTIAL', 'FAILED', 'SUBMIT_FAILED' ],
+	};
+
+	enum_value_translate_matrix = {
+		...typeUtilExecutionUrlInspect_i18n.enum_value_translate_matrix,
+		execution_status: familyUtil_i18n.execution_status,
+	};
+
+	attribute_name_translate_matrix = typeUtilExecutionUrlInspect_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		CREATED      : '#4D92FA',
+		QUEUED       : '#009688',
+		RUNNING      : '#4D92FA',
+		COMPLETED    : '#009688',
+		PARTIAL      : '#F0A202',
+		FAILED       : '#E66565',
+		SUBMIT_FAILED: '#E66565',
+	};
+
+	clone_element      = false;
+	delete_mass        = false;
+	update_properties  = false;
+	update             = false;
+	clone_element_mass = false;
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (key === 'checks' && Array.isArray(value))
+				{
+					this.checks = value.map((row) => new typeUtilExecutionUrlInspectCheck(row));
+				}
+				else if (key === 'browser')
+				{
+					this.browser = typeUtilExecutionUrlInspect.hydrateBrowser(value);
+				}
+				else if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 *
+	 * @returns {typeUtilExecutionUrlInspect|false}
+	 */
+	static composeDetails(data)
+	{
+		if (!data || !is_object(data))
+		{
+			return false;
+		}
+
+		return new typeUtilExecutionUrlInspect(data);
+	}
+
+
+	/**
+	 * @param {object|null|undefined} value
+	 *
+	 * @returns {object|null}
+	 */
+	static hydrateBrowser(value)
+	{
+		if (!value || !is_object(value))
+		{
+			return null;
+		}
+
+		return {
+			...value,
+			screenshot_file: value.screenshot_file
+				? create_type_file_from_wire(value.screenshot_file)
+				: false,
+			har_file: value.har_file
+				? create_type_file_from_wire(value.har_file)
+				: false,
+			console: Array.isArray(value.console) ? value.console : [],
+			mixed_content: Array.isArray(value.mixed_content) ? value.mixed_content : [],
+			screenshots: Array.isArray(value.screenshots)
+				? value.screenshots.map((row) => ({
+					...row,
+					file: row?.file ? create_type_file_from_wire(row.file) : false,
+				}))
+				: [],
+		};
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {Function|false} [callback]
+	 *
+	 * @returns {Promise<*>}
+	 */
+	async details(payload, callback = false)
+	{
+		if (typeof callback?.before === 'function')
+		{
+			callback?.before({ payload });
+		}
+
+		return ApiService[ this.api_key ].details(payload).then((response) =>
+		{
+			if (typeof callback?.success === 'function')
+			{
+				callback?.success({ response, payload });
+			}
+			return response;
+		}).catch((error) =>
+		{
+			if (typeof callback?.error === 'function')
+			{
+				callback?.error({ error, payload });
+			}
+			throw error;
+		});
+	}
+}