complexqa_frontend_core 1.21.8 → 1.22.1

package/package.json

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

package/publish/api/api_abstract_class.js

@@ -199,7 +199,7 @@ export class ApiAbstractClass
 			url    : url
 		};
 
-		if (this.method === 'get')
+		if (method === 'get' || method === 'GET')
 		{
 			request_options.paramsSerializer = this.object_to_string;
 			request_options.params           = request_params;

package/publish/api/file_app_api.js

@@ -26,7 +26,7 @@ export class FileAppApi extends ApiAbstractClass
 		const url      = `/${ this.api_prefix }/${ this.module_prefix }/issue_access_token`;
 		payload        = this.handle_request_payload(payload);
 		let response   = this.api_request(url, payload);
-		response       = this.handle_response(response, false);
+		response       = await this.handle_response(response, false);
 
 		return {
 			response: response,
@@ -51,7 +51,34 @@ export class FileAppApi extends ApiAbstractClass
 
 		payload      = this.handle_request_payload(payload);
 		let response = this.api_request(url, payload);
-		response     = this.handle_response(response, false);
+		response     = await this.handle_response(response, false);
+
+		this.method = prev_method;
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * GET|POST /web_api/file_app/file_access_urls?file_uuids[]=&disposition=
+	 *
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async file_access_urls(payload)
+	{
+		const url         = `/${ this.api_prefix }/${ this.module_prefix }/file_access_urls`;
+		const prev_method = this.method;
+
+		this.method = 'get';
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = await this.handle_response(response, false);
 
 		this.method = prev_method;
 
@@ -78,7 +105,7 @@ export class FileAppApi extends ApiAbstractClass
 
 		payload      = this.handle_request_payload(payload);
 		let response = this.api_request(url, payload);
-		response     = this.handle_response(response, false);
+		response     = await this.handle_response(response, false);
 
 		this.method = prev_method;
 

package/publish/api/index.js

@@ -22,6 +22,9 @@ 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 { TextDocumentApi } from "./text_document_api.js";
+import { PublicTextDocumentApi } from "./public_text_document_api.js";
+import { TextDocumentFolderApi } from "./text_document_folder_api.js";
 import { FileAppApi } from "./file_app_api.js";
 
 /**
@@ -163,6 +166,9 @@ export class Api
 		this.browser_tools_util_execution  = new BrowserToolsUtilExecutionApi(payload);
 		this.browser_tools_screenshot_multi = new BrowserToolsScreenshotMultiApi(payload);
 		this.file_app                      = new FileAppApi(payload);
+		this.text_document                 = new TextDocumentApi(payload);
+		this.text_document_folder          = new TextDocumentFolderApi(payload);
+		this.public_text_document          = new PublicTextDocumentApi(payload);
 
 		this.reference = this.bootstrap_reference(payload)
 	}

package/publish/api/project_api.js

@@ -20,16 +20,12 @@ export class ProjectApi extends ApiAbstractElementClass
 
 	/**
 	 *
-	 * All test cases + suites
-	 *
-	 * @version        v.1.1 (04/02/2026)
-	 * @param payload
-	 * @todo - валидация входящих параметров
+	 * @param {string} url
+	 * @param {object} payload
+	 * @returns {Promise<{response: *, payload: *}>}
 	 */
-	async get_test_structure(payload)
+	async _get_project_structure(url, payload)
 	{
-		let url = `/web_api/project/get/test_structure`;
-
 		payload      = this.handle_request_payload(payload);
 		let response = this.api_request(url, payload);
 		response     = this.handle_response(response, false);
@@ -39,4 +35,31 @@ export class ProjectApi extends ApiAbstractElementClass
 			payload : payload
 		};
 	}
+
+
+	/**
+	 *
+	 * All test cases + suites
+	 *
+	 * @version        v.1.1 (04/02/2026)
+	 * @param payload
+	 * @todo - валидация входящих параметров
+	 */
+	async get_test_structure(payload)
+	{
+		return this._get_project_structure('/web_api/project/get/test_structure', payload);
+	}
+
+
+	/**
+	 *
+	 * All text documents + folders
+	 *
+	 * @version        v.1.0 (04/07/2026)
+	 * @param payload
+	 */
+	async get_text_document_structure(payload)
+	{
+		return this._get_project_structure('/web_api/project/get/text_document_structure', payload);
+	}
 }

package/publish/api/public_text_document_api.js

@@ -0,0 +1,59 @@
+import { ApiAbstractClass } from "./api_abstract_class.js";
+
+/**
+ * Guest public text document view API.
+ *
+ * @version v.1.0 (04/07/2026)
+ */
+export class PublicTextDocumentApi extends ApiAbstractClass
+{
+	module_prefix = 'public/text_document';
+	api_prefix    = 'web_api';
+
+
+	/**
+	 * GET|POST /web_api/public/text_document/view
+	 *
+	 * @param {object} payload  token, password?
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async view(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/view`;
+		const prev_method = this.method;
+
+		this.method = 'get';
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = await this.handle_response(response, false);
+
+		this.method = prev_method;
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * POST /web_api/public/text_document/report
+	 *
+	 * @param {object} payload  token, reason, reporter_email, password?
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async report(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/report`;
+
+		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/text_document_api.js

@@ -0,0 +1,205 @@
+import { ApiAbstractElementClass } from "./api_abstract_element_class.js";
+import { typeTextDocument } from "../types/family_files/typeTextDocument.js";
+
+/**
+ * @version v.1.1 (05/07/2026)
+ */
+export class TextDocumentApi extends ApiAbstractElementClass
+{
+	module_prefix = 'text_document';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeTextDocument);
+	}
+
+
+	/**
+	 * GET /web_api/text_document/list_project_images?project_id=
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async list_project_images(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/list_project_images`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload, 'GET');
+		response     = await this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * GET /web_api/text_document/load_body?text_document_id=
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async load_body(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/load_body`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload, 'GET');
+		response     = await this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * GET /web_api/text_document/list_versions?text_document_id=
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async list_versions(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/list_versions`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload, 'GET');
+		response     = await this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * POST /web_api/text_document/restore_version
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async restore_version(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/restore_version`;
+
+		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,
+		};
+	}
+
+
+	/**
+	 * POST /web_api/text_document/enforce_version_retention
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async enforce_version_retention(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/enforce_version_retention`;
+
+		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,
+		};
+	}
+
+
+	/**
+	 * GET /web_api/text_document/public_share_status?text_document_id=
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async public_share_status(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/public_share_status`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload, 'GET');
+		response     = await this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * POST /web_api/text_document/create_public_share
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async create_public_share(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/create_public_share`;
+
+		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,
+		};
+	}
+
+
+	/**
+	 * POST /web_api/text_document/revoke_public_share
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async revoke_public_share(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/revoke_public_share`;
+
+		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,
+		};
+	}
+
+
+	/**
+	 * GET /web_api/text_document/public_share_analytics?text_document_id=
+	 *
+	 * @param {object} payload
+	 * @returns {Promise<{payload: object, response: object}>}
+	 */
+	async public_share_analytics(payload)
+	{
+		const url = `/${ this.api_prefix }/${ this.module_prefix }/public_share_analytics`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload, 'GET');
+		response     = await this.handle_response(response, false);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+}

