@dxtmisha/wiki 0.39.6 → 0.39.8

package/src/media/functional/functional-basic/classes/ApiCache/ApiCache.en.mdx

@@ -0,0 +1,111 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ApiCache - API Response Caching'/>
+
+# ApiCache Class
+
+A class for caching API responses. It allows storing query results in memory or an external storage, preventing redundant network calls within a specified period. In the current implementation, caching is active by default only on the server side (SSR) to speed up rendering and reduce API load during concurrent requests.
+
+> `ApiCache` is an **auxiliary class**, designed for low-level cache management. In most cases, it is recommended to interact with caching through the `cache` parameter in `ApiInstance` or the global `Api` object.
+
+## Key Features
+
+- **Automated Key Management** — generates unique cache keys based on request parameters (path, method, body, etc.).
+- **Flexible TTL (Time To Live)** — allows setting the storage duration for each request individually or using a default (24 hours).
+- **SSR Optimization** — prevents unnecessary API calls in the Node.js environment. Disabled by default in the browser (only works if explicitly enabled through configuration parameters).
+- **Listener Support** — ability to connect external storage (e.g., Redis, Nitro Storage) via callback functions.
+- **Background Cleanup** — automatically removes expired entries when accessing the cache.
+
+## Methods
+
+### Action
+
+Methods for managing cache entries.
+
+- `get<T>(key: string): Promise<T | undefined>` — Retrieves a value from the cache.
+- `getByFetch<T>(fetch: ApiFetch): Promise<T | undefined>` — Retrieves a value using request options as the key source.
+- `set<T>(key: string, value: T, age?: number): Promise<void>` — Stores a value in the cache.
+- `setByFetch<T>(fetch: ApiFetch, value: T): Promise<void>` — Stores a value using request options.
+- `remove(key: string): Promise<void>` — Manually removes an entry.
+
+### Configuration
+
+- `init(getListener, setListener, removeListener, cacheStepAgeClearOld?): void` — Configures the cache with storage listeners.
+- `reset(): void` — Clears in-memory items and detaches listeners.
+
+## Types
+
+#### `ApiCacheItem<T>`
+The structure of a cached record.
+- `value: T` — The cached data.
+- `age: number` — TTL in seconds.
+- `cacheAge: number` — Creation timestamp (ms).
+
+#### `ApiCacheList`
+An internal dictionary for in-memory storage fallback.
+- `[key: string]: ApiCacheItem` — Key-value pairs of cached items.
+
+## Initialization and External Storage
+
+By default, `ApiCache` stores records in the process RAM and works only on the server side. While this is fast, it has limitations in production environments:
+1. **Cluster Synchronization**: In a multi-instance setup, caches are not shared between processes.
+2. **Process Restarts**: Memory is cleared whenever the server restarts or a serverless function "cold starts".
+3. **Memory Limits**: Storing large amounts of data in RAM can lead to increased memory consumption.
+
+To solve these issues, you must initialize `ApiCache` with the `init` method, providing listeners that bridge it to an external storage mechanism.
+
+> Important: You must call `ApiCache.init()` during your application's bootstrap phase (before the first API request) to ensure the cache is correctly configured.
+
+### Node.js (Custom Storage)
+
+In a standard Node.js environment, you can use listeners to interact with a centralized database or a persistent cache like Redis.
+
+```typescript
+import { ApiCache } from '@dxtmisha/functional-basic'
+
+// Configuration with storage listeners
+ApiCache.init(
+  // 1. Get data from external storage
+  async (key) => await myExternalStorage.get(key),
+  
+  // 2. Save data to external storage
+  async (key, value) => {
+    await myExternalStorage.put(key, value)
+    return true // Return true to indicate successful external storage
+  },
+  
+  // 3. Remove data from external storage
+  async (key) => {
+    await myExternalStorage.delete(key)
+    return true
+  },
+  
+  // 4. Optional: threshold for background cleanup trigger
+  16384
+)
+```
+
+### Nuxt / Nitro
+
+In Nuxt/Nitro, the recommended approach is to use the built-in `useStorage` helper within a server plugin. This allows you to leverage Redis, FS, or other Nitro-supported storage drivers.
+
+```typescript
+// server/plugins/api-cache.ts
+import { ApiCache } from '@dxtmisha/functional-basic'
+
+export default defineNitroPlugin(() => {
+  const storage = useStorage('cache') // Nitro Cache region
+
+  ApiCache.init(
+    async (key) => await storage.getItem(key),
+    async (key, value) => {
+      await storage.setItem(key, value)
+      return true
+    },
+    async (key) => {
+      await storage.removeItem(key)
+      return true
+    }
+  )
+})
+```

