@dxtmisha/wiki 0.59.1 → 0.65.0

package/src/media/functional/functional/dxt-functional-plugin/dxt-functional-plugin.en.mdx

@@ -28,7 +28,20 @@ const functionalOptions: FunctionalPluginOptions = {
   // Suffix to be appended to all page <title>
   metaSuffix: ' | My App',
   // Pass the router so services can access navigation
-  router
+  router,
+  // Error causes for error center
+  errorCauses: [
+    { code: 'access_denied', message: 'Access denied' }
+  ],
+  // Error handlers
+  errorHandlers: [
+    {
+      group: 'auth',
+      handlers: [
+        (cause) => console.error('Auth error:', cause.message)
+      ]
+    }
+  ]
 }
 
 // Use functional plugin
@@ -46,7 +59,8 @@ When you call `app.use(dxtFunctionalPlugin)`, the following steps occur automati
 3. **`Icons` Initialization**: Configures the global SVG icon registry.
 4. **`Meta` Initialization**: Automatically sets the browser tab suffix (via `useMeta().setSuffix()`) if provided.
 5. **Vue Router Integration**: Globally registers the router object in the library's memory (`RouterItemRef`), allowing other functional services to use navigation even outside Vue components.
-6. **`executeUseGlobalInit()` Execution**: Automatically triggers the initialization of absolutely all global singletons created via `executeUseGlobal`. You no longer need to call it manually!
+6. **`ErrorCenter` Setup**: Configures predefined error causes (`ErrorCenter.addList`) and registers global error handlers (`ErrorCenter.addHandlerList`) in the central error registry.
+7. **`executeUseGlobalInit()` Execution**: Automatically triggers the initialization of absolutely all global singletons created via `executeUseGlobal`. You no longer need to call it manually!
 
 ## Service Configuration
 

package/src/media/functional/functional/dxt-functional-plugin/dxt-functional-plugin.ru.mdx

@@ -28,7 +28,20 @@ const functionalOptions: FunctionalPluginOptions = {
   // Суффикс, который будет добавляться ко всем <title> страниц
   metaSuffix: ' | Мое приложение',
   // Передача роутера для работы навигации внутри сервисов
-  router
+  router,
+  // Причины ошибок для центра ошибок
+  errorCauses: [
+    { code: 'access_denied', message: 'Доступ ограничен' }
+  ],
+  // Обработчики ошибок
+  errorHandlers: [
+    {
+      group: 'auth',
+      handlers: [
+        (cause) => console.error('Ошибка авторизации:', cause.message)
+      ]
+    }
+  ]
 }
 
 // Подключаем функциональный плагин
@@ -46,7 +59,8 @@ app.mount('#app')
 3. **Инициализация `Icons`**: Запускает конфигурацию глобального реестра иконок (SVG).
 4. **Инициализация `Meta`**: Автоматически прописывает суффикс вкладки браузера (через `useMeta().setSuffix()`), если он был передан.
 5. **Интеграция с Vue Router**: Глобально регистрирует объект роутера в памяти библиотеки (`RouterItemRef`), чтобы другие функциональные сервисы имели доступ к навигации даже за пределами компонентов.
-6. **Запуск `executeUseGlobalInit()`**: Автоматически триггерит инициализацию абсолютно всех глобальных синглтонов на базе `executeUseGlobal`. Заботиться о ручном вызове больше не нужно!
+6. **Настройка `ErrorCenter`**: Настраивает предопределенный список причин ошибок (`ErrorCenter.addList`) и регистрирует обработчики (`ErrorCenter.addHandlerList`) в едином хранилище.
+7. **Запуск `executeUseGlobalInit()`**: Автоматически триггерит инициализацию абсолютно всех глобальных синглтонов на базе `executeUseGlobal`. Заботиться о ручном вызове больше не нужно!
 
 ## Конфигурация сервисов
 

package/src/media/functional/functional/dxt-functional-plugin/dxt-functional-plugin.vi.mdx

@@ -28,7 +28,20 @@ const functionalOptions: FunctionalPluginOptions = {
   // Hậu tố được thêm vào sau bất cứ thẻ <title> nào của trang web
   metaSuffix: ' | Ứng Dụng Của Tôi',
   // Truyền đối tượng router để các dịch vụ nhận biết hệ thống điều hướng
-  router
+  router,
+  // Các nguyên nhân lỗi cho trung tâm lỗi
+  errorCauses: [
+    { code: 'access_denied', message: 'Truy cập bị từ chối' }
+  ],
+  // Các trình xử lý lỗi
+  errorHandlers: [
+    {
+      group: 'auth',
+      handlers: [
+        (cause) => console.error('Lỗi xác thực:', cause.message)
+      ]
+    }
+  ]
 }
 
 // Bật plugin chức năng
