@dxtmisha/functional-basic 1.1.0 → 1.1.5

package/dist/library.d.ts

@@ -69,6 +69,13 @@ export declare class Api {
      * @returns HTML script element string / строка HTML элемента script
      */
     static getHydrationScript(): string;
+    /**
+     * Gets the base origin URL combined with the API path.
+     *
+     * Получает базовый URL источника, объединенный с путем API.
+     * @returns final base URL string / итоговая строка базового URL
+     */
+    static getOrigin(): string;
     /**
      * Gets the full path to the request script.
      *
@@ -145,6 +152,14 @@ export declare class Api {
      * @returns void / ничего не возвращает
      */
     static setTimeout(timeout: number): void;
+    /**
+     * Changes the origin (protocol and domain) for the base URL.
+     *
+     * Изменяет источник (протокол и домен) для базового URL.
+     * @param origin protocol and domain / протокол и домен
+     * @returns void / ничего не возвращает
+     */
+    static setOrigin(origin: string): void;
     /**
      * Sets multiple API configuration options at once.
      *
@@ -378,6 +393,8 @@ export declare type ApiCacheList = Record<string, ApiCacheItem>;
 export declare type ApiConfig = {
     /** Base URL for API requests/ Базовый URL для API-запросов */
     urlRoot?: string;
+    /** Base origin for API requests (protocol and domain)/ Базовый источник для API-запросов (протокол и домен) */
+    origin?: string;
     /** Default headers for API requests/ Заголовки по умолчанию для API-запросов */
     headers?: Record<string, string>;
     /** Default request data for API requests/ Данные запроса по умолчанию для API-запросов */
@@ -722,6 +739,7 @@ export declare class ApiInstance {
     protected hydration: ApiHydration;
     /** Timeout for the request in milliseconds / Таймаут запроса в миллисекундах */
     protected timeout: number;
+    protected origin?: string;
     /**
      * Constructor
      * @param url base path to the script / базовый путь к скрипту
@@ -756,6 +774,13 @@ export declare class ApiInstance {
      * @returns ApiHydration instance / экземпляр ApiHydration
      */
     getHydration(): ApiHydration;
+    /**
+     * Gets the base origin URL combined with the API path.
+     *
+     * Получает базовый URL источника, объединенный с путем API.
+     * @returns final base URL string / итоговая строка базового URL
+     */
+    getOrigin(): string;
     /**
      * Gets the full path to the request script.
      *
@@ -773,7 +798,7 @@ export declare class ApiInstance {
      * @param method HTTP method / HTTP метод
      * @returns body data for non-GET requests or FormData / данные тела для не-GET запросов или FormData
      */
-    getBody(request?: ApiFetch['request'], method?: ApiMethodItem): string | FormData | undefined;
+    getBody(request?: ApiFetch['request'], method?: ApiMethod): string | FormData | undefined;
     /**
      * Gets query string for GET method requests.
      *
@@ -783,7 +808,7 @@ export declare class ApiInstance {
      * @param method HTTP method / HTTP метод
      * @returns query string with prefix (? or &) / строка запроса с префиксом (? или &)
      */
-    getBodyForGet(request: ApiFetch['request'], path?: string, method?: ApiMethodItem): string;
+    getBodyForGet(request: ApiFetch['request'], path?: string, method?: ApiMethod): string;
     /**
      * Returns a string representation of the hydration data for the client.
      *
@@ -833,6 +858,13 @@ export declare class ApiInstance {
      * @param timeout timeout in milliseconds / таймаут в миллисекундах
      */
     setTimeout(timeout: number): this;
+    /**
+     * Changes the origin (protocol and domain) for the base URL.
+     *
+     * Изменяет источник (протокол и домен) для базового URL.
+     * @param origin protocol and domain / протокол и домен
+     */
+    setOrigin(origin: string): this;
     /**
      * Executes a request with the given path or configuration.
      *
@@ -903,9 +935,10 @@ export declare class ApiInstance {
      *
      * Выполнение HTTP-запроса.
      * @param apiFetch fetch configuration / конфигурация запроса
+     * @param pathToApi base path to API / базовый путь к API
      * @returns object containing response and optional timeout ID / объект, содержащий ответ и опциональный ID таймера
      */
-    protected makeQuery(apiFetch: ApiFetch): Promise<{
+    protected makeQuery(apiFetch: ApiFetch, pathToApi: string): Promise<{
         query: Response;
         timeoutId: any;
     }>;
@@ -961,7 +994,7 @@ export declare type ApiInstanceOptions = {
  * Supported HTTP methods type/ Тип HTTP-методов
  * (derived from ApiMethodItem enum)/ (получен из перечисления ApiMethodItem)
  */
-export declare type ApiMethod = string & ApiMethodItem;
+export declare type ApiMethod = string | ApiMethodItem;
 
 /**
  * Supported HTTP methods for API requests.
@@ -1123,6 +1156,14 @@ export declare class ApiResponse {
      * @returns emulated response or undefined / эмулированный ответ или undefined
      */
     emulator<T>(apiFetch: ApiFetch): Promise<T | undefined>;
+    /**
+     * Executes the emulator synchronously if available.
+     *
+     * Выполняет эмулятор синхронно, если доступно.
+     * @param apiFetch fetch configuration / конфигурация запроса
+     * @returns emulated response or undefined / эмулированный ответ или undefined
+     */
+    emulatorAsync<T>(apiFetch: ApiFetch): T | undefined;
     /**
      * Checks if the cached item is disabled.
      *
@@ -1166,6 +1207,17 @@ export declare class ApiResponse {
      * @returns true if requests match / true, если запросы совпадают
      */
     protected isResponse(item: ApiResponseItem, request?: ApiFetch['request']): boolean;
+    /**
+     * Reads cached data configuration.
+     *
+     * Считывает конфигурацию кешированных данных.
+     * @param apiFetch fetch configuration / конфигурация запроса
+     * @returns object with response and request data or undefined / объект с данными ответа и запроса или undefined
+     */
+    protected readData(apiFetch: ApiFetch): {
+        response: ApiResponseItem;
+        request: string | Record<string, any> | FormData | undefined;
+    } | undefined;
     /**
      * Emulates an execution request (internal fetch).
      *
@@ -1175,6 +1227,14 @@ export declare class ApiResponse {
      * @returns Promise with emulated response data / Promise с эмулированными данными ответа
      */
     protected fetch<T>(response: ApiResponseItem, request?: ApiFetch['request']): Promise<T>;
+    /**
+     * Emulates an execution request synchronously (internal fetch).
+     *
+     * Эмулирует запрос выполнения синхронно (внутренний fetch).
+     * @param response response item for emulation / элемент ответа для эмуляции
+     * @returns emulated response data / эмулированные данные ответа
+     */
+    protected fetchAsync<T>(response: ApiResponseItem): T;
     /**
      * Enables loading for request emulation.
      *
@@ -1736,6 +1796,16 @@ export declare type CookieOptions = {
     age?: number;
     /** SameSite attribute / Атрибут SameSite */
     sameSite?: CookieSameSite_2;
+    /** Path / Путь */
+    path?: string;
+    /** Domain / Домен */
+    domain?: string;
+    /** Secure attribute / Атрибут Secure */
+    secure?: boolean;
+    /** HttpOnly attribute / Атрибут HttpOnly */
+    httpOnly?: boolean;
+    /** Partitioned attribute / Атрибут Partitioned */
+    partitioned?: boolean;
     /** Additional arguments / Дополнительные аргументы */
     arguments?: string[] | Record<string, string | number | boolean>;
 };
@@ -1756,8 +1826,10 @@ export { CookieSameSite_2 as CookieSameSite }
 export declare class CookieStorage {
     /** Storage mechanism for getting data / механизм хранения для получения данных */
     protected static getListener?: (key: string) => any | undefined;
+    /** Storage mechanism for getting raw data / механизм хранения для получения сырых данных */
+    protected static getListenerRaw?: () => string;
     /** Storage mechanism for setting data / механизм хранения для сохранения данных */
-    protected static setListener?: (key: string, value: any, options?: CookieOptions) => void;
+    protected static setListener?: (key: string, value: any, cookie: string, options?: CookieOptions) => void;
     /**
      * Initializes the storage with listeners.
      *
@@ -1765,7 +1837,7 @@ export declare class CookieStorage {
      * @param getListener Storage mechanism for getting data / механизм хранения для получения данных
      * @param setListener Storage mechanism for setting data / механизм хранения для сохранения данных
      */
-    static init(getListener: (key: string) => any | undefined, setListener: (key: string, value: any, options?: CookieOptions) => void): void;
+    static init(getListener?: (key: string) => any | undefined, getListenerRaw?: () => string, setListener?: (key: string, value: any, cookie: string, options?: CookieOptions) => void): void;
     /**
      * Resets the storage by clearing all in-memory items and resetting listeners.
      *
@@ -1805,6 +1877,15 @@ export declare class CookieStorage {
      * Обновляет данные из cookies.
      */
     static update(): void;
+    /**
+     * Formats the cookie string for storage.
+     *
+     * Форматирует строку cookie для хранения.
+     * @param name cookie name / имя cookie
+     * @param value cookie value / значение cookie
+     * @param options additional parameters / дополнительные параметры
+     */
+    protected static format(name: string, value: string, options?: CookieOptions): string;
     /**
      * Check if the current environment is a DOM environment.
      *
@@ -1812,6 +1893,14 @@ export declare class CookieStorage {
      * @returns True if the current environment is a DOM environment, false otherwise / Возвращает true, если текущее окружение является DOM-окружением, иначе false
      */
     protected static hasDom(): boolean;
+    /**
+     * Parses the cookie string into a key-value pair object.
+     *
+     * Разбирает строку cookie в объект пар ключ-значение.
+     * @param cookie cookie string / строка cookie
+     * @returns Record<string, any> parsed items / разобранные элементы
+     */
+    protected static parse(cookie: string): Record<string, any>;
     /**
      * Initialize storage if not initialized.
      *
@@ -1833,6 +1922,41 @@ export declare class CookieStorage {
      * @param sameSite SameSite attribute / атрибут SameSite
      */
     protected static toSameSite(sameSite?: CookieOptions['sameSite']): string;
+    /**
+     * Converts the value to a string for the path attribute.
+     *
+     * Преобразует значение в строку для атрибута path.
+     * @param path Path / путь
+     */
+    protected static toPath(path?: CookieOptions['path']): string;
+    /**
+     * Converts the value to a string for the domain attribute.
+     *
+     * Преобразует значение в строку для атрибута domain.
+     * @param domain Domain / домен
+     */
+    protected static toDomain(domain?: CookieOptions['domain']): string | undefined;
+    /**
+     * Converts the value to a string for the secure attribute.
+     *
+     * Преобразует значение в строку для атрибута secure.
+     * @param secure Secure attribute / атрибут secure
+     */
+    protected static toSecure(secure?: CookieOptions['secure']): string | undefined;
+    /**
+     * Converts the value to a string for the HttpOnly attribute.
+     *
+     * Преобразует значение в строку для атрибута HttpOnly.
+     * @param httpOnly HttpOnly attribute / атрибут HttpOnly
+     */
+    protected static toHttpOnly(httpOnly?: CookieOptions['httpOnly']): string | undefined;
+    /**
+     * Converts the value to a string for the partitioned attribute.
+     *
+     * Преобразует значение в строку для атрибута partitioned.
+     * @param partitioned Partitioned attribute / атрибут partitioned
+     */
+    protected static toPartitioned(partitioned?: CookieOptions['partitioned']): string | undefined;
     /**
      * Converts additional arguments to an array of strings.
      *
@@ -5234,6 +5358,16 @@ export declare class Icons {
      * @returns icon path or content/ путь к иконке или контент
      */
     static get(index: string, url?: string, wait?: number): Promise<string>;
+    /**
+     * Returns the icon if it is already loaded or is a string.
+     *
+     * Возвращает иконку, если она уже загружена или является строкой.
+     * @param index icon name/ название иконки
+     * @param url path to the storage location of the icon, if the icon does not exist/
+     * путь к месту хранения иконки, если иконка не существует
+     * @returns icon path or content/ путь к иконке или контент
+     */
+    static getAsync(index: string, url?: string): string;
     /**
      * Returns a list of names of all registered icons.
      *
@@ -5300,6 +5434,16 @@ export declare class Icons {
      * @returns icon name with prefix/ название иконки с префиксом
      */
     protected static getName(index: string): string;
+    /**
+     * Returns the raw icon data by the name.
+     *
+     * Возвращает исходные данные иконки по названию.
+     * @param index icon name/ название иконки
+     * @param url path to the storage location of the icon, if the icon does not exist/
+     * путь к месту хранения иконки, если иконка не существует
+     * @returns icon path or content/ путь к иконке или контент
+     */
+    protected static getRaw(index: string, url?: string): IconsItem;
     /**
      * Script execution delay.
      *
@@ -5956,6 +6100,13 @@ export declare class Meta extends MetaManager<MetaTag[]> {
      * @returns complete HTML string/ полная HTML-строка
      */
     html(): string;
+    /**
+     * Generates the title as an HTML-safe string.
+     *
+     * Генерирует заголовок в виде HTML-безопасной строки.
+     * @returns title HTML-safe string / HTML-безопасная строка заголовка
+     */
+    htmlTitle(): string;
     /**
      * Gets the formatted suffix with separator.
      *
@@ -6069,6 +6220,14 @@ export declare class MetaManager<T extends readonly string[], Key extends keyof
      * @returns HTML string / HTML-строка
      */
     protected toHtmlString(name: Key): string;
+    /**
+     * Converts the title to an HTML-safe string.
+     *
+     * Преобразует заголовок в HTML-безопасную строку.
+     * @param title page title / заголовок страницы
+     * @returns encoded title string / закодированная строка заголовка
+     */
+    protected toHtmlTitle(title: string): string;
     /**
      * Updates meta tags data from the DOM.
      *
@@ -6774,6 +6933,13 @@ export declare class MetaStatic {
      * @returns complete HTML string / полная HTML-строка
      */
     static html(): string;
+    /**
+     * Generates the title as an HTML-safe string.
+     *
+     * Генерирует заголовок в виде HTML-безопасной строки.
+     * @returns title HTML-safe string / HTML-безопасная строка заголовка
+     */
+    static htmlTitle(): string;
 }
 
 /**
@@ -7822,7 +7988,7 @@ export declare function secondToTime(second: number | string | undefined, hasHou
  */
 export declare class ServerStorage {
     protected static storage?: ServerStorageList;
-    protected static listener?: () => Record<string, any>;
+    protected static listener?: () => Record<string, any> | undefined;
     protected static hideError?: boolean;
     /**
      * Initializes the storage with a context listener.
@@ -7831,7 +7997,7 @@ export declare class ServerStorage {
      * @param listener function that returns the current request context / функция, возвращающая контекст текущего запроса
      * @returns this instance / текущий класс
      */
-    static init(listener: () => Record<string, any>): typeof ServerStorage;
+    static init(listener: () => Record<string, any> | undefined): typeof ServerStorage;
     /**
      * Resets the storage.
      *
@@ -7891,9 +8057,12 @@ export declare class ServerStorage {
      * Returns storage.
      *
      * Возвращает хранилище.
+     * @param isInit whether to initialize the storage if it does not exist /
+     * инициализировать ли хранилище, если оно не существует
+     * @param status optional status for error reporting / необязательный статус для отчета об ошибках
      * @returns storage list / список хранилища
      */
-    protected static getStorage(): ServerStorageList;
+    protected static getStorage(isInit?: boolean, status?: string): ServerStorageList;
     /**
      * Returns storage from DOM.
      *