package/src/media/functional/functional-basic/classes/ApiCache/ApiCache.ru.mdx

@@ -0,0 +1,111 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiCache - Кэширование ответов API'/>
+
+# Класс ApiCache
+
+Класс для кэширования ответов API. Он позволяет сохранять результаты запросов в памяти или во внешнем хранилище, предотвращая избыточные сетевые вызовы в течение заданного периода. В текущей реализации кэширование по умолчанию активно только на стороне сервера (SSR) для ускорения рендеринга и снижения нагрузки на API при одновременных запросах.
+
+> `ApiCache` является **вспомогательным классом**, предназначенным для низкоуровневого управления кэшем. В большинстве случаев рекомендуется взаимодействовать с кэшированием через параметр `cache` в `ApiInstance` или глобальный объект `Api`.
+
+## Основные возможности
+
+- **Автоматическое управление ключами** — генерирует уникальные ключи кэша на основе параметров запроса (путь, метод, тело запроса и т.д.).
+- **Гибкий TTL (Time To Live)** — позволяет устанавливать время хранения для каждого запроса индивидуально или использовать значение по умолчанию (24 часа).
+- **Оптимизация SSR** — предотвращает ненужные вызовы API в среде Node.js. По умолчанию отключено в браузере (работает только если явно включено через параметры конфигурации).
+- **Поддержка слушателей** — возможность подключения внешнего хранилища (например, Redis, Nitro Storage) через функции обратного вызова.
+- **Фоновая очистка** — автоматически удаляет устаревшие записи при обращении к кэшу.
+
+## Методы
+
+### Действие
+
+Методы для управления записями кэша.
+
+- `get<T>(key: string): Promise<T | undefined>` — Извлекает значение из кэша.
+- `getByFetch<T>(fetch: ApiFetch): Promise<T | undefined>` — Извлекает значение, используя опции запроса как источник ключа.
+- `set<T>(key: string, value: T, age?: number): Promise<void>` — Сохраняет значение в кэше.
+- `setByFetch<T>(fetch: ApiFetch, value: T): Promise<void>` — Сохраняет значение на основе опций запроса.
+- `remove(key: string): Promise<void>` — Удаляет запись вручную.
+
+### Конфигурация
+
+- `init(getListener, setListener, removeListener, cacheStepAgeClearOld?): void` — Настраивает кэш слушателями хранилища.
+- `reset(): void` — Очищает элементы в памяти и отключает слушателей.
+
+## Типы данных
+
+#### `ApiCacheItem<T>`
+Структура кэшированной записи.
+- `value: T` — Значение данных.
+- `age: number` — TTL в секундах.
+- `cacheAge: number` — Метка времени создания (мс).
+
+#### `ApiCacheList`
+Внутренний словарь для резервного хранения в оперативной памяти.
+- `[key: string]: ApiCacheItem` — Пары ключ-значение кэшированных элементов.
+
+## Инициализация и внешнее хранилище
+
+По умолчанию `ApiCache` сохраняет записи в оперативной памяти (RAM) процесса и работает только на стороне сервера. Хотя это очень быстро, в продуктовой среде такой подход имеет ограничения:
+1. **Синхронизация в кластере**: В многоэкземплярной конфигурации кэши не разделяются между процессами.
+2. **Перезагрузка процесса**: Память очищается при каждом перезапуск сервера или «холодном старте» серверных функций.
+3. **Лимиты памяти**: Хранение больших объемов данных в RAM может привести к чрезмерному потреблению ресурсов.
+
+Для решения этих задач необходимо инициализировать `ApiCache` с помощью метода `init`, предоставив слушателей (listeners) для связи с внешним механизмом хранения.
+
+> Важно: Метод `ApiCache.init()` должен быть вызван на этапе запуска приложения (до первого API-запроса), чтобы гарантировать правильную конфигурацию кэша.
+
+### Node.js (Произвольное хранилище)
+
+В стандартной среде Node.js вы можете использовать слушателей для взаимодействия с централизованной базой данных или персистентным кэшем, таким как Redis.
+
+```typescript
+import { ApiCache } from '@dxtmisha/functional-basic'
+
+// Конфигурация со слушателями хранилища
+ApiCache.init(
+  // 1. Получение данных из внешнего хранилища
+  async (key) => await myExternalStorage.get(key),
+  
+  // 2. Сохранение данных во внешнее хранилище
+  async (key, value) => {
+    await myExternalStorage.put(key, value)
+    return true // Возвращаем true для подтверждения внешнего сохранения
+  },
+  
+  // 3. Удаление данных из внешнего хранилища
+  async (key) => {
+    await myExternalStorage.delete(key)
+    return true
+  },
+  
+  // 4. Опционально: порог срабатывания фоновой очистки
+  16384
+)
+```
+
+### Nuxt / Nitro
+
+В Nuxt/Nitro рекомендуемый подход — использование встроенного хелпера `useStorage` внутри серверного плагина. Это позволяет задействовать Redis, файловую систему или любой другой драйвер, поддерживаемый Nitro.
+
+```typescript
+// server/plugins/api-cache.ts
+import { ApiCache } from '@dxtmisha/functional-basic'
+
+export default defineNitroPlugin(() => {
+  const storage = useStorage('cache') // Регион кэша Nitro
+
+  ApiCache.init(
+    async (key) => await storage.getItem(key),
+    async (key, value) => {
+      await storage.setItem(key, value)
+      return true
+    },
+    async (key) => {
+      await storage.removeItem(key)
+      return true
+    }
+  )
+})
+```

