complexqa_frontend_core 1.24.1 → 1.25.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.24.1",
+  "version": "1.25.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";
@@ -170,6 +171,7 @@ 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);

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

@@ -4,6 +4,7 @@ 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';
@@ -33,6 +34,7 @@ export const TABLE_ELEMENT_MODELS = {
 	test_run       : typeTestRun,
 	bug            : typeBug,
 	bug_relation   : typeBugRelation,
+	attachment     : typeAttachment,
 	tag            : typeTag,
 	tag_relation   : typeTagRelation,
 	test_run_result: typeTestRunResult,

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';

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

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

@@ -0,0 +1,201 @@
+/**
+ * Переводы для typeAttachment.
+ *
+ * @see typeAttachment
+ */
+export const typeAttachment_i18n = {
+	attribute_name_translate_matrix: {
+		en: {
+			attachment_id: 'ID',
+			team_id: 'Team',
+			project_id: 'Project',
+			element_type: 'Element type',
+			element_id: 'Element',
+			file_uuid: 'File',
+			caption: 'Caption',
+			sort_order: 'Sort order',
+			user_id: 'User',
+			created_at: 'Created',
+			updated_at: 'Updated',
+			file: 'File',
+		},
+		ru: {
+			attachment_id: 'ID',
+			team_id: 'Команда',
+			project_id: 'Проект',
+			element_type: 'Тип элемента',
+			element_id: 'Элемент',
+			file_uuid: 'Файл',
+			caption: 'Подпись',
+			sort_order: 'Порядок',
+			user_id: 'Пользователь',
+			created_at: 'Создан',
+			updated_at: 'Обновлён',
+			file: 'Файл',
+		},
+		de: {
+			attachment_id: 'ID',
+			team_id: 'Team',
+			project_id: 'Projekt',
+			element_type: 'Elementtyp',
+			element_id: 'Element',
+			file_uuid: 'Datei',
+			caption: 'Beschriftung',
+			sort_order: 'Sortierung',
+			user_id: 'Benutzer',
+			created_at: 'Erstellt',
+			updated_at: 'Aktualisiert',
+			file: 'Datei',
+		},
+		ar: {
+			attachment_id: 'ID',
+			team_id: 'الفريق',
+			project_id: 'المشروع',
+			element_type: 'نوع العنصر',
+			element_id: 'العنصر',
+			file_uuid: 'الملف',
+			caption: 'التسمية',
+			sort_order: 'ترتيب الفرز',
+			user_id: 'المستخدم',
+			created_at: 'تاريخ الإنشاء',
+			updated_at: 'تاريخ التحديث',
+			file: 'الملف',
+		},
+		es: {
+			attachment_id: 'ID',
+			team_id: 'Equipo',
+			project_id: 'Proyecto',
+			element_type: 'Tipo de elemento',
+			element_id: 'Elemento',
+			file_uuid: 'Archivo',
+			caption: 'Leyenda',
+			sort_order: 'Orden',
+			user_id: 'Usuario',
+			created_at: 'Creado',
+			updated_at: 'Actualizado',
+			file: 'Archivo',
+		},
+		fr: {
+			attachment_id: 'ID',
+			team_id: 'Équipe',
+			project_id: 'Projet',
+			element_type: 'Type d\'élément',
+			element_id: 'Élément',
+			file_uuid: 'Fichier',
+			caption: 'Légende',
+			sort_order: 'Ordre',
+			user_id: 'Utilisateur',
+			created_at: 'Créé',
+			updated_at: 'Mis à jour',
+			file: 'Fichier',
+		},
+		hy: {
+			attachment_id: 'ID',
+			team_id: 'Թիմ',
+			project_id: 'Նախագիծ',
+			element_type: 'Էլեմենտի տեսակ',
+			element_id: 'Էլեմենտ',
+			file_uuid: 'Ֆայլ',
+			caption: 'Ստորագրություն',
+			sort_order: 'Դասավորություն',
+			user_id: 'Օգտատեր',
+			created_at: 'Ստեղծված',
+			updated_at: 'Թարմացված',
+			file: 'Ֆայլ',
+		},
+		it: {
+			attachment_id: 'ID',
+			team_id: 'Team',
+			project_id: 'Progetto',
+			element_type: 'Tipo di elemento',
+			element_id: 'Elemento',
+			file_uuid: 'File',
+			caption: 'Didascalia',
+			sort_order: 'Ordine',
+			user_id: 'Utente',
+			created_at: 'Creato',
+			updated_at: 'Aggiornato',
+			file: 'File',
+		},
+		pl: {
+			attachment_id: 'ID',
+			team_id: 'Zespół',
+			project_id: 'Projekt',
+			element_type: 'Typ elementu',
+			element_id: 'Element',
+			file_uuid: 'Plik',
+			caption: 'Podpis',
+			sort_order: 'Kolejność',
+			user_id: 'Użytkownik',
+			created_at: 'Utworzono',
+			updated_at: 'Zaktualizowano',
+			file: 'Plik',
+		},
+		pt: {
+			attachment_id: 'ID',
+			team_id: 'Equipe',
+			project_id: 'Projeto',
+			element_type: 'Tipo de elemento',
+			element_id: 'Elemento',
+			file_uuid: 'Arquivo',
+			caption: 'Legenda',
+			sort_order: 'Ordem',
+			user_id: 'Usuário',
+			created_at: 'Criado',
+			updated_at: 'Atualizado',
+			file: 'Arquivo',
+		},
+		tt: {
+			attachment_id: 'ID',
+			team_id: 'Команда',
+			project_id: 'Проект',
+			element_type: 'Элемент тибы',
+			element_id: 'Элемент',
+			file_uuid: 'Файл',
+			caption: 'Язма',
+			sort_order: 'Тәртип',
+			user_id: 'Кулланучы',
+			created_at: 'Ясалган',
+			updated_at: 'Яңартылган',
+			file: 'Файл',
+		},
+	},
+
+	enum_value_translate_matrix: {
+		element_type: {
+			en: {
+				bug: 'Bug',
+			},
+			ru: {
+				bug: 'Баг',
+			},
+			de: {
+				bug: 'Fehler',
+			},
+			ar: {
+				bug: 'الخلل',
+			},
+			es: {
+				bug: 'Defecto',
+			},
+			fr: {
+				bug: 'Anomalie',
+			},
+			hy: {
+				bug: 'Խաուխ',
+			},
+			it: {
+				bug: 'Difetto',
+			},
+			pl: {
+				bug: 'Błąd',
+			},
+			pt: {
+				bug: 'Defeito',
+			},
+			tt: {
+				bug: 'Хата',
+			},
+		},
+	},
+};

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_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>}