complexqa_frontend_core 1.24.1 → 1.26.1

package/package.json

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

package/publish/api/attachment_api.js

@@ -0,0 +1,55 @@
+import { ApiAbstractElementClass } from './api_abstract_element_class.js';
+import { typeAttachment } from '../types/family_elements/typeAttachment.js';
+
+/**
+ * CRUD / Search / delete_file для attachment.
+ *
+ * @version			v.0.1 (13/08/2026)
+ */
+export class AttachmentApi extends ApiAbstractElementClass
+{
+	module_prefix = 'attachment';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeAttachment);
+	}
+
+
+	/**
+	 * Delete file in File App and unlink all attachments for that file_uuid.
+	 *
+	 * POST /web_api/attachment/delete_file
+	 *
+	 * @param {object} payload
+	 * @param {string} payload.file_uuid
+	 * @returns {Promise<{response: *, payload: *}>}
+	 */
+	async delete_file(payload)
+	{
+		if (!this.module_prefix)
+		{
+			throw new Error('Error #attachment-delete-file-1152 in AttachmentApi');
+		}
+
+		if (this.stage === 'development')
+		{
+			return {
+				response: payload,
+				payload : payload,
+			};
+		}
+
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/delete_file`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+}

package/publish/api/file_app_api.js

@@ -114,4 +114,26 @@ export class FileAppApi extends ApiAbstractClass
 			payload : payload,
 		};
 	}
+
+
+	/**
+	 * POST /web_api/file_app/delete_file
+	 *
+	 * @param {object} payload
+	 * @param {string} payload.file_uuid
+	 *
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async delete_file(payload)
+	{
+		const url    = `/${ this.api_prefix }/${ this.module_prefix }/delete_file`;
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = await this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
 }

package/publish/api/index.js

@@ -13,6 +13,7 @@ import { TaskApi } from "./task_api.js";
 import { TestAccountApi } from "./test_account_api.js";
 import { BugApi } from "./bug_api.js";
 import { BugRelationApi } from "./bug_relation_api.js";
+import { AttachmentApi } from "./attachment_api.js";
 import { TagApi } from "./tag_api.js";
 import { TagRelationApi } from "./tag_relation_api.js";
 import { TagColorApi } from "./tag/tag_color_api.js";
@@ -26,6 +27,8 @@ 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";
+import { TeamDomainApi } from "./team_domain_api.js";
+import { UrlInspectApi } from "./util/url_inspect_api.js";
 import { TextDocumentApi } from "./text_document_api.js";
 import { PublicTextDocumentApi } from "./public_text_document_api.js";
 import { TextDocumentFolderApi } from "./text_document_folder_api.js";
@@ -170,12 +173,15 @@ export class Api
 		this.test_account                   = new TestAccountApi(payload);
 		this.bug                            = new BugApi(payload);
 		this.bug_relation                   = new BugRelationApi(payload);
+		this.attachment                     = new AttachmentApi(payload);
 		this.tag                            = new TagApi(payload);
 		this.tag_relation                   = new TagRelationApi(payload);
 		this.event                          = new EventApi(payload);
 		this.execution_context              = new ExecutionContextApi(payload);
 		this.browser_tools_util_execution   = new BrowserToolsUtilExecutionApi(payload);
 		this.browser_tools_screenshot_multi = new BrowserToolsScreenshotMultiApi(payload);
+		this.team_domain                    = new TeamDomainApi(payload);
+		this.url_inspect                    = new UrlInspectApi(payload);
 		this.file_app                       = new FileAppApi(payload);
 		this.text_document                  = new TextDocumentApi(payload);
 		this.text_document_folder           = new TextDocumentFolderApi(payload);

package/publish/api/team_domain_api.js

@@ -0,0 +1,62 @@
+import { ApiAbstractElementClass } from "./api_abstract_element_class.js";
+import { typeTeamDomain } from "../types/family_elements/typeTeamDomain.js";
+
+
+/**
+ * Team domain registry — search / create / verify / revoke.
+ *
+ * Base path: /web_api/team_domain
+ *
+ * @version			v.0.1 (14/08/2026)
+ */
+export class TeamDomainApi extends ApiAbstractElementClass
+{
+	module_prefix = 'team_domain';
+
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeTeamDomain);
+	}
+
+
+	/**
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload, response: *}>}
+	 */
+	async verify(payload)
+	{
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/verify`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload, response: *}>}
+	 */
+	async revoke(payload)
+	{
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/revoke`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+}

package/publish/api/team_management_api.js

@@ -49,7 +49,7 @@ export class TeamManagementApi extends ApiAbstractElementClass
 
 		payload      = this.handle_request_payload(payload);
 		let response = this.api_request(url, payload);
-		response     = this.handle_response(response);
+		response     = this.handle_response(response, false);
 
 		return {
 			response: response,

package/publish/api/util/url_inspect_api.js

@@ -0,0 +1,54 @@
+import { ApiAbstractElementClass } from "../api_abstract_element_class.js";
+import { typeUtilExecutionUrlInspect } from "../../types/family_utils/typeUtilExecutionUrlInspect.js";
+
+
+/**
+ * url.inspect suite — create / details / search.
+ *
+ * Base path: /web_api/util/url_inspect
+ *
+ * @version			v.0.1 (14/08/2026)
+ */
+export class UrlInspectApi extends ApiAbstractElementClass
+{
+	module_prefix = 'util/url_inspect';
+
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeUtilExecutionUrlInspect);
+	}
+
+
+	/**
+	 * GET details/{util_execution_id}?project_id=
+	 *
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload, response: ReturnType<typeof typeUtilExecutionUrlInspect.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: typeUtilExecutionUrlInspect.composeDetails(response),
+			payload : payload,
+		};
+	}
+}

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

@@ -4,15 +4,18 @@ import { typeTestRun } from '../../../types/family_elements/typeTestRun.js';
 import { typeBug } from '../../../types/family_elements/typeBug.js';
 import { typeBugRelation } from '../../../types/family_relation/typeBugRelation.js';
 import { typeTag } from '../../../types/family_elements/typeTag.js';
+import { typeAttachment } from '../../../types/family_elements/typeAttachment.js';
 import { typeTagRelation } from '../../../types/family_relation/typeTagRelation.js';
 import { typeTestRunResult } from '../../../types/family_elements/typeTestRunResult.js';
 import { typeTestAccount } from '../../../types/family_elements/typeTestAccount.js';
 import { typeExecutionContext } from '../../../types/family_context/typeExecutionContext.js';
 import { typeTeamMember } from '../../../types/family_elements/typeTeamMember.js';
+import { typeTeamDomain } from '../../../types/family_elements/typeTeamDomain.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';
+import { typeUtilExecutionUrlInspect } from '../../../types/family_utils/typeUtilExecutionUrlInspect.js';
 import { typeTextDocument } from '../../../types/family_files/typeTextDocument.js';
 import { typeEvent } from '../../../types/family_events/typeEvent.js';
 
@@ -33,16 +36,19 @@ export const TABLE_ELEMENT_MODELS = {
 	test_run       : typeTestRun,
 	bug            : typeBug,
 	bug_relation   : typeBugRelation,
+	attachment     : typeAttachment,
 	tag            : typeTag,
 	tag_relation   : typeTagRelation,
 	test_run_result: typeTestRunResult,
 	test_account      : typeTestAccount,
 	execution_context : typeExecutionContext,
 	team_member       : typeTeamMember,
+	team_domain       : typeTeamDomain,
 	test_case_step : typeTestCaseStep,
 	user           : typeUser,
 	team           : typeTeam,
 	text_document  : typeTextDocument,
 	util_execution : typeUtilExecutionScreenshotMulti,
+	util_execution_url_inspect: typeUtilExecutionUrlInspect,
 	event          : typeEvent,
 };

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

@@ -0,0 +1,55 @@
+import { typeTeamDomain } from '../../../types/family_elements/typeTeamDomain.js';
+import { UserService } from '../../../services/UserService.js';
+import {
+	createColumn,
+	createGoToColumn,
+	createPrimaryKeyColumn,
+} from '../helpers/column_factory.js';
+import { createListingFor, registerSection } from '../helpers/section_registry.js';
+
+function build_team_domain_listing_columns(locale)
+{
+	const model = new typeTeamDomain();
+
+	return [
+		createPrimaryKeyColumn(model, locale, { is_hide: true, default_sort: 'desc' }),
+		createColumn(model, locale, 'domain_canon', {
+			width      : '280',
+			is_title   : true,
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createColumn(model, locale, 'display_name', {
+			width      : '200',
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createColumn(model, locale, 'verification_method', {
+			width      : '180',
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createColumn(model, locale, 'domain_status', {
+			width      : '160',
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createGoToColumn(model, locale),
+	];
+}
+
+
+/**
+ * Секция `team_domain`: `listing`.
+ *
+ * @param {Object} config
+ * @returns {void}
+ */
+export function bootstrap_team_domain(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'team_domain', 'listing', build_team_domain_listing_columns(locale), {
+		for: createListingFor([]),
+	});
+}

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

@@ -0,0 +1,60 @@
+import { typeUtilExecutionUrlInspect } from '../../../types/family_utils/typeUtilExecutionUrlInspect.js';
+import { UserService } from '../../../services/UserService.js';
+import {
+	createColumn,
+	createGoToColumn,
+	createPrimaryKeyColumn,
+} from '../helpers/column_factory.js';
+import { createListingFor, registerSection } from '../helpers/section_registry.js';
+
+function build_util_execution_url_inspect_listing_columns(locale)
+{
+	const model = new typeUtilExecutionUrlInspect();
+
+	return [
+		createPrimaryKeyColumn(model, locale, { is_hide: true, default_sort: 'desc' }),
+		createColumn(model, locale, 'domain_canon', {
+			width      : '240',
+			is_title   : true,
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createColumn(model, locale, 'page_path', {
+			width      : '280',
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createColumn(model, locale, 'suite_status', {
+			width      : '160',
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createColumn(model, locale, 'project_id', {
+			width      : '140',
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createColumn(model, locale, 'created_at', {
+			width      : '180',
+			is_filter  : false,
+			is_editable: false,
+		}),
+		createGoToColumn(model, locale),
+	];
+}
+
+
+/**
+ * Секция `util_execution_url_inspect`: `listing`.
+ *
+ * @param {Object} config
+ * @returns {void}
+ */
+export function bootstrap_util_execution_url_inspect(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'util_execution_url_inspect', 'listing', build_util_execution_url_inspect_listing_columns(locale), {
+		for: createListingFor([ 'project_id' ]),
+	});
+}

package/publish/app_configuration/table/table_configuration.js

@@ -10,7 +10,9 @@ 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_util_execution_url_inspect } from './sections/util_execution_url_inspect.js';
 import { bootstrap_team_member } from './sections/team_member.js';
+import { bootstrap_team_domain } from './sections/team_domain.js';
 import { bootstrap_event } from './sections/event.js';
 import { bootstrap_user } from './sections/user.js';
 import { bootstrap_team } from './sections/team.js';
@@ -122,7 +124,9 @@ export class TableConfiguration extends abstractAppConfiguration
 		bootstrap_test_account(this.config);
 		bootstrap_execution_context(this.config);
 		bootstrap_util_execution(this.config);
+		bootstrap_util_execution_url_inspect(this.config);
 		bootstrap_team_member(this.config);
+		bootstrap_team_domain(this.config);
 		bootstrap_event(this.config);
 		bootstrap_user(this.config);
 		bootstrap_team(this.config);

package/publish/index.js

@@ -17,6 +17,7 @@ export { typeTestRunResult } from './types/family_elements/typeTestRunResult.js'
 export { typeTestAccount } from './types/family_elements/typeTestAccount.js'
 export {typeBug} from './types/family_elements/typeBug.js';
 export { typeTag } from './types/family_elements/typeTag.js';
+export { typeAttachment } from './types/family_elements/typeAttachment.js';
 
 export { familyRelation } from './types/core/1_familyRelation.js';
 export { typeBugRelation } from './types/family_relation/typeBugRelation.js';
@@ -37,6 +38,8 @@ export { typeUtilExecutionScreenshotMulti } from './types/family_utils/typeUtilE
 export { typeUtilExecutionScreenshotMultiCapture } from './types/family_utils/typeUtilExecutionScreenshotMultiCapture.js';
 export { typeUtilExecutionScreenshotMultiScreenshot } from './types/family_utils/typeUtilExecutionScreenshotMultiScreenshot.js';
 export { typeUtilExecutionScreenshotMultiCaptureError } from './types/family_utils/typeUtilExecutionScreenshotMultiCaptureError.js';
+export { typeUtilExecutionUrlInspect } from './types/family_utils/typeUtilExecutionUrlInspect.js';
+export { typeUtilExecutionUrlInspectCheck } from './types/family_utils/typeUtilExecutionUrlInspectCheck.js';
 export { typeUtilExecutionEvent } from './types/family_utils/typeUtilExecutionEvent.js';
 
 export { familyEvent } from './types/family_events/familyEvent.js';
@@ -65,6 +68,7 @@ export { text_document_editor_config, get_text_document_editor_config } from './
 export { typeUser } from './types/family_elements/typeUser.js';
 export { typeTeam } from './types/family_elements/typeTeam.js';
 export { typeTeamMember } from './types/family_elements/typeTeamMember.js';
+export { typeTeamDomain } from './types/family_elements/typeTeamDomain.js';
 export { typeTeamTotalStatistic } from './types/family_contracts/typeTeamTotalStatistic.js';
 
 export { typeTask } from './types/family_elements/typeTask.js';

package/publish/services/FileAppService.js

@@ -75,13 +75,53 @@ export class FileAppService extends abstractService
 	}
 
 
+	/**
+	 * Whether entity_type is present for File App binding.
+	 * Empty / null / 0 → omit from token and upload init.
+	 *
+	 * @param {*} value
+	 * @returns {boolean}
+	 */
+	static #has_entity_type(value)
+	{
+		if (value === null || value === undefined)
+		{
+			return false;
+		}
+
+		const s = String(value).trim();
+
+		return s !== '' && s !== '0';
+	}
+
+
+	/**
+	 * Whether entity_id is present for File App binding.
+	 * Empty / null / 0 / NaN → omit from token and upload init.
+	 *
+	 * @param {*} value
+	 * @returns {boolean}
+	 */
+	static #has_entity_id(value)
+	{
+		if (value === null || value === undefined || value === '')
+		{
+			return false;
+		}
+
+		const n = Number(value);
+
+		return !Number.isNaN(n) && n !== 0;
+	}
+
+
 	/**
 	 * Upload browser File/Blob to File App (token via Main App bridge).
 	 *
 	 * @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.category
 	 * @param {string} [payload.original_name]
 	 * @param {string} [payload.file_uuid] — re-upload / new version for existing file
@@ -97,20 +137,24 @@ export class FileAppService extends abstractService
 			throw new Error('FileAppService.upload_file: file is required');
 		}
 
-		const entity_type   = String(payload.entity_type || '');
-		const entity_id     = Number(payload.entity_id);
-		const category      = String(payload.category || '');
-		const mime_type     = file.type || 'application/octet-stream';
-		const size_bytes    = Number(file.size || 0);
-		const original_name = String(payload.original_name || file.name || 'upload');
-		const api           = FileAppService.#get_api_service();
-
-		const token_wrap = await api.file_app.issue_access_token({
-			scopes     : [ 'file:upload', 'file:read' ],
-			entity_type,
-			entity_id,
+		const has_entity_type = FileAppService.#has_entity_type(payload.entity_type);
+		const has_entity_id   = FileAppService.#has_entity_id(payload.entity_id);
+		const entity_type     = has_entity_type ? String(payload.entity_type) : undefined;
+		const entity_id       = has_entity_id ? Number(payload.entity_id) : undefined;
+		const category        = String(payload.category || '');
+		const mime_type       = file.type || 'application/octet-stream';
+		const size_bytes      = Number(file.size || 0);
+		const original_name   = String(payload.original_name || file.name || 'upload');
+		const api             = FileAppService.#get_api_service();
+
+		const token_payload = {
+			scopes: [ 'file:upload', 'file:read' ],
 			size_bytes,
-		});
+			...(has_entity_type ? { entity_type } : {}),
+			...(has_entity_id ? { entity_id } : {}),
+		};
+
+		const token_wrap = await api.file_app.issue_access_token(token_payload);
 
 		const token_data = await token_wrap?.response;
 
@@ -130,15 +174,17 @@ export class FileAppService extends abstractService
 			throw new ApiException({ message: 'File App access token was not issued' });
 		}
 
-		const init_response = await axios.post(`${ file_app_url }/api/v1/uploads`, {
+		const init_payload = {
 			category,
 			mime_type,
 			size_bytes,
 			original_name,
-			entity_type,
-			entity_id,
+			...(has_entity_type ? { entity_type } : {}),
+			...(has_entity_id ? { entity_id } : {}),
 			...(payload.file_uuid ? { file_uuid: String(payload.file_uuid) } : {}),
-		}, {
+		};
+
+		const init_response = await axios.post(`${ file_app_url }/api/v1/uploads`, init_payload, {
 			headers: {
 				Authorization: `Bearer ${ access_token }`,
 				Accept       : 'application/json',
@@ -183,8 +229,8 @@ export class FileAppService extends abstractService
 		const wire = {
 			...confirmed,
 			category   : confirmed.category || category,
-			entity_type: confirmed.entity_type || entity_type,
-			entity_id  : confirmed.entity_id ?? entity_id,
+			entity_type: confirmed.entity_type ?? entity_type ?? null,
+			entity_id  : confirmed.entity_id ?? entity_id ?? null,
 			mime_type  : confirmed.mime_type || mime_type,
 		};