package/src/media/functional/functional-basic/classes/ApiCache/ApiCache.vi.mdx

@@ -0,0 +1,111 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiCache - Bộ nhớ đệm phản hồi API'/>
+
+# Lớp ApiCache
+
+Một lớp để lưu bộ nhớ đệm (caching) cho các phản hồi API. Nó cho phép lưu trữ kết quả truy vấn trong bộ nhớ hoặc kho lưu trữ bên ngoài, ngăn chặn các cuộc gọi mạng dư thừa trong một khoảng thời gian cụ thể. Trong phiên bản hiện tại, việc lưu bộ nhớ đệm chỉ hoạt động ở phía máy chủ (SSR) để tăng tốc độ hiển thị và giảm tải API trong quá trình xử lý nhiều yêu cầu đồng thời.
+
+> `ApiCache` là một **lớp bổ trợ**, được thiết kế để quản lý bộ nhớ đệm ở cấp độ thấp. Trong hầu hết các trường hợp, bạn nên tương tác với việc lưu bộ nhớ đệm thông qua tham số `cache` trong `ApiInstance` hoặc đối tượng `Api` toàn cục.
+
+## Các tính năng chính
+
+- **Quản lý khóa tự động** — tạo các khóa cache duy nhất dựa trên các tham số yêu cầu (đường dẫn, phương thức, thân yêu cầu, v.v.).
+- **TTL linh hoạt (Time To Live)** — cho phép thiết lập thời gian lưu trữ cho từng yêu cầu riêng lẻ hoặc sử dụng mặc định (24 giờ).
+- **Tối ưu hóa SSR** — ngăn chặn các cuộc gọi API không cần thiết trong môi trường Node.js. Chế độ này mặc định bị tắt trong trình duyệt.
+- **Hỗ trợ Bộ lắng nghe (Listener)** — khả năng kết nối kho lưu trữ bên ngoài (ví dụ: Redis, Nitro Storage) thông qua các hàm callback.
+- **Dọn dẹp chạy ngầm** — tự động xóa các mục đã hết hạn khi truy cập bộ nhớ đệm.
+
+## Các phương thức
+
+### Hành động
+
+Các phương thức để quản lý các mục lưu trữ trong cache.
+
+- `get<T>(key: string): Promise<T | undefined>` — Lấy một giá trị từ cache.
+- `getByFetch<T>(fetch: ApiFetch): Promise<T | undefined>` — Lấy một giá trị sử dụng các tùy chọn yêu cầu làm nguồn tạo khóa.
+- `set<T>(key: string, value: T, age?: number): Promise<void>` — Lưu một giá trị vào cache.
+- `setByFetch<T>(fetch: ApiFetch, value: T): Promise<void>` — Lưu một giá trị dựa trên các tùy chọn yêu cầu.
+- `remove(key: string): Promise<void>` — Xóa một mục cache thủ công.
+
+### Cấu hình
+
+- `init(getListener, setListener, removeListener, cacheStepAgeClearOld?): void` — Cấu hình cache với các listener của bộ lưu trữ.
+- `reset(): void` — Xóa các mục trong bộ nhớ RAM và ngắt kết nối các listener.
+
+## Các kiểu dữ liệu
+
+#### `ApiCacheItem<T>`
+Cấu trúc của một bản ghi trong bộ nhớ đệm.
+- `value: T` — Dữ liệu được lưu.
+- `age: number` — TTL tính bằng giây.
+- `cacheAge: number` — Dấu thời gian (ms) khi bản ghi được tạo.
+
+#### `ApiCacheList`
+Từ điển nội bộ dành cho việc lưu trữ dự phòng trong bộ nhớ RAM.
+- `[key: string]: ApiCacheItem` — Các cặp khóa-giá trị của các mục được lưu vào bộ nhớ đệm.
+
+## Khởi tạo và Kho lưu trữ bên ngoài
+
+Theo mặc định, `ApiCache` lưu trữ các bản ghi trong RAM của tiến trình. Mặc dù cách này rất nhanh, nhưng nó có những hạn chế khi triển khai thực tế:
+1. **Đồng bộ hóa trong cụм (Cluster)**: Trong thiết lập đa thực thể, bộ nhớ đệm không được chia sẻ giữa các tiến trình.
+2. **Khởi động lại tiến trình**: Bộ nhớ sẽ bị xóa bất khi nào máy chủ khởi động lại hoặc có một "cold start" của các hàm serverless.
+3. **Giới hạn bộ nhớ**: Lưu trữ lượng lớn dữ liệu trong RAM có thể dẫnถึง việc tiêu thụ bộ nhớ quá mức.
+
+Để giải quyết những vấn đề này, bạn phải khởi tạo `ApiCache` bằng phương thức `init`, cung cấp các bộ lắng nghe (listeners) đóng vai trò cầu nối với cơ chế lưu trữ bên ngoài.
+
+> Quan trọng: Bạn phải gọi `ApiCache.init()` trong giai đoạn khởi tạo ứng dụng (trước yêu cầu API đầu tiên) để đảm bảo bộ nhớ đệm được cấu hình chính xác.
+
+### Node.js (Kho lưu trữ tùy chỉnh)
+
+Trong môi trường Node.js tiêu chuẩn, bạn có thể sử dụng các bộ lắng nghe để tương tác với một cơ sở dữ liệu tập trung hoặc một bộ nhớ đệm bền vững như Redis.
+
+```typescript
+import { ApiCache } from '@dxtmisha/functional-basic'
+
+// Cấu hình với các bộ lắng nghe lưu trữ
+ApiCache.init(
+  // 1. Lấy dữ liệu từ kho lưu trữ bên ngoài
+  async (key) => await myExternalStorage.get(key),
+  
+  // 2. Lưu dữ liệu vào kho lưu trữ bên ngoài
+  async (key, value) => {
+    await myExternalStorage.put(key, value)
+    return true // Trả về true để xác nhận đã lưu trữ bên ngoài thành công
+  },
+  
+  // 3. Xóa dữ liệu khỏi kho lưu trữ bên ngoài
+  async (key) => {
+    await myExternalStorage.delete(key)
+    return true
+  },
+  
+  // 4. Tùy chọn: ngưỡng kích hoạt dọn dẹp chạy ngầm
+  16384
+)
+```
+
+### Nuxt / Nitro
+
+Trong Nuxt/Nitro, cách tiếp cận được khuyến nghị là sử dụng helper `useStorage` tích hợp sẵn bên trong một plugin máy chủ. Điều này cho phép bạn tận dụng Redis, FS, hoặc bất kỳ trình điều khiển lưu trữ nào khác được Nitro hỗ trợ.
+
+```typescript
+// server/plugins/api-cache.ts
+import { ApiCache } from '@dxtmisha/functional-basic'
+
+export default defineNitroPlugin(() => {
+  const storage = useStorage('cache') // Nitro Cache region
+
+  ApiCache.init(
+    async (key) => await storage.getItem(key),
+    async (key, value) => {
+      await storage.setItem(key, value)
+      return true
+    },
+    async (key) => {
+      await storage.removeItem(key)
+      return true
+    }
+  )
+})
+```