package/publish/api/text_document_folder_api.js

@@ -0,0 +1,16 @@
+import { ApiAbstractElementClass } from "./api_abstract_element_class.js";
+import { typeTextDocumentFolder } from "../types/family_files/typeTextDocumentFolder.js";
+
+/**
+ * @version v.1.0 (04/07/2026)
+ */
+export class TextDocumentFolderApi extends ApiAbstractElementClass
+{
+	module_prefix = 'text_document_folder';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeTextDocumentFolder);
+	}
+}

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

@@ -11,6 +11,7 @@ import { typeTestCaseStep } from '../../../types/family_elements/typeTestCaseSte
 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 { typeTextDocument } from '../../../types/family_files/typeTextDocument.js';
 
 /**
  * Реестр классов моделей по ключу `element_type`.
@@ -36,5 +37,6 @@ export const TABLE_ELEMENT_MODELS = {
 	test_case_step : typeTestCaseStep,
 	user           : typeUser,
 	team           : typeTeam,
+	text_document  : typeTextDocument,
 	util_execution : typeUtilExecutionScreenshotMulti,
 };

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

@@ -0,0 +1,31 @@
+import { typeTextDocument } from '../../../types/family_files/typeTextDocument.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_text_document_listing_columns(locale)
+{
+	const model = new typeTextDocument();
+
+	return [
+		createPrimaryKeyColumn(model, locale),
+		createColumn(model, locale, 'text_document_title', { width: '320', is_editable: true, is_title: true }),
+		createColumn(model, locale, 'text_document_status', { width: '140', is_editable: true }),
+		createColumn(model, locale, 'text_document_folder_id', { width: '120' }),
+		createColumn(model, locale, 'created_at', { width: '170' }),
+		createColumn(model, locale, 'updated_at', { width: '170' }),
+		createGoToColumn(model, locale),
+	];
+}
+
+/**
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ */
+export function bootstrap_text_document(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'text_document', 'listing', build_text_document_listing_columns(locale), {
+		for: createListingFor([ 'project_id', 'text_document_folder_id' ]),
+	});
+}