@@ -46,7 +59,8 @@ Lúc bạn kích hoạt `app.use(dxtFunctionalPlugin)`, các giải đoạn tu
 3. **Khởi Chạy `Icons`**: Kết nối và điều hướng kho lưu trữ các tập SVG hình tượng biểu trưng toàn cục.
 4. **Khởi Chạy `Meta`**: Khởi thiết lập hậu tố trực tiếp trên tab trình duyệt (sử dụng hàm `useMeta().setSuffix()`) nếu trường này được kê khai.
 5. **Cộng Giao Động Vue Router**: Nạp đối tượng định tuyến này vào mạng lưới dữ liệu riêng của bộ thư viện (`RouterItemRef`), biến các chức năng điều khiển trở thành có thể dùng chung mở cho những dịch vụ khác dẫu là nằm tách khỏi phạm vi một component Vue.
-6. **Bật `executeUseGlobalInit()` chạy thi hành**: Đánh thức một lần tự khởi điểm duy nhất hoàn toàn những global singletons đứng ở nền móng `executeUseGlobal`. Chấm dứt thao tác bạn cất công truy xuất thủ công.
+6. **Thiết lập `ErrorCenter`**: Cấu hình danh sách các nguyên nhân lỗi định trước (`ErrorCenter.addList`) và đăng ký các hàm xử lý lỗi toàn cục (`ErrorCenter.addHandlerList`) vào kho lưu trữ lỗi tập trung.
+7. **Bật `executeUseGlobalInit()` chạy thi hành**: Đánh thức một lần tự khởi điểm duy nhất hoàn toàn những global singletons đứng ở nền móng `executeUseGlobal`. Chấm dứt thao tác bạn cất công truy xuất thủ công.
 
 ## Tinh Chỉnh Dịch Vụ Mở Rộng
 

package/src/media/functional/functional/functions/dxtFunctionalPlugin/dxtFunctionalPlugin.en.mdx

@@ -43,7 +43,8 @@ When the plugin is installed, it performs the following steps in order:
 3.  **Icons**: Calls `Icons.setConfig()` with the provided `IconsConfig`.
 4.  **Meta**: Configures the default title suffix via `useMeta().setSuffix()`.
 5.  **Router**: Registers the router instance in `RouterItemRef`, making it accessible globally.
-6.  **executeUseGlobalInit**: Triggers the batch initialization of all global singletons defined using `executeUseGlobal`.
+6.  **ErrorCenter**: Configures the predefined list of error causes via `ErrorCenter.addList()` and registers error handlers via `ErrorCenter.addHandlerList()`.
+7.  **executeUseGlobalInit**: Triggers the batch initialization of all global singletons defined using `executeUseGlobal`.
 
 ## Data Types
 
@@ -56,6 +57,8 @@ The plugin uses the following interfaces for configuration:
 - `icons?: IconsConfig` — Configuration for the global `Icons` registry.
 - `metaSuffix?: string` — A string that will be appended to all page titles set via `useMeta()`.
 - `router?: Router` — The Vue Router instance. If omitted, the plugin will attempt to extract it from `app.config.globalProperties.$router`.
+- `errorCauses?: ErrorCenterCauseList` — Predefined list of error causes for `ErrorCenter`.
+- `errorHandlers?: ErrorCenterHandlerList` — List of error handlers for `ErrorCenter`.
 
 ### `ApiConfig`
 

package/src/media/functional/functional/functions/dxtFunctionalPlugin/dxtFunctionalPlugin.ru.mdx

@@ -43,7 +43,8 @@ app.mount('#app')
 3.  **Icons**: Вызывает `Icons.setConfig()` с предоставленным `IconsConfig`.
 4.  **Meta**: Настраивает суффикс заголовка по умолчанию через `useMeta().setSuffix()`.
 5.  **Router**: Регистрирует экземпляр роутера в `RouterItemRef`, делая его доступным глобально.