package/src/media/functional/functional-basic/classes/ApiDataReturn/ApiDataReturn.en.mdx

@@ -0,0 +1,32 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ApiDataReturn - API Response Data Processing'/>
+
+# ApiDataReturn Class
+
+A class for handling and processing data received from an API request. It transforms raw response data into a structured format, extracts metadata, and maps content according to the requested configuration.
+
+> `ApiDataReturn` is an **auxiliary class**, designed for handling and formatting API response data. In most cases, it is recommended to interact with results through the response returned by `ApiInstance` methods or the global `Api` object.
+
+## Key Features
+
+- **Automated Parsing** — intelligently parses JSON responses or returns raw text based on Content-Type headers.
+- **Data Normalization** — ensures that the returned object follows a consistent structure, even if the server response varies.
+- **Metadata Extraction** — automatically extracts common fields like `success`, `status`, `code`, and `message` from the root of the response and merges them into the data object.
+- **Flexible Configuration** — supports custom processing logic via `queryReturn` and controls whether to unwrap the `data` field using `toData`.
+
+## Methods
+
+### Action
+
+- `async init(): Promise<this>` — Initializes the class by reading and parsing data from the response object.
+- `get(): ApiData<T>` — Returns the processed and formatted data.
+- `getAndStatus(status: ApiStatus): ApiData<T>` — Returns the processed data injected with a `statusObject` from the provided status instance.
+- `getData(): ApiData<T> | undefined` — Returns the raw, unformatted data as initially read from the response.
+
+## Internal Logic (Protected)
+
+- `readData<T>(): Promise<ApiData<T>>` — Low-level method that reads the response body and parses it as JSON or text.
+- `initData(): ApiData<T>` — Formats the raw data according to configuration, handling property unwrapping.
+- `initItem(data: Record<string, any>): ApiData<T>` — Merges metadata fields from the response root into the main data object.
+