package/publish/app_configuration/table/table_configuration.js

@@ -12,6 +12,7 @@ import { bootstrap_team_member } from './sections/team_member.js';
 import { bootstrap_user } from './sections/user.js';
 import { bootstrap_team } from './sections/team.js';
 import { bootstrap_project } from './sections/project.js';
+import { bootstrap_text_document } from './sections/text_document.js';
 import { localizeTableSection } from './helpers/column_locale.js';
 
 /**
@@ -120,6 +121,7 @@ export class TableConfiguration extends abstractAppConfiguration
 		bootstrap_user(this.config);
 		bootstrap_team(this.config);
 		bootstrap_project(this.config);
+		bootstrap_text_document(this.config);
 
 		this.state.loaded = true;
 	}

package/publish/app_configuration/text_document_editor_config.js

@@ -0,0 +1,31 @@
+/**
+ * LEGACY — TipTap toolbar stub from early text document plan (not shipped).
+ *
+ * Text documents use CKEditor 4 in web_app (`textDocumentEditorConfig.ts`).
+ * TipTap was evaluated and rejected — see complex_processes/text_editor/01-decisions.md.
+ *
+ * @deprecated Not consumed by web_app. Kept for export compatibility only.
+ * @version v.1.1 (04/07/2026)
+ */
+export const text_document_editor_config = {
+	starterKit: {
+		heading: {
+			levels: [ 1, 2, 3 ],
+		},
+	},
+	underline      : true,
+	textAlign      : true,
+	color          : true,
+	highlight      : true,
+	link           : true,
+	placeholder    : 'Start writing…',
+	numberedHeadings: true,
+};
+
+/**
+ * @returns {typeof text_document_editor_config}
+ */
+export function get_text_document_editor_config()
+{
+	return text_document_editor_config;
+}

package/publish/constants/text_document_limits.js

@@ -0,0 +1,18 @@
+/**
+ * Limits for text document feature (sync with test_site and file-app).
+ *
+ * @version v.1.0 (04/07/2026)
+ */
+export const TEXT_DOCUMENT_MAX_IMAGES = 20;
+
+export const TEXT_DOCUMENT_MAX_BODY_BYTES = 5242880;
+
+export const TEXT_DOCUMENT_MAX_VERSIONS = 15;
+
+export const TEXT_DOCUMENT_AUTOSAVE_STORAGE_PREFIX = 'text_document_autosave_';
+
+/**
+ * img[src] required by file-app HTMLPurifier on html body upload.
+ * Real URL is resolved on load via data-file-uuid + file_access_url.
+ */
+export const TEXT_DOCUMENT_IMAGE_STORAGE_PLACEHOLDER_SRC = 'https://landing.complexqa.com/icons/favicon_192.png';

package/publish/index.js

@@ -45,6 +45,17 @@ export { typeFilePostman } from './types/family_files/typeFilePostman.js';
 export { typeFileVideo } from './types/family_files/typeFileVideo.js';
 export { typeFileJson } from './types/family_files/typeFileJson.js';
 export { create_type_file_from_wire } from './types/family_files/typeFileFactory.js';
+export { typeTextDocument } from './types/family_files/typeTextDocument.js';
+export { typeTextDocumentFolder } from './types/family_files/typeTextDocumentFolder.js';
+
+export { TEXT_DOCUMENT_MAX_IMAGES, TEXT_DOCUMENT_MAX_BODY_BYTES, TEXT_DOCUMENT_MAX_VERSIONS, TEXT_DOCUMENT_AUTOSAVE_STORAGE_PREFIX, TEXT_DOCUMENT_IMAGE_STORAGE_PLACEHOLDER_SRC } from './constants/text_document_limits.js';
+export {
+	count_text_document_images,
+	collect_text_document_image_uuids,
+	build_text_document_image_html,
+	can_add_text_document_image,
+} from './utils/text_document_image.js';
+export { text_document_editor_config, get_text_document_editor_config } from './app_configuration/text_document_editor_config.js';
 
 export { typeUser } from './types/family_elements/typeUser.js';
 export { typeTeam } from './types/family_elements/typeTeam.js';