@dxtmisha/functional-basic 1.8.9 → 1.10.0

package/dist/classes/CookieStorage.d.ts

@@ -1,175 +0,0 @@
-/**
- * Cookie sameSite attribute / Атрибут sameSite cookie
- */
-export type CookieSameSite = 'strict' | 'lax';
-/**
- * Cookie options / Параметры cookie
- */
-export type CookieOptions = {
-    /** Cache age / Время кэширования */
-    age?: number;
-    /** SameSite attribute / Атрибут SameSite */
-    sameSite?: CookieSameSite;
-    /** 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>;
-};
-/**
- * Class for managing cookie storage with support for custom listeners.
- * Useful for consistent cookie handling across different environments (DOM, SSR).
- *
- * Класс для управления хранением cookie с поддержкой пользовательских слушателей.
- * Полезен для консистентной работы с cookie в различных окружениях (DOM, SSR).
- */
-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, cookie: string, options?: CookieOptions) => void;
-    /**
-     * Initializes the storage with listeners.
-     *
-     * Инициализирует хранилище слушателями.
-     * @param getListener Storage mechanism for getting data / механизм хранения для получения данных
-     * @param getListenerRaw Storage mechanism for getting raw cookie string / механизм хранения для получения сырой строки cookie
-     * @param setListener Storage mechanism for setting data / механизм хранения для сохранения данных
-     */
-    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.
-     *
-     * Сбрасывает хранилище, очищая все элементы в памяти и сбрасывая слушатели.
-     */
-    static reset(): void;
-    /**
-     * Getting data from storage.
-     *
-     * Получение данных из хранилища.
-     * @param name cookie name / имя cookie
-     * @param defaultValue default value / значение по умолчанию
-     * @returns T | undefined cookie value or default/ значение cookie или значение по умолчанию
-     */
-    static get<T>(name: string, defaultValue?: T | (() => T)): T | undefined;
-    /**
-     * Saving data to storage.
-     *
-     * Сохранение данных в хранилище.
-     * @param name cookie name / имя cookie
-     * @param value data to be stored / данные для хранения
-     * @param options additional parameters / дополнительные параметры
-     * @returns stored value / сохраненное значение
-     */
-    static set<T>(name: string, value: T | (() => T), options?: CookieOptions): T;
-    /**
-     * Removing data from storage.
-     *
-     * Удаление данных из хранилища.
-     * @param name cookie name / имя cookie
-     * @returns void / ничего не возвращает
-     */
-    static remove(name: string): void;
-    /**
-     * Update data from cookies.
-     *
-     * Обновляет данные из 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.
-     *
-     * Проверяет, является ли текущее окружение DOM-окружением.
-     * @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.
-     *
-     * Инициализирует хранилище, если оно не инициализировано.
-     */
-    protected static initItems(): Record<string, any>;
-    /**
-     * Converts the value to a string for the max-age attribute.
-     *
-     * Преобразует значение в строку для атрибута max-age.
-     * @param stringValue cookie value / значение cookie
-     * @param age cache age (default: 7 days) / возраст кэша (по умолчанию: 7 дней)
-     */
-    protected static toMaxAge(stringValue: string, age?: CookieOptions['age']): string;
-    /**
-     * Converts the value to a string for the SameSite attribute.
-     *
-     * Преобразует значение в строку для атрибута SameSite.
-     * @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.
-     *
-     * Преобразует дополнительные аргументы в массив строк.
-     * @param args additional arguments / дополнительные аргументы
-     */
-    protected static toArguments(args?: CookieOptions['arguments']): string[];
-}

package/dist/classes/DataStorage.d.ts

@@ -1,107 +0,0 @@
-import { ErrorCenterInstance } from './ErrorCenterInstance';
-/**
- * Class for working with localStorage and sessionStorage.
- * Includes support for prefixes, expiration time, and request isolation in SSR.
- *
- * Класс для работы с localStorage и sessionStorage.
- * Включает поддержку префиксов, времени жизни данных и изоляцию запросов в SSR.
- */
-export declare class DataStorage<T> {
-    private name;
-    private isSession;
-    private errorCenter;
-    /**
-     * Changing the prefix in key names. Should be called at the beginning of the code.
-     *
-     * Изменение префикса в названиях ключей. Вызывать нужно в начале кода.
-     * @param newPrefix new prefix/ новый префикс
-     * @returns void / ничего не возвращает
-     */
-    static setPrefix(newPrefix: string): void;
-    /**
-     * The current value stored in memory/
-     * Текущее значение, хранящееся в памяти
-     */
-    private value?;
-    /**
-     * The timestamp of when the value was last saved/
-     * Временная метка последнего сохранения значения
-     */
-    private age?;
-    /**
-     * Constructor.
-     *
-     * Конструктор.
-     * @param name value name / название значения
-     * @param isSession should we use a session/ использовать ли сессию
-     * @param errorCenter error center instance/ экземпляр центра ошибок
-     */
-    constructor(name: string, isSession?: boolean, errorCenter?: ErrorCenterInstance);
-    /**
-     * Getting data from storage.
-     *
-     * Получение данных из хранилища.
-     * @param defaultValue default value / значение по умолчанию
-     * @param cache cache time in seconds / время кэширования в секундах
-     * @returns stored value or default value / сохраненное значение или значение по умолчанию
-     */
-    get(defaultValue?: T | (() => T), cache?: number): T | undefined;
-    /**
-     * Changing data in storage.
-     *
-     * Изменение данных в хранилище.
-     * @param value new values / новые значения
-     * @returns the set value / установленное значение
-     */
-    set(value?: T | (() => T)): T | undefined;
-    /**
-     * Removing data from storage.
-     *
-     * Удаление данных из хранилища.
-     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
-     */
-    remove(): this;
-    /**
-     * Syncing data from storage.
-     *
-     * Синхронизация данных из хранилища.
-     * @returns this instance / текущий экземпляр
-     */
-    update(): this;
-    /**
-     * Checks for storage time limit.
-     *
-     * Проверяет данные на истечение срока хранения (кэша).
-     * @param cache cache time in seconds / время кэширования в секундах
-     * @returns true if data is valid / true, если данные актуальны
-     */
-    private isCache;
-    /**
-     * Returns an object for working with storage (localStorage or sessionStorage).
-     *
-     * Возвращает объект для работы с хранилищем (localStorage или sessionStorage).
-     * @returns Storage object or undefined / объект Storage или undefined
-     */
-    private getMethod;
-    /**
-     * Getting the storage key name with prefix.
-     *
-     * Получение имени ключа в хранилище с учетом префикса.
-     * @returns key name / имя ключа
-     */
-    private getIndex;
-    /**
-     * Getting raw data from storage.
-     *
-     * Получение "сырых" данных из хранилища.
-     * @returns parsed data or undefined / распарсенные данные или undefined
-     */
-    private getValue;
-    /**
-     * Filling in the data from storage into memory.
-     *
-     * Заполнение данных из хранилища в память.
-     * @returns this instance / текущий экземпляр
-     */
-    private make;
-}