package/src/media/functional/functional-basic/classes/ApiDataReturn/ApiDataReturn.ru.mdx

@@ -0,0 +1,32 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiDataReturn - Обработка данных ответа API'/>
+
+# Класс ApiDataReturn
+
+Класс для обработки и подготовки данных, полученных в результате запроса к API. Он преобразует необработанные данные ответа в структурированный формат, извлекает метаданные и сопоставляет содержимое в соответствии с запрошенной конфигурацией.
+
+> `ApiDataReturn` является **вспомогательным классом**, предназначенным для обработки и форматирования данных ответа API. В большинстве случаев рекомендуется взаимодействовать с результатами через ответ, возвращаемый методами `ApiInstance` или глобальным объектом `Api`.
+
+## Ключевые особенности
+
+- **Автоматический парсинг** — интеллектуально анализирует JSON-ответы или возвращает необработанный текст на основе заголовков Content-Type.
+- **Нормализация данных** — гарантирует, что возвращаемый объект соответствует согласованной структуре, даже если ответ сервера различается.
+- **Извлечение метаданных** — автоматически извлекает общие поля, такие как `success`, `status`, `code` и `message`, из корня ответа и объединяет их с объектом данных.
+- **Гибкая конфигурация** — поддерживает пользовательскую логику обработки через `queryReturn` и управляет развертыванием поля `data` с помощью `toData`.
+
+## Методы
+
+### Действие
+
+- `async init(): Promise<this>` — Инициализирует класс, считывая и анализируя данные из объекта ответа.
+- `get(): ApiData<T>` — Возвращает обработанные и отформатированные данные.
+- `getAndStatus(status: ApiStatus): ApiData<T>` — Возвращает обработанные данные с внедренным объектом `statusObject` из предоставленного экземпляра статуса.
+- `getData(): ApiData<T> | undefined` — Возвращает исходные, неотформатированные данные, как они были изначально считаны из ответа.
+
+## Внутренняя логика (Protected)
+
+- `readData<T>(): Promise<ApiData<T>>` — Низкоуровневый метод, который считывает тело ответа и парсит его как JSON или текст.
+- `initData(): ApiData<T>` — Форматирует необработанные данные в соответствии с конфигурацией, обрабатывая развертывание свойств.
+- `initItem(data: Record<string, any>): ApiData<T>` — Переносит поля метаданных из корня ответа в основной объект данных.
+