-6.  **executeUseGlobalInit**: Запускает пакетную инициализацию всех глобальных синглтонов, определенных с помощью `executeUseGlobal`.
+6.  **ErrorCenter**: Настраивает предопределенный список причин ошибок через `ErrorCenter.addList()` и регистрирует обработчики через `ErrorCenter.addHandlerList()`.
+7.  **executeUseGlobalInit**: Запускает пакетную инициализацию всех глобальных синглтонов, определенных с помощью `executeUseGlobal`.
 
 ## Типы данных
 
@@ -56,6 +57,8 @@ app.mount('#app')
 - `icons?: IconsConfig` — Конфигурация для глобального реестра иконок `Icons`.
 - `metaSuffix?: string` — Строка, которая будет добавлена ко всем заголовкам страниц, установленным через `useMeta()`.
 - `router?: Router` — Экземпляр Vue Router. Если не указан, плагин попытается извлечь его из `app.config.globalProperties.$router`.
+- `errorCauses?: ErrorCenterCauseList` — Список предопределенных причин ошибок для `ErrorCenter`.
+- `errorHandlers?: ErrorCenterHandlerList` — Список обработчиков ошибок для `ErrorCenter`.
 
 ### `ApiConfig`
 

package/src/media/functional/functional/functions/dxtFunctionalPlugin/dxtFunctionalPlugin.vi.mdx

@@ -43,7 +43,8 @@ Khi plugin được cài đặt, nó thực hiện các bước sau theo thứ t
 3.  **Icons**: Gọi `Icons.setConfig()` với `IconsConfig` được cung cấp.
 4.  **Meta**: Cấu hình hậu tố cho tiêu đề thông qua `useMeta().setSuffix()`.
 5.  **Router**: Đăng ký router vào `RouterItemRef`, giúp có thể truy cập toàn cục.
-6.  **executeUseGlobalInit**: Kích hoạt quá trình khởi tạo hàng loạt cho tất cả các đối tượng đơn lẻ được định nghĩa thông qua `executeUseGlobal`.
+6.  **ErrorCenter**: Cấu hình danh sách nguyên nhân lỗi định trước thông qua `ErrorCenter.addList()` và đăng ký các trình xử lý lỗi thông qua `ErrorCenter.addHandlerList()`.
+7.  **executeUseGlobalInit**: Kích hoạt quá trình khởi tạo hàng loạt cho tất cả các đối tượng đơn lẻ được định nghĩa thông qua `executeUseGlobal`.
 
 ## Các kiểu dữ liệu
 
@@ -56,6 +57,8 @@ Plugin sử dụng các giao diện (interface) sau để cấu hình:
 - `icons?: IconsConfig` — Cấu hình cho cơ sở dữ liệu biểu tượng `Icons` toàn cục.
 - `metaSuffix?: string` — Chuỗi hậu tố sẽ được thêm vào tất cả tiêu đề trang được thiết lập thông qua `useMeta()`.
 - `router?: Router` — Thực thể Vue Router. Nếu bỏ qua, plugin sẽ cố gắng lấy nó từ `app.config.globalProperties.$router`.
+- `errorCauses?: ErrorCenterCauseList` — Danh sách các nguyên nhân lỗi định trước cho `ErrorCenter`.
+- `errorHandlers?: ErrorCenterHandlerList` — Danh sách các trình xử lý lỗi cho `ErrorCenter`.
 
 ### `ApiConfig`
 

package/src/media/functional/functional-basic/api/api.en.mdx

@@ -88,6 +88,45 @@ When forming the final URL, the class automatically replaces special markers wit
 // If the current locale is 'en-US', the final path will be '/api/en-US/users'
 const data = await Api.get({ path: '{locale}/users' })
 ```
+
+## Status and Meta-information
+
+The `Api` class automatically extracts metadata from the server response (e.g., `success`, `status`, `message`, `code`) and merges it with your data object. This allows you to receive both the payload and the execution result in a single object.
+
+You can access the full status of the last request via the `getStatus()` method, which returns an instance of `ApiStatus`.
+
+```javascript
+const data = await Api.get({ path: 'users' })
+const status = Api.getStatus()
+
+console.log(status.getStatus())     // 200 (HTTP Status)
+console.log(status.getStatusType()) // 'success' | 'error' | 'warning' | 'info'
+console.log(status.getMessage())    // Server-provided message or status text
+console.log(status.getResponse())   // Raw parsed response body
+```
+
+## Error Identification
+
+The library provides a sophisticated error management system via `ApiError`. You can pre-register known API error patterns, and the system will automatically identify them based on status, codes, or custom validation functions.
+
+```javascript
+import { ApiError, ApiMethodItem } from '@dxtmisha/functional-basic'
+
+// Registering a specific error pattern
+ApiError.add({
+  url: 'users/login',
+  method: ApiMethodItem.post,
+  code: 'INVALID_CREDENTIALS',
+  message: 'Please check your username and password.'
+})
+
+// Processing the request
+const status = Api.getStatus()
+const errorItem = status.get()?.errorObject // ApiErrorItem instance
+
+if (errorItem && errorItem.getCode() === 'INVALID_CREDENTIALS') {
+  // Handle specific error case
+}
 ```
 
 ## Lifecycle Hooks
@@ -215,3 +254,19 @@ Api.getResponse().setDevMode(true)
 ```
 
 The emulator triggers **before** the real `fetch` is executed. If no matching mock is found, `Api` will perform a regular network request.
