complexqa_frontend_core 1.31.6 → 2.0.0

package/types/services/FileAppService.d.ts

@@ -0,0 +1,131 @@
+/**
+ * File App orchestration: bootstrap URL, upload, URL refresh.
+ *
+ * @see docs/File App Layer/README.MD
+ *
+ * @version			v.1.0 (28/06/2026)
+ */
+export class FileAppService extends abstractService {
+    static file_app_url: boolean;
+    static api_service: boolean;
+    /**
+     * @param {object} options
+     * @param {string} options.file_app_url
+     * @param {import('../api/index.js').Api} [options.api_service]
+     */
+    static bootstrap(options?: {
+        file_app_url: string;
+        api_service?: import("../api/index.js").Api;
+    }): void;
+    /**
+     * @returns {string|false}
+     */
+    static get_file_app_url(): string | false;
+    /**
+     * @returns {import('../api/index.js').Api}
+     */
+    static "__#2@#get_api_service"(): import("../api/index.js").Api;
+    static "__#2@#ensure_file_app_url_from_token"(token_data: any): void;
+    /**
+     * Whether entity_type is present for File App binding.
+     * Empty / null / 0 → omit from token and upload init.
+     *
+     * @param {*} value
+     * @returns {boolean}
+     */
+    static "__#2@#has_entity_type"(value: any): boolean;
+    /**
+     * Whether entity_id is present for File App binding.
+     * Empty / null / 0 / NaN → omit from token and upload init.
+     *
+     * @param {*} value
+     * @returns {boolean}
+     */
+    static "__#2@#has_entity_id"(value: any): boolean;
+    /**
+     * 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] — 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
+     *
+     * @returns {Promise<import('../types/family_files/typeFile.js').typeFile>}
+     */
+    static upload_file(payload: {
+        file: File | Blob;
+        entity_type?: string;
+        entity_id?: number;
+        category: string;
+        original_name?: string;
+        file_uuid?: string;
+    }): Promise<import("../types/family_files/typeFile.js").typeFile>;
+    /**
+     * List files attached to entity via Main App bridge.
+     *
+     * @param {object} payload
+     * @param {string} payload.entity_type
+     * @param {number} payload.entity_id
+     * @param {string} [payload.category]
+     *
+     * @returns {Promise<any>}
+     */
+    static list_entity_files(payload: {
+        entity_type: string;
+        entity_id: number;
+        category?: string;
+    }): Promise<any>;
+    /**
+     * Refresh presigned URL via Main App bridge (lazy fallback when details wire expired).
+     *
+     * @param {string} file_uuid
+     * @param {'inline'|'attachment'} [disposition]
+     *
+     * @returns {Promise<any>}
+     */
+    static refresh_file_access_url(file_uuid: string, disposition?: "inline" | "attachment"): Promise<any>;
+    /**
+     * Batch refresh presigned URLs (one token on Main App).
+     *
+     * @param {string[]} file_uuids
+     * @param {'inline'|'attachment'} [disposition]
+     *
+     * @returns {Promise<Record<string, { preview_url?: string, download_url?: string, preview_url_expires_at?: string|false, download_url_expires_at?: string|false, mime_type?: string|false }>>}
+     */
+    static refresh_file_access_urls_batch(file_uuids: string[], disposition?: "inline" | "attachment"): Promise<Record<string, {
+        preview_url?: string;
+        download_url?: string;
+        preview_url_expires_at?: string | false;
+        download_url_expires_at?: string | false;
+        mime_type?: string | false;
+    }>>;
+    /**
+     * Team / project Files listing.
+     *
+     * @param {object} [payload]
+     * @param {number} [payload.project_id]
+     *
+     * @returns {Promise<any>}
+     */
+    static list_team_files(payload?: {
+        project_id?: number;
+    }): Promise<any>;
+    /**
+     * Soft-delete many files (also clears attachment links on Main).
+     *
+     * @param {string[]} file_uuids
+     *
+     * @returns {Promise<any>}
+     */
+    static delete_files(file_uuids: string[]): Promise<any>;
+    /**
+     * @param {string} file_uuid
+     *
+     * @returns {Promise<any>}
+     */
+    static delete_file(file_uuid: string): Promise<any>;
+}
+import { abstractService } from "./abstractService.js";