package/src/media/functional/functional-basic/classes/ApiDataReturn/ApiDataReturn.vi.mdx

@@ -0,0 +1,32 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiDataReturn - Xử lý dữ liệu phản hồi API'/>
+
+# Lớp ApiDataReturn
+
+Lớp dùng để xử lý và chuẩn bị dữ liệu nhận được từ yêu cầu API. Nó chuyển đổi dữ liệu phản hồi thô thành định dạng có cấu trúc, trích xuất metadata và ánh xạ nội dung theo cấu hình đã yêu cầu.
+
+> `ApiDataReturn` là một **lớp phụ trợ**, được thiết kế để xử lý và định dạng dữ liệu phản hồi API. Trong hầu hết các trường hợp, khuyến khích tương tác với kết quả thông qua phản hồi được trả về bởi các phương thức của `ApiInstance` hoặc đối tượng `Api` toàn cục.
+
+## Các tính năng chính
+
+- **Phân tích tự động** — phân tích thông minh các phản hồi JSON hoặc trả về văn bản thô dựa trên tiêu đề Content-Type.
+- **Chuẩn hóa dữ liệu** — đảm bảo rằng đối tượng trả về tuân theo một cấu trúc nhất quán, ngay cả khi phản hồi của máy chủ thay đổi.
+- **Trích xuất Metadata** — tự động trích xuất các trường chung như `success`, `status`, `code` và `message` từ gốc của phản hồi và hợp nhất chúng vào đối tượng dữ liệu.
+- **Cấu hình linh hoạt** — hỗ trợ logic xử lý tùy chỉnh thông qua `queryReturn` và kiểm soát việc giải nén trường `data` bằng `toData`.
+
+## Các phương thức
+
+### Hành động
+
+- `async init(): Promise<this>` — Khởi tạo lớp bằng cách đọc và phân tích dữ liệu từ đối tượng phản hồi.
+- `get(): ApiData<T>` — Trả về dữ liệu đã được xử lý và định dạng.
+- `getAndStatus(status: ApiStatus): ApiData<T>` — Trả về dữ liệu đã xử lý được chèn thêm `statusObject` từ đối tượng status được cung cấp.
+- `getData(): ApiData<T> | undefined` — Trả về dữ liệu thô, chưa định dạng như lúc ban đầu được đọc từ phản hồi.
+
+## Logic nội bộ (Protected)
+
+- `readData<T>(): Promise<ApiData<T>>` — Phương thức cấp thấp đọc thân phản hồi và phân tích nó dưới dạng JSON hoặc văn bản.
+- `initData(): ApiData<T>` — Định dạng dữ liệu thô theo cấu hình, xử lý việc giải nén các thuộc tính.
+- `initItem(data: Record<string, any>): ApiData<T>` — Hợp nhất các trường metadata từ gốc phản hồi vào đối tượng dữ liệu chính.
+