+
+## Advanced: ApiInstance
+
+The `Api` class is a **static proxy** for a global instance of `ApiInstance`. This instance is stored in `ServerStorage`, ensuring isolation between requests during SSR and singleton behavior on the client.
+
+For advanced scenarios—such as connecting to multiple independent APIs simultaneously or creating temporary isolated environments—you can instantiate `ApiInstance` directly.
+
+```javascript
+import { ApiInstance } from '@dxtmisha/functional-basic'
+
+const secondaryApi = new ApiInstance()
+secondaryApi.setUrl('https://another-api.com/')
+secondaryApi.setHeaders({ 'X-Client-Id': '...' })
+
+const data = await secondaryApi.get({ path: 'resource' })
+```

package/src/media/functional/functional-basic/api/api.ru.mdx

@@ -88,6 +88,45 @@ Api.setConfig({
 // Если текущая локаль 'ru-RU', итоговый путь будет '/api/ru-RU/users'
 const data = await Api.get({ path: '{locale}/users' })
 ```
+
+## Статус и мета-информация
+
+Класс `Api` автоматически извлекает метаданные из ответа сервера (например, `success`, `status`, `message`, `code`) и объединяет их с вашим объектом данных. Это позволяет получать и полезную нагрузку, и результат выполнения в одном объекте.
+
+Вы можете получить полный статус последнего запроса через метод `getStatus()`, который возвращает экземпляр `ApiStatus`.
+
+```javascript
+const data = await Api.get({ path: 'users' })
+const status = Api.getStatus()
+
+console.log(status.getStatus())     // 200 (HTTP статус)
+console.log(status.getStatusType()) // 'success' | 'error' | 'warning' | 'info'
+console.log(status.getMessage())    // Сообщение от сервера или текст статуса
+console.log(status.getResponse())   // Исходное тело ответа после парсинга
+```
+
+## Идентификация ошибок
+
+Библиотека предоставляет продвинутую систему управления ошибками через `ApiError`. Вы можете заранее зарегистрировать известные паттерны ошибок API, и система автоматически идентифицирует их на основе статуса, кодов или кастомных функций валидации.
+
+```javascript
+import { ApiError, ApiMethodItem } from '@dxtmisha/functional-basic'
+
+// Регистрация конкретного паттерна ошибки
+ApiError.add({
+  url: 'users/login',
+  method: ApiMethodItem.post,
+  code: 'INVALID_CREDENTIALS',
+  message: 'Пожалуйста, проверьте логин и пароль.'
+})
+
+// При выполнении запроса
+const status = Api.getStatus()
+const errorItem = status.get()?.errorObject // Экземпляр ApiErrorItem
+
+if (errorItem && errorItem.getCode() === 'INVALID_CREDENTIALS') {
+  // Обработка конкретного случая ошибки
+}
 ```
 
 ## Хуки жизненного цикла
@@ -215,3 +254,19 @@ Api.getResponse().setDevMode(true)
 ```
 
 Эмулятор срабатывает **до** выполнения реального `fetch`. Если подходящий мок не найден, `Api` выполнит обычный сетевой запрос.
+
+## Продвинутое использование: ApiInstance
+
+Класс `Api` является **статическим прокси** для глобального экземпляра `ApiInstance`. Этот экземпляр хранится в `ServerStorage`, что обеспечивает изоляцию между запросами при SSR и поведение синглтона на клиенте.
+
+Для продвинутых сценариев — например, при необходимости работы с несколькими независимыми API одновременно или создания временных изолированных окружений — вы можете создавать экземпляры `ApiInstance` напрямую.
+
+```javascript
+import { ApiInstance } from '@dxtmisha/functional-basic'
+
+const secondaryApi = new ApiInstance()
+secondaryApi.setUrl('https://another-api.com/')
+secondaryApi.setHeaders({ 'X-Client-Id': '...' })
+
+const data = await secondaryApi.get({ path: 'resource' })
+```

package/src/media/functional/functional-basic/api/api.vi.mdx

@@ -88,6 +88,45 @@ Khi tạo URL cuối cùng, lớp sẽ tự động thay thế các nhãn đặc
 // Nếu locale hiện tại là 'vi-VN', đường dẫn cuối cùng sẽ là '/api/vi-VN/users'
 const data = await Api.get({ path: '{locale}/users' })
 ```
+
+## Trạng thái và Thông tin meta
+
+Lớp `Api` tự động trích xuất các siêu dữ liệu (metadata) từ phản hồi của máy chủ (ví dụ: `success`, `status`, `message`, `code`) và hợp nhất chúng với đối tượng dữ liệu của bạn. Điều này cho phép bạn nhận được cả nội dung dữ liệu và kết quả thực thi trong một đối tượng duy nhất.
+
+Bạn có thể truy cập trạng thái đầy đủ của yêu cầu cuối cùng thông qua phương thức `getStatus()`, phương thức này trả về một instance của `ApiStatus`.
+
+```javascript
+const data = await Api.get({ path: 'users' })
+const status = Api.getStatus()
+
+console.log(status.getStatus())     // 200 (Trạng thái HTTP)
+console.log(status.getStatusType()) // 'success' | 'error' | 'warning' | 'info'
+console.log(status.getMessage())    // Thông báo từ máy chủ hoặc văn bản trạng thái
+console.log(status.getResponse())   // Nội dung phản hồi thô đã được phân tích
+```
+
+## Nhận dạng lỗi
+
+Thư viện cung cấp một hệ thống quản lý lỗi tinh vi thông qua `ApiError`. Bạn có thể đăng ký trước các mẫu lỗi API đã biết, và hệ thống sẽ tự động xác định chúng dựa trên trạng thái, mã lỗi hoặc các hàm xác thực tùy chỉnh.
+
+```javascript
+import { ApiError, ApiMethodItem } from '@dxtmisha/functional-basic'
+
+// Đăng ký một mẫu lỗi cụ thể
+ApiError.add({
+  url: 'users/login',
+  method: ApiMethodItem.post,
+  code: 'INVALID_CREDENTIALS',
+  message: 'Vui lòng kiểm tra lại tên đăng nhập và mật khẩu.'
+})
+
+// Xử lý yêu cầu
+const status = Api.getStatus()
+const errorItem = status.get()?.errorObject // Instance ApiErrorItem
+
+if (errorItem && errorItem.getCode() === 'INVALID_CREDENTIALS') {
+  // Xử lý trường hợp lỗi cụ thể
+}
 ```
 
 ## Hook vòng đời
@@ -215,3 +254,19 @@ Api.getResponse().setDevMode(true)
 ```
 
 Trình giả lập sẽ kích hoạt **trước khi** lệnh `fetch` thực sự được thực hiện. Nếu không tìm thấy mock phù hợp, `Api` sẽ thực hiện một yêu cầu mạng thông thường.
+
+## Nâng cao: ApiInstance
+
+Lớp `Api` là một **static proxy** cho một instance toàn cục của `ApiInstance`. Instance này được lưu trữ trong `ServerStorage`, đảm bảo sự cô lập giữa các yêu cầu trong quá trình SSR và hành vi singleton trên máy khách.
+
+Đối với các kịch bản nâng cao—chẳng hạn như kết nối với nhiều API độc lập khác nhau cùng một lúc hoặc tạo các môi trường cô lập tạm thời—bạn có thể khởi tạo `ApiInstance` trực tiếp.
+
+```javascript
+import { ApiInstance } from '@dxtmisha/functional-basic'
+
+const secondaryApi = new ApiInstance()
+secondaryApi.setUrl('https://another-api.com/')
+secondaryApi.setHeaders({ 'X-Client-Id': '...' })
+
+const data = await secondaryApi.get({ path: 'resource' })
+```

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

@@ -0,0 +1,44 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ApiError - Error Utility (Static)'/>
+
+# ApiError Class
+
+The `ApiError` class is a **Primary Utility (Static)** for managing API error storage and identifying failures. It provides a centralized, singleton-based interface for registering error patterns and transforming raw network responses into structured `ApiErrorItem` objects.
+
+## Key Features
+
+- **Static Interface** — manage error criteria and analyze responses without manual instantiation.
+- **SSR-Safe Singleton** — utilizes `ServerStorage` to maintain isolated error storage across different requests during server-side rendering.
+- **Pattern Registration** — simple API for adding individual error patterns or bulk lists for global error identification.
+
+## Methods
+
+### Storage Management
+
+- `getStorage(): ApiErrorStorage` — Retrieves the internal singleton instance of the error storage.
+- `add(item: ApiErrorStorageItem | ApiErrorStorageList): void` — Adds one or more error patterns to the global storage.
+
+### Analysis
+
+#### `getItem`
+
+Analyzes a raw Fetch response and creates a structured `ApiErrorItem` instance. This is the primary method for processing API failures.
+
+**Parameters:**
+- `method: ApiMethodItem` — The HTTP method of the request.
+- `response: Response` — The raw Fetch response object.
+
+**Returns:** `Promise<ApiErrorItem>` — A structured error object containing analyzed details.
+
+```javascript
+try {
+  const response = await fetch('/api/user');
+  if (!response.ok) {
+    const errorItem = await ApiError.getItem(ApiMethodItem.get, response);
+    console.error(errorItem.getMessage());
+  }
+} catch (e) {
+  // Handle network error
+}
+```

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

@@ -0,0 +1,44 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiError - Утилита ошибок (Статическая)'/>
+
+# Класс ApiError
+
+Класс `ApiError` является **основной утилитой (статической)** для управления хранилищем ошибок API и идентификации сбоев. Он предоставляет централизованный синглтон-интерфейс для регистрации паттернов ошибок и преобразования сырых сетевых ответов в структурированные объекты `ApiErrorItem`.
+
+## Ключевые особенности
+
+- **Статический интерфейс** — управление критериями ошибок и анализ ответов без необходимости создания экземпляра класса.
+- **Безопасный синглтон для SSR** — использует `ServerStorage` для поддержания изолированного хранилища ошибок для разных запросов во время серверного рендеринга.
+- **Регистрация паттернов** — простой API для добавления отдельных паттернов ошибок или массовых списков для глобальной идентификации ошибок.
+
+## Методы
+
+### Управление хранилищем
+
+- `getStorage(): ApiErrorStorage` — Возвращает внутренний синглтон-экземпляр хранилища ошибок.
+- `add(item: ApiErrorStorageItem | ApiErrorStorageList): void` — Добавляет один или несколько паттернов ошибок в глобальное хранилище.
+
+### Анализ
+
+#### `getItem`
+
+Анализирует сырой ответ Fetch и создает структурированный экземпляр `ApiErrorItem`. Это основной метод для обработки сбоев API.
+
+**Параметры:**
+- `method: ApiMethodItem` — HTTP-метод запроса.
+- `response: Response` — Сырой объект ответа Fetch.
+
+**Возвращает:** `Promise<ApiErrorItem>` — Структурированный объект ошибки, содержащий проанализированные детали.
+
+```javascript
+try {
+  const response = await fetch('/api/user');
+  if (!response.ok) {
+    const errorItem = await ApiError.getItem(ApiMethodItem.get, response);
+    console.error(errorItem.getMessage());
+  }
+} catch (e) {
+  // Обработка сетевой ошибки
+}
+```

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

@@ -0,0 +1,44 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiError - Tiện ích lỗi (Tĩnh)'/>
+
+# Lớp ApiError
+
+Lớp `ApiError` là một **Tiện ích chính (Tĩnh)** để quản lý bộ lưu trữ lỗi API và xác định các thất bại. Nó cung cấp một giao diện singleton tập trung để đăng ký các mẫu lỗi và chuyển đổi các phản hồi mạng thô thành các đối tượng `ApiErrorItem` có cấu trúc.
+
+## Các tính năng chính
+
+- **Giao diện tĩnh** — quản lý tiêu chí lỗi và phân tích phản hồi mà không cần khởi tạo thủ công.
+- **Singleton an toàn cho SSR** — sử dụng `ServerStorage` để duy trì bộ lưu trữ lỗi riêng biệt giữa các yêu cầu khác nhau trong quá trình render phía máy chủ.
+- **Đăng ký mẫu** — API đơn giản để thêm các mẫu lỗi riêng lẻ hoặc danh sách hàng loạt để nhận dạng lỗi toàn cầu.
+
+## Các phương thức
+
+### Quản lý bộ lưu trữ
+
+- `getStorage(): ApiErrorStorage` — Lấy instance singleton nội bộ của bộ lưu trữ lỗi.
+- `add(item: ApiErrorStorageItem | ApiErrorStorageList): void` — Thêm một hoặc nhiều mẫu lỗi vào bộ lưu trữ toàn cầu.
+
+### Phân tích
+
+#### `getItem`
+
+Phân tích một phản hồi Fetch thô và tạo một instance `ApiErrorItem` có cấu trúc. Đây là phương thức chính để xử lý các thất bại API.
+
+**Tham số:**
+- `method: ApiMethodItem` — Phương thức HTTP của yêu cầu.
+- `response: Response` — Đối tượng phản hồi Fetch thô.
+
+**Trả về:** `Promise<ApiErrorItem>` — Một đối tượng lỗi có cấu trúc chứa các chi tiết đã được phân tích.
+
+```javascript
+try {
+  const response = await fetch('/api/user');
+  if (!response.ok) {
+    const errorItem = await ApiError.getItem(ApiMethodItem.get, response);
+    console.error(errorItem.getMessage());
+  }
+} catch (e) {
+  // Xử lý lỗi mạng
+}
+```

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

@@ -0,0 +1,31 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ApiErrorItem - Error Instance'/>
+
+# ApiErrorItem Class
+
+The `ApiErrorItem` class is a **data wrapper for API error responses**. It encapsulates the request context (method, response) and the identified error criteria from the storage, providing a unified interface for extracting error details.
+
+## Key Features
+
+- **Data Encapsulation** — stores the complete context of an API failure, including the raw Fetch `Response`.
+- **Unified Extraction** — provides consistent access to error codes and messages regardless of whether they came from the response body or pre-defined storage criteria.
+- **Dynamic Messaging** — resolves error messages using static strings or dynamic factory functions based on the response.
+
+## Methods
+
+### Accessors
+
+- `getMethod(): ApiMethodItem` — Returns the HTTP method used for the request.
+- `getResponse(): Response` — Returns the raw Fetch response object.
+- `getError(): ApiErrorStorageItem` — Returns the identified error criteria from storage.
+- `getStatus(): number` — Returns the HTTP status code.
+
+### Data Extraction
+
+- `getCode(): string | undefined` — Retrieves the error code from the storage criteria.
+- `getMessage(): string | undefined` — Resolves the error message (checks storage criteria or falls back to response defaults).
+
+## Architecture
+
+`ApiErrorItem` is typically created by the `ApiError.getItem()` factory. It serves as the final product of the error analysis phase, ready to be consumed by UI components or logging services.

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

@@ -0,0 +1,31 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiErrorItem - Экземпляр ошибки'/>
+
+# Класс ApiErrorItem
+
+Класс `ApiErrorItem` является **оберткой данных для ответов об ошибках API**. Он инкапсулирует контекст запроса (метод, ответ) и идентифицированные критерии ошибки из хранилища, предоставляя единый интерфейс для извлечения деталей ошибки.
+
+## Ключевые особенности
+
+- **Инкапсуляция данных** — хранит полный контекст сбоя API, включая сырой объект `Response` от Fetch.
+- **Единое извлечение** — обеспечивает последовательный доступ к кодам и сообщениям об ошибках, независимо от того, были ли они получены из тела ответа или из предварительно определенных критериев хранилища.
+- **Динамические сообщения** — разрешает сообщения об ошибках, используя статические строки или динамические функции-фабрики на основе ответа.
+
+## Методы
+
+### Аксессоры
+
+- `getMethod(): ApiMethodItem` — Возвращает HTTP-метод, использованный для запроса.
+- `getResponse(): Response` — Возвращает сырой объект ответа Fetch.
+- `getError(): ApiErrorStorageItem` — Возвращает идентифицированные критерии ошибки из хранилища.
+- `getStatus(): number` — Возвращает код статуса HTTP.
+
+### Извлечение данных
+
+- `getCode(): string | undefined` — Получает код ошибки из критериев хранилища.
+- `getMessage(): string | undefined` — Разрешает сообщение об ошибке (проверяет критерии хранилища или использует значения по умолчанию из ответа).
+
+## Архитектура
+
+`ApiErrorItem` обычно создается фабрикой `ApiError.getItem()`. Он служит конечным продуктом фазы анализа ошибок, готовым к использованию компонентами UI или сервисами логирования.

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

@@ -0,0 +1,31 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiErrorItem - Đối tượng lỗi'/>
+
+# Lớp ApiErrorItem
+
+Lớp `ApiErrorItem` là một **vỏ bọc dữ liệu cho các phản hồi lỗi API**. Nó đóng gói ngữ cảnh yêu cầu (phương thức, phản hồi) và các tiêu chí lỗi đã xác định từ bộ lưu trữ, cung cấp một giao diện thống nhất để trích xuất chi tiết lỗi.
+
+## Các tính năng chính
+
+- **Đóng gói dữ liệu** — lưu trữ ngữ cảnh đầy đủ của một lỗi API, bao gồm cả đối tượng `Response` thô từ Fetch.
+- **Trích xuất thống nhất** — cung cấp khả năng truy cập nhất quán vào mã lỗi và thông báo bất kể chúng đến từ thân phản hồi hay các tiêu chí lưu trữ được xác định trước.
+- **Thông báo động** — giải quyết các thông báo lỗi bằng cách sử dụng chuỗi tĩnh hoặc các hàm tạo thông báo động dựa trên phản hồi.
+
+## Các phương thức
+
+### Các phương thức truy cập (Accessors)
+
+- `getMethod(): ApiMethodItem` — Trả về phương thức HTTP được sử dụng cho yêu cầu.
+- `getResponse(): Response` — Trả về đối tượng phản hồi Fetch thô.
+- `getError(): ApiErrorStorageItem` — Trả về tiêu chí lỗi đã xác định từ bộ lưu trữ.
+- `getStatus(): number` — Trả về mã trạng thái HTTP.
+
+### Trích xuất dữ liệu
+
+- `getCode(): string | undefined` — Lấy mã lỗi từ tiêu chí lưu trữ.
+- `getMessage(): string | undefined` — Giải quyết thông báo lỗi (kiểm tra tiêu chí lưu trữ hoặc quay lại mặc định của phản hồi).
+
+## Kiến trúc
+
+`ApiErrorItem` thường được tạo bởi factory `ApiError.getItem()`. Nó phục vụ như là sản phẩm cuối cùng của giai đoạn phân tích lỗi, sẵn sàng để được sử dụng bởi các thành phần UI hoặc dịch vụ ghi log.

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

@@ -0,0 +1,51 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ApiErrorStorage - Error Management'/>
+
+# ApiErrorStorage Class
+
+The `ApiErrorStorage` class is a **Manager for handling and identifying API error states**. It provides a centralized storage for API error criteria, allowing the system to identify specific errors by matching the response status, error code from the JSON body, request method, and URL.
+
+## Key Features
+
+- **Centralized Storage** — aggregate all known API error patterns in one place for consistent processing.
+- **Pattern Matching** — identify errors by HTTP status, custom error codes, request methods, or URL patterns (including RegExp).
+- **Structured Transformation** — transform raw network errors into structured application-level error items.
+- **Custom Validation** — support for custom validation functions for complex error identification scenarios.
+
+## Methods
+
+### Management
+
+- `add(item: ApiErrorStorageItem | ApiErrorStorageList): this` — Adds one or more error items or lists to the internal storage.
+
+### Identification
+
+#### `find`
+
+Finds a matching error item in the storage by analyzing the response. It automatically attempts to extract the error code and message from the response body.
+
+**Parameters:**
+- `method: ApiMethodItem` — The HTTP method used for the request.
+- `response: Response` — The Fetch API response object.
+
+**Returns:** `Promise<ApiErrorStorageItem>` — The matched error item or a generated error item if no match is found.
+
+```javascript
+const errorItem = await errorStorage.find(ApiMethodItem.get, response);
+
+if (errorItem.code === 'USER_NOT_FOUND') {
+  // Handle specific error
+}
+```
+
+## Types
+
+### ApiErrorStorageItem
+
+- `url: string | RegExp` — URL string or regular expression to match the request URL.
+- `method: ApiMethodItem` — HTTP method required for the match.
+- `code?: string` — Optional error code to match against the JSON body.
+- `status?: number` — Optional HTTP status code to match.
+- `validation?: (response: Response) => boolean` — Optional custom validation function.
+- `message?: string | ((response?: Response) => string)` — Optional error message or message factory.