package/types/services/TeamService.d.ts

@@ -0,0 +1,21 @@
+/**
+ *
+ * @version          v.1.0 (11/03/2026)
+ */
+export class TeamService extends abstractService {
+    static team_members: boolean;
+    static team_id: boolean;
+    /**
+     *
+     * @version          v.1.0 (11/03/2026)
+     * @returns {false|number}
+     */
+    static get_team_members(): false | number;
+    /**
+     *
+     * @version          v.1.0 (11/03/2026)
+     * @param {object|typeUser} team_member
+     */
+    static add_team_member(team_member: object | typeUser): void;
+}
+import { abstractService } from "./abstractService.js";

package/types/services/UserService.d.ts

@@ -0,0 +1,233 @@
+/**
+ * Сервис данных по текущему пользователю
+ *
+ * @version          v.1.1 (27/07/2025)
+ */
+export class UserService extends abstractService {
+    /**
+     *
+     * @type {false|number}
+     */
+    static current_user_id: false | number;
+    /**
+     *
+     * @deprecated
+     * @type {false|string}
+     */
+    static user_name: false | string;
+    static first_name: boolean;
+    static last_name: boolean;
+    static user_status: boolean;
+    static email: boolean;
+    /**
+     *
+     * @type {false|number}
+     */
+    static current_team_id: false | number;
+    /**
+     *
+     * @type {false|string}
+     */
+    static current_team_slug: false | string;
+    /**
+     * member_role of the current user in current_team_id: ADMINISTRATOR | MEMBER | READONLY.
+     * SPA bootstrap: auth/common_page.blade.php from team_members join in get_user_teams().
+     *
+     * @type {false|string}
+     */
+    static current_member_role: false | string;
+    /**
+     *
+     * @type {false|array<typeTeam>}
+     */
+    static user_teams: false | array<typeTeam>;
+    /**
+     *
+     * @type {array<string>}
+     */
+    static roles: array<string>;
+    /**
+     *
+     * @type {string}
+     */
+    static current_language: string;
+    /**
+     *
+     * @type {false|string}
+     */
+    static csrf_token: false | string;
+    /**
+     *
+     * @type {false|string}
+     */
+    static web_app_domain: false | string;
+    /**
+     *
+     * @type {string}
+     */
+    static start_page: string;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @returns {false|string}
+     */
+    static get_csrf_token(): false | string;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {string} csrf_token
+     */
+    static set_csrf_token(csrf_token: string): void;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @returns {false|number}
+     */
+    static get_current_user_id(): false | number;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {number} current_user_id
+     */
+    static set_current_user_id(current_user_id: number): void;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @returns {false|string}
+     */
+    static get_current_team_slug(): false | string;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {string} current_team_slug
+     */
+    static set_current_team_slug(current_team_slug: string): void;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @returns {false|string}
+     */
+    static get_first_name(): false | string;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @param {string} first_name
+     */
+    static set_first_name(first_name: string): void;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @returns {false|string}
+     */
+    static get_last_name(): false | string;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @param {string} last_name
+     */
+    static set_last_name(last_name: string): void;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @returns {false|string}
+     */
+    static get_user_status(): false | string;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @param {string} user_status
+     */
+    static set_user_status(user_status: string): void;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @returns {false|string}
+     */
+    static get_email(): false | string;
+    /**
+     *
+     * @version          v.1.0 (19/03/2026)
+     * @param {string} email
+     */
+    static set_email(email: string): void;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @returns {false|number}
+     */
+    static get_current_team_id(): false | number;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {number} current_team_id
+     */
+    static set_current_team_id(current_team_id: number): void;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @returns {false|Array<typeTeam>}
+     */
+    static get_user_teams(): false | Array<typeTeam>;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {Array<typeTeam>} user_teams
+     */
+    static set_user_teams(user_teams: Array<typeTeam>): void;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {typeTeam} user_team
+     */
+    static add_user_teams(user_team: typeTeam): void;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @returns {Array<string>}
+     */
+    static get_roles(): Array<string>;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {Array<string>} roles
+     */
+    static set_roles(roles: Array<string>): void;
+    /**
+     *
+     * @version          v.1.0 (25/04/2026)
+     * @param {string} role
+     */
+    static add_role(role: string): void;
+    /**
+     *
+     * @version          v.1.0 (25/04/2026)
+     * @param role
+     * @returns {boolean}
+     */
+    static has_role(role: any): boolean;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @returns {string}
+     */
+    static get_current_language(): string;
+    /**
+     *
+     * @version          v.1.1 (27/07/2025)
+     * @param {string} current_language
+     */
+    static set_current_language(current_language: string): void;
+    /**
+     *
+     * @version          v.1.1 (22/02/2026)
+     * @param {string} start_page
+     */
+    static set_start_page(start_page: string): void;
+    /**
+     *
+     * @version          v.1.2 (19/03/2026)
+     */
+    static get_start_page(): string;
+}
+import { abstractService } from "./abstractService.js";
+import { typeTeam } from "../types/family_elements/typeTeam.js";

package/types/services/abstractService.d.ts

@@ -0,0 +1,13 @@
+/**
+ *
+ * @version			v.0.1 (25/06/2024)
+ */
+export class abstractService {
+    static mock(): void;
+    /**
+     *
+     * @param init_options
+     */
+    constructor(init_options?: boolean);
+    init_options: boolean;
+}

package/types/services/mock_data/MockUserService.d.ts

@@ -0,0 +1,12 @@
+export class MockUserService {
+    static mock_attributes: ({
+        key: string;
+        value: number;
+    } | {
+        key: string;
+        value: string;
+    } | {
+        key: string;
+        value: string[];
+    })[];
+}

package/types/types/core/0_familyGeneralElement.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Базовый абстрактный класс для всех типов
+ *
+ * @version			v.0.2 (12/06/2025)
+ */
+export class familyGeneralElement {
+    /**
+     * @param {object} [options]
+     * @param {import('../../api/index.js').Api|false} [options.api_service]
+     */
+    static bootstrap(options?: {
+        api_service?: import("../../api/index.js").Api | false;
+    }): void;
+    /** @type {string|false} */
+    primary_key: string | false;
+    /** @type {string[]|false} */
+    create_scheme: string[] | false;
+    /** @type {object|false} */
+    structure_scheme: object | false;
+    /** @type {Record<string, string[]>|false} */
+    available_enum_values: Record<string, string[]> | false;
+    /** @type {string|false} */
+    api_key: string | false;
+    attribute_name_translate_matrix: {
+        en: {};
+        ru: {};
+        de: {};
+        ar: {};
+        es: {};
+        fr: {};
+        hy: {};
+        it: {};
+        pl: {};
+        pt: {};
+        tt: {};
+    };
+    /** @type {Record<string, Record<string, string>>|false} */
+    enum_value_translate_matrix: Record<string, Record<string, string>> | false;
+    /**
+     * @returns {import('../../api/api_abstract_class.js').ApiAbstractClass}
+     */
+    get_api_client(): import("../../api/api_abstract_class.js").ApiAbstractClass;
+    /***********************************************/
+    /***********************************************/
+    /***********************************************/
+    /**
+     *
+     * @version			v.0.1 (26/05/2024)
+     * @returns {string}
+     */
+    get_primary_key(): string;
+    /**
+     *
+     * @version			v.0.1 (14/03/2026)
+     * @return {string|false}
+     */
+    get_primary_key_value(): string | false;
+    /**
+     *
+     * @version			v.0.1 (27/06/2024)
+     * @returns {array<familyGeneralElement>}
+     * @param {number} count
+     */
+    get_random_demo_data(count: number): array<familyGeneralElement>;
+    /**
+     *
+     * @returns {familyGeneralElement}
+     */
+    get_demo_row(): familyGeneralElement;
+    /**
+     * @param {string} attribute
+     * @returns {string[]|false}
+     */
+    get_available_enum_values(attribute: string): string[] | false;
+    /**
+     *
+     * @param attribute
+     * @returns {array|false}
+     */
+    get_attribute_structure_scheme(attribute: any): any[] | false;
+    /**
+     * Токен целевого типа для FK/reference-атрибута (`typeBrowserContext`, …).
+     *
+     * @param {string} attribute
+     * @returns {string|false}
+     */
+    get_attribute_reference_type_token(attribute: string): string | false;
+    /**
+     * @param {string} attribute
+     * @returns {boolean}
+     */
+    is_reference_attribute(attribute: string): boolean;
+    /**
+     * Метаданные reference из целевого типа (api, primary_key, search).
+     *
+     * @param {string} attribute
+     * @returns {object|false}
+     */
+    get_attribute_reference_meta(attribute: string): object | false;
+    /**
+     *
+     * @version			v.0.1 (26/05/2024)
+     */
+    get_data(): boolean;
+    /**
+     *
+     * @version			v.0.1 (26/05/2024)
+     */
+    get_pure_data(): boolean;
+    /**
+     * @todo - сделать нормализация по create scheme с валидацией
+     *
+     * @version			v.0.1 (26/01/2025)
+     *
+     * @param payload
+     * @returns {*}
+     */
+    normalize_payload(payload: any): any;
+    get_editable_attributes(): void;
+    is_editable_attribute(attribute: any): void;
+    /**
+     *
+     * @version			v.1.0 (14/03/2026)
+     *
+     * @param {string} attribute_name
+     * @param {string} lang
+     *
+     * @return {string}
+     */
+    get_attribute_name_translate(attribute_name: string, lang: string): string;
+    /**
+     *
+     * @version			v.1.0 (05/04/2026)
+     * @returns {*}
+     */
+    get_enum_value_translate(attribute: any, value: any, lang: any): any;
+    /***********************************************/
+    /**
+     * Возвращаем "имя", то есть значение атрибута, который является именем
+     *
+     * @version			v.0.2 (26/07/2026)
+     */
+    get_element_name(): string | false;
+    /***********************************************/
+    /***********************************************/
+    /***********************************************/
+    /**
+     *
+     * @version			v.0.1 (26/05/2024)
+     * @param id
+     */
+    find(id?: boolean): Promise<void>;
+    /**
+     * @param {familyGeneralElement|object} payload
+     * @param {object} [callback]
+     * @version			v.2.0 (12/06/2025)
+     */
+    create(payload: familyGeneralElement | object, callback?: object): Promise<any>;
+    /**
+     * Mass create. Payload: `{ items: object[] }`.
+     *
+     * @param {object} payload
+     * @param {array} payload.items
+     * @param {typeFunctionCallback|object|false} callback
+     * @version			v.1.0 (29/08/2026)
+     */
+    create_mass(payload: {
+        items: any[];
+    }, callback: typeFunctionCallback | object | false): Promise<any>;
+    /**
+     * Обновление целой модели элемента
+     *
+     * @version			v.2.0 (12/06/2025)
+     */
+    update(payload: any, callback: any): Promise<any>;
+    /**
+     * Обновление 1 атрибута у 1 элемента
+     *
+     * @version			v.2.0 (12/06/2025)
+     * @param key
+     * @param value
+     * @param callback
+     * @returns {Promise<>}
+     */
+    update_property(key: any, value: any, callback: any): Promise<any>;
+    /**
+     * Массив свойств у 1 элемента
+     *
+     * @version			v.0.1 (26/05/2024)
+     * @param {number} 	element_id
+     * @param {array}  	payload array<key->value>
+     * @returns {Promise<void>}
+     */
+    update_properties(element_id: number, payload: any[], callback: any): Promise<void>;
+    /**
+     * 1 свойство и массива элементов
+     *
+     * @version			v.0.1 (07/07/2026)
+     *
+     * @param {array<number>} 					element_ids
+     * @param {string} 							key
+     * @param {any}  							value в зависимости от типа
+     * @param {object|typeFunctionCallback} 	callback
+     *
+     * @returns {Promise<void>}
+     */
+    update_property_mass(element_ids: array<number>, key: string, value: any, callback: object | typeFunctionCallback): Promise<void>;
+    /**
+     *
+     * @version			v.2.0 (12/06/2025)
+     */
+    delete(element?: boolean, callback?: {}): Promise<any>;
+    /**
+     *
+     * @version			v.1.0 (07/03/2026)
+     */
+    delete_mass(element_ids: any, callback?: {}): Promise<void>;
+    /**
+     *
+     * @version			v.1.0 (07/03/2026)
+     */
+    clone_element(element?: boolean, callback?: {}): Promise<any>;
+    /**
+     *
+     * @version			v.1.0 (07/03/2026)
+     */
+    clone_element_mass(element_ids: any, callback?: {}): Promise<void>;
+}