package/src/media/functional/functional-basic/classes/ApiDefault/ApiDefault.en.mdx

@@ -4,45 +4,41 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # ApiDefault Class
 
-A class for managing default data for API requests. It allows setting base parameters that should be included in every request, supporting both standard objects and `FormData`.
+A class for managing default data for API requests. It allows setting base parameters that should be included in every request, supporting both standard objects and `FormData`. This is useful for centrally defining common fields such as tokens, application IDs, or localization settings.
 
-## Key Features
+> `ApiDefault` is an **auxiliary class**, designed for managing request defaults. In most cases, it is recommended to define these through the `requestDefault` parameter in the global `Api` configuration.
 
-- **Centralized Defaults** — define common parameters (like tokens or locale) once for all API calls.
-- **Support for Multiple Formats** — works seamlessly with both plain JavaScript objects and `FormData`.
-- **Intelligent Merging** — merges defaults with request-specific data, prioritizing the actual request data if keys overlap.
-- **Easy Checks** — simple methods to check if any default data is currently set.
+## Key Features
 
-## Initialization
+- **Centralized Defaults** — Define common parameters once for all API calls.
+- **Support for Multiple Formats** — Works seamlessly with both plain JavaScript objects and `FormData`.
+- **Intelligent Merging** — Merges defaults with request-specific data, prioritizing the actual request data if keys overlap.
+- **Chainable API** — Supports a fluent interface for setting parameters.
 
-To initialize the object, call the `ApiDefault()` constructor.
+## Methods
 
-```typescript
-import { ApiDefault } from '@dxtmisha/functional'
+### Action
 
-// 1. Simple initialization
-const apiDefault = new ApiDefault()
+#### `request`
 
-// 2. Setting default data
-apiDefault.set({ lang: 'en', version: 'v1' })
+Merges the stored default data into a provided request object or `FormData` instance. If the input is a plain object, it returns a new merged object. If the input is `FormData`, it adds missing keys directly to the instance.
 
-// 3. Example usage with a request object
-const requestData = { user_id: 5 }
-const mergedRequest = apiDefault.request(requestData)
-// Result: { lang: 'en', version: 'v1', user_id: 5 }
+**Parameters:**
+- `request: ApiFetch['request']` — The original request data (Object, FormData, or String).
 
-// 4. Example usage with FormData
-const fd = new FormData()
-fd.append('photo', fileBlob)
-apiDefault.request(fd)
-// Result: fd now contains 'lang' and 'version' if they were missing
-```
+**Returns:** `ApiFetch['request']` — The transformed request data.
 
-## Methods
+### Check
 
 - `is(): boolean` — Checks if any default data has been set.
-- `get(): ApiDefaultValue` — Returns the current default data.
-- `request(request: ApiFetch['request']): ApiFetch['request']` — Merges the stored default data into a provided request object or `FormData` instance.
-- `set(request: ApiDefaultValue)` — Sets the default data object for requests.
+- `get(): ApiDefaultValue | undefined` — Returns the current default data object.
+
+### Configuration
+
+- `set(request: ApiDefaultValue): this` — Sets the default data for all future requests.
 
+## Types
 
+#### `ApiDefaultValue`
+A plain object representing default parameters.
+- `[key: string]: any` — Key-value pairs to be used as defaults.

package/src/media/functional/functional-basic/classes/ApiDefault/ApiDefault.ru.mdx

@@ -4,45 +4,41 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс ApiDefault
 
-Класс для управления данными по умолчанию для API-запросов. Он позволяет устанавливать базовые параметры, которые должны быть включены в каждый запрос, поддерживая как стандартные объекты, так и `FormData`.
+Класс для управления данными по умолчанию для API-запросов. Он позволяет устанавливать базовые параметры, которые должны быть включены в каждый запрос, поддерживая как стандартные объекты, так и `FormData`. Это полезно для централизованного определения общих полей, таких как токены, ID приложения или настройки локализации.
 
-## Ключевые особенности
+> `ApiDefault` является **вспомогательным классом**, предназначенным для управления значениями по умолчанию в запросах. В большинстве случаев рекомендуется определять их через параметр `requestDefault` в глобальной конфигурации `Api`.
 
-- **Централизованные значения** — определите общие параметры (например, токены или локаль) один раз для всех вызовов API.
-- **Поддержка различных форматов** — бесшовно работает как с обычными объектами JavaScript, так и с `FormData`.
-- **Интеллектуальное слияние** — объединяет значения по умолчанию с данными конкретного запроса, отдавая приоритет данным запроса при совпадении ключей.
-- **Простые проверки** — удобные методы для проверки наличия установленных данных по умолчанию.
+## Ключевые особенности
 
-## Инициализация
+- **Централизованные значения** — Определите общие параметры один раз для всех вызовов API.
+- **Поддержка различных форматов** — Бесшовно работает как с обычными объектами JavaScript, так и с `FormData`.
+- **Интеллектуальное слияние** — Объединяет значения по умолчанию с данными конкретного запроса, отдавая приоритет данным запроса при совпадении ключей.
+- **Chainable API** — Поддерживает цепочку вызовов при установке параметров.
 
-Для инициализации объекта вызовите конструктор `ApiDefault()`.
+## Методы
 
-```typescript
-import { ApiDefault } from '@dxtmisha/functional'
+### Действие
 
-// 1. Простая инициализация
-const apiDefault = new ApiDefault()
+#### `request`
 
-// 2. Установка данных по умолчанию
-apiDefault.set({ lang: 'ru', version: 'v1' })
+Объединяет сохраненные данные по умолчанию с предоставленным объектом запроса или экземпляром `FormData`. Если входные данные являются объектом, метод возвращает новый объединенный объект. Если входные данные — `FormData`, недостающие ключи добавляются напрямую в экземпляр.
 
-// 3. Пример использования с объектом запроса
-const requestData = { user_id: 5 }
-const mergedRequest = apiDefault.request(requestData)
-// Результат: { lang: 'ru', version: 'v1', user_id: 5 }
+**Параметры:**
+- `request: ApiFetch['request']` — Исходные данные запроса (Object, FormData или String).
 
-// 4. Пример использования с FormData
-const fd = new FormData()
-fd.append('photo', fileBlob)
-apiDefault.request(fd)
-// Результат: fd теперь содержит 'lang' и 'version', если они отсутствовали
-```
+**Возвращает:** `ApiFetch['request']` — Трансформированные данные запроса.
 
-## Методы
+### Проверка
 
 - `is(): boolean` — Проверяет, были ли установлены какие-либо данные по умолчанию.
-- `get(): ApiDefaultValue` — Возвращает текущие данные по умолчанию.
-- `request(request: ApiFetch['request']): ApiFetch['request']` — Объединяет сохраненные данные по умолчанию с предоставленным объектом запроса или экземпляром `FormData`.
-- `set(request: ApiDefaultValue)` — Устанавливает объект данных по умолчанию для всех запросов.
+- `get(): ApiDefaultValue | undefined` — Возвращает текущий объект данных по умолчанию.
+
+### Конфигурация
+
+- `set(request: ApiDefaultValue): this` — Устанавливает данные по умолчанию для всех будущих запросов.
 
+## Типы
 
+#### `ApiDefaultValue`
+Обычный объект, представляющий параметры по умолчанию.
+- `[key: string]: any` — Пары ключе-значение, используемые по умолчанию.