fui-material 2.8.10 → 2.8.11

package/dist/types/context/FLibraryProvider.d.ts

@@ -1,14 +1,24 @@
 import { ReactNode } from 'react';
 import { AxiosRequestConfig } from 'axios';
+import { FRequestObserver } from './requestObserver';
+export * from './requestObserver';
 export interface ILibApiService {
     request: <T>(url: string, config: AxiosRequestConfig) => Promise<T>;
 }
 export interface LibraryConfig {
     apiService: ILibApiService;
+    /** Опциональный наблюдатель жизненного цикла HTTP-запросов */
+    requestObserver?: FRequestObserver;
 }
-declare const FLibraryProvider: ({ children, config }: {
+export interface FLibraryProviderProps {
     children: ReactNode;
     config: LibraryConfig;
-}) => import("react").JSX.Element;
+    /** Опциональный наблюдатель жизненного цикла HTTP-запросов (альтернатива передаче внутри config) */
+    requestObserver?: FRequestObserver;
+}
+declare const LibraryContext: import("react").Context<LibraryConfig | null>;
+export { LibraryContext };
+declare const FLibraryProvider: ({ children, config, requestObserver, }: FLibraryProviderProps) => import("react").JSX.Element;
 export declare const useFLibraryContext: () => LibraryConfig;
+export declare const useFLibraryContextOptional: () => LibraryConfig | null;
 export default FLibraryProvider;

package/dist/types/context/index.d.ts

@@ -1 +1,3 @@
-export { default as FLibraryProvider } from "./FLibraryProvider";
+export { default as FLibraryProvider, useFLibraryContext, useFLibraryContextOptional, LibraryContext } from "./FLibraryProvider";
+export type { ILibApiService, LibraryConfig, FLibraryProviderProps } from "./FLibraryProvider";
+export * from "./requestObserver";

package/dist/types/context/requestObserver.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Итоговый результат выполнения HTTP-запроса.
+ */
+export type FRequestOutcome = 'success' | 'failure' | 'aborted';
+/**
+ * Категория возникшей ошибки запроса.
+ */
+export type FRequestErrorCategory = 'http' | 'network' | 'timeout' | 'abort' | 'unknown';
+/**
+ * Событие наблюдения жизненного цикла завершенного HTTP-запроса.
+ * Не содержит тел запроса/ответа, заголовков или чувствительных данных.
+ */
+export interface FRequestObservation {
+    /** HTTP-метод (GET, POST, PUT, DELETE и т.д.) в верхнем регистре */
+    method: string;
+    /** Запрашиваемый URL / путь */
+    url: string;
+    /** HTTP статус ответа сервера (если доступен) */
+    status?: number;
+    /** Приблизительная длительность запроса от запуска до завершения в миллисекундах */
+    durationMs: number;
+    /** Результат завершения запроса */
+    outcome: FRequestOutcome;
+    /** Категория ошибки (если произошла ошибка или запрос был отменен) */
+    errorCategory?: FRequestErrorCategory;
+}
+/**
+ * Интерфейс наблюдателя жизненного цикла запросов библиотеки.
+ */
+export interface FRequestObserver {
+    /**
+     * Вызывается однократно при завершении выполнения запроса (успех, сбой или отмена).
+     * Любые исключения внутри данного метода изолируются и не влияют на работу приложения.
+     */
+    onRequestComplete(event: FRequestObservation): void;
+}
+/**
+ * Внутренняя функция получения текущего времени высокой точности (браузер / среда исполнения).
+ */
+export declare const getRequestNow: () => number;
+/**
+ * Внутренняя функция безопасного вычисления разницы во времени в мс.
+ */
+export declare const calcDurationMs: (startTime: number) => number;
+/**
+ * Консервативная классификация ошибки запроса для наблюдателя.
+ */
+export declare function classifyRequestError(error: unknown): {
+    outcome: FRequestOutcome;
+    errorCategory: FRequestErrorCategory;
+    status?: number;
+};
+/**
+ * Безопасный вызов наблюдателя запросов с полной изоляцией ошибок.
+ * Ошибки внутри `onRequestComplete` никогда не прерывают выполнение запроса и не логируются в консоль.
+ */
+export declare function notifyRequestObserver(observer: FRequestObserver | undefined, observation: FRequestObservation): void;
+/**
+ * Обёртка для выполнения асинхронной функции запроса с фиксацией наблюдения.
+ */
+export declare function observeRequest<T>(observer: FRequestObserver | undefined, requestFn: () => Promise<T>, method: string, url: string): Promise<T>;

package/dist/types/hooks/useFApi/useFApi.d.ts

@@ -1,4 +1,5 @@
 import { AxiosRequestConfig } from 'axios';
+import { FRequestObserver } from '@context/requestObserver';
 /**
  * Тип возвращаемого значения хука `useFApi`.
  *
@@ -59,6 +60,10 @@ type IProps<T> = {
      * Например: `'data.items'`
      */
     getValueByPath?: string;
+    /**
+     * Опциональный наблюдатель жизненного цикла HTTP-запросов (по умолчанию берется из FLibraryProvider, если доступен).
+     */
+    requestObserver?: FRequestObserver;
 };
 /**
  * Хук `useFApi` предоставляет удобную обёртку над `axios` с поддержкой:
@@ -106,7 +111,7 @@ type IProps<T> = {
  *   console.log(data);
  * };
  */
-declare const useFApi: <T>({ doNotUseState, defaultState, getValueByPath }?: IProps<T>) => {
+declare const useFApi: <T>({ doNotUseState, defaultState, getValueByPath, requestObserver, }?: IProps<T>) => {
     data: T | null;
     loading: boolean;
     error: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fui-material",
-  "version": "2.8.10",
+  "version": "2.8.11",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -15,6 +15,7 @@
     "build": "vite build && npm run build:types",
     "build-publish": "vite build && npm run build:types && npm publish",
     "lint": "eslint .",
+    "test": "vitest run",
     "preview": "vite preview",
     "storybook": "storybook dev -p 6006",
     "deploy-storybook": "storybook build && gh-pages -d storybook-static --repo https://github.com/Allorion/fui-storybook.git",