complexqa_frontend_core 1.18.6 → 1.19.1

package/package.json

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

package/publish/api/bug_relation_api.js

@@ -0,0 +1,18 @@
+import { ApiAbstractElementClass } from './api_abstract_element_class.js';
+import { typeBugRelation } from '../types/family_relation/typeBugRelation.js';
+
+/**
+ * CRUD / Search для bug_relation.
+ *
+ * @version			v.0.1 (13/06/2026)
+ */
+export class BugRelationApi extends ApiAbstractElementClass
+{
+	module_prefix = 'bug_relation';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeBugRelation);
+	}
+}

package/publish/api/cache/api_search_cache.js

@@ -67,6 +67,32 @@ export function isDefaultSearchPayload(payload)
 }
 
 
+/**
+ * @param {{ response: Promise<*>|*, payload: * }} result
+ * @returns {Promise<{ response: *, payload: * }>}
+ */
+async function materializeSearchResult(result)
+{
+	return {
+		response: await result.response,
+		payload : result.payload,
+	};
+}
+
+
+/**
+ * @param {{ response: *, payload: * }} result
+ * @returns {{ response: Promise<*>, payload: * }}
+ */
+function wrapSearchResult(result)
+{
+	return {
+		response: Promise.resolve(result.response),
+		payload : result.payload,
+	};
+}
+
+
 /**
  * @param {object} apiInstance
  * @param {string} methodName
@@ -100,11 +126,13 @@ export async function resolveCachedSearch(
 
 	if (cached !== undefined)
 	{
-		return Promise.resolve(clone_object(cached));
+		return wrapSearchResult(clone_object(cached));
 	}
 
-	const result = await searchFn(payload);
-	cacheStore.set(cacheKey, clone_object(result), ttlMs);
+	const result       = await searchFn(payload);
+	const materialized = await materializeSearchResult(result);
+
+	cacheStore.set(cacheKey, clone_object(materialized), ttlMs);
 
-	return result;
+	return wrapSearchResult(materialized);
 }

package/publish/api/index.js

@@ -12,6 +12,7 @@ import { UserProfileApi } from "./user_profile_api.js";
 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 { ContextBrowserApi } from "./context/context_browser_api.js";
 import { ContextDeploymentTargetApi } from "./context/context_deployment_target_api.js";
 import { ContextDevicesApi } from "./context/context_devices_api.js";
@@ -154,6 +155,7 @@ export class Api
 		this.task              = new TaskApi(payload);
 		this.test_account      = new TestAccountApi(payload);
 		this.bug               = new BugApi(payload);
+		this.bug_relation      = new BugRelationApi(payload);
 		this.execution_context = new ExecutionContextApi(payload);
 
 		this.reference = this.bootstrap_reference(payload)

package/publish/index.js

@@ -16,6 +16,9 @@ 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 { familyRelation } from './types/core/1_familyRelation.js';
+export { typeBugRelation } from './types/family_relation/typeBugRelation.js';
+
 export { familyContext } from './types/core/1_familyContext.js';
 export { typeBrowserContext } from './types/family_context/typeBrowserContext.js';
 export { typeOsContext } from './types/family_context/typeOsContext.js';

package/publish/types/core/1_familyRelation.js

@@ -0,0 +1,83 @@
+import { familyGeneralElement } from './0_familyGeneralElement.js';
+
+/**
+ * Базовое семейство junction-типов (связи N-к-ко-многим между main elements).
+ *
+ * Каждый наследник описывает свой домен (bug↔TMS, bug↔context, …),
+ * без единого god-type для всех связей.
+ *
+ * @version			v.0.1 (13/06/2026)
+ */
+export class familyRelation extends familyGeneralElement
+{
+	/**
+	 * FK на «главный» элемент связи (у typeBugRelation — bug_id).
+	 *
+	 * @type {string|false}
+	 */
+	source_key = false;
+
+	/**
+	 * Polymorphic target id (обычно element_id).
+	 *
+	 * @type {string}
+	 */
+	target_key = 'element_id';
+
+	/**
+	 * Enum-поле типа цели (relation_type, …).
+	 *
+	 * @type {string}
+	 */
+	relation_type_key = 'relation_type';
+
+
+	constructor(data = false)
+	{
+		super();
+	}
+
+
+	/**
+	 * @returns {string[]}
+	 */
+	static get_relation_type_values()
+	{
+		return [];
+	}
+
+
+	/**
+	 * @returns {Object<string, { type_token: string, primary_key: string, api_key: string }>}
+	 */
+	static get_relation_target_map()
+	{
+		return {};
+	}
+
+
+	/**
+	 * @param {string} relation_type
+	 * @returns {object|false}
+	 */
+	static resolve_relation_target(relation_type)
+	{
+		const map = this.get_relation_target_map();
+
+		return map?.[ relation_type ] || false;
+	}
+
+
+	get_element_name()
+	{
+		const relation_type = this?.[ this.relation_type_key ];
+		const element_id    = this?.[ this.target_key ];
+
+		if (relation_type && element_id)
+		{
+			return `${ relation_type }:${ element_id }`;
+		}
+
+		return String(this?.[ this.get_primary_key() ] ?? '');
+	}
+}

package/publish/types/family_relation/typeBugRelation.js

@@ -0,0 +1,122 @@
+import { is_object } from '../../utils/utils.js';
+import _ from 'underscore';
+import { familyRelation } from '../core/1_familyRelation.js';
+
+/**
+ * Связь бага с сущностью TMS: test case, test run, test run result.
+ *
+ * @see docs/Relations/bug-relation-docs.MD
+ *
+ * @version			v.0.1 (13/06/2026)
+ */
+export class typeBugRelation extends familyRelation
+{
+	bug_relation_id;
+	bug_id;
+	relation_type;
+	element_id;
+
+	source_key        = 'bug_id';
+	target_key        = 'element_id';
+	relation_type_key = 'relation_type';
+
+	primary_key = 'bug_relation_id';
+	api_key     = 'bug_relation';
+
+	static relation_target_map = {
+		test_case_id      : { type_token: 'typeTestCase', primary_key: 'test_case_id', api_key: 'test_case' },
+		test_run_id       : { type_token: 'typeTestRun', primary_key: 'test_run_id', api_key: 'test_run' },
+		test_run_result_id: { type_token: 'typeTestRunResult', primary_key: 'test_run_result_id', api_key: 'test_run_result' },
+	};
+
+	structure_scheme = {
+		bug_relation_id: 'integer | require',
+		bug_id         : 'integer | typeBug | require',
+		relation_type  : 'string | enum | require',
+		element_id     : 'integer | require',
+	};
+
+	create_scheme = [
+		'bug_id',
+		'relation_type',
+		'element_id',
+	];
+
+	available_enum_values = {
+		relation_type: typeBugRelation.get_relation_type_values(),
+	};
+
+	enum_value_translate_matrix = {
+		relation_type: {
+			en: {
+				test_case_id      : 'Test case',
+				test_run_id       : 'Test run',
+				test_run_result_id: 'Test run result',
+			},
+			ru: {
+				test_case_id      : 'Тест-кейс',
+				test_run_id       : 'Прогон',
+				test_run_result_id: 'Результат прогона',
+			},
+		},
+	};
+
+	attribute_name_translate_matrix = {
+		en: {
+			bug_relation_id: 'ID',
+			bug_id         : 'Bug',
+			relation_type  : 'Relation type',
+			element_id     : 'Linked element',
+		},
+		ru: {
+			bug_relation_id: 'ID',
+			bug_id         : 'Баг',
+			relation_type  : 'Тип связи',
+			element_id     : 'Связанный элемент',
+		},
+	};
+
+
+	static get_relation_type_values()
+	{
+		return Object.keys(typeBugRelation.relation_target_map);
+	}
+
+
+	static get_relation_target_map()
+	{
+		return typeBugRelation.relation_target_map;
+	}
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 * @returns {typeBugRelation}
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this[ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	/**
+	 * @returns {object|false}
+	 */
+	get_relation_target_meta()
+	{
+		return typeBugRelation.resolve_relation_target(this.relation_type);
+	}
+}