synapse-storage 3.0.19 → 4.0.1

package/dist/api/index.js

@@ -0,0 +1,11 @@
+export * from "./api.module.js";
+export * from "./utils/api-helpers.js";
+
+
+
+ // export * from './_utils/file-_utils'
+ // export * from './_utils/get-cacheable-headers'
+
+export { ResponseFormat } from "./types/api.interface.js";
+
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/index.js","sources":["../../src/api/index.ts"],"sourcesContent":["export * from './api.module'\nexport { ResponseFormat, type RetryConfig } from './types/api.interface'\nexport * from './utils/api-helpers'\n// export * from './_utils/file-_utils'\n// export * from './_utils/get-cacheable-headers'\n"],"names":["ResponseFormat"],"mappings":";;;AAA4B;AAC4C;AACrC,CACnC,uCAAuC;CACvC,iDAAiD"}

package/dist/api/types/api.interface.d.ts

@@ -0,0 +1,126 @@
+import { IStorage } from '../../core';
+import { CreateEndpoint, EndpointConfig } from './endpoint.interface';
+/**
+ * Форматы ответа от сервера
+ */
+export declare enum ResponseFormat {
+    /** JSON-объект (по умолчанию) */
+    Json = "json",
+    /** Blob-объект для файлов */
+    Blob = "blob",
+    /** ArrayBuffer для бинарных данных */
+    ArrayBuffer = "arrayBuffer",
+    /** Текстовый формат */
+    Text = "text",
+    /** FormData для форм */
+    FormData = "formData",
+    /** Без преобразования - возвращает сырой ответ */
+    Raw = "raw"
+}
+/**
+ * Настройки кэша
+ * Может быть объектом с параметрами или boolean (true для кэширования с настройками по умолчанию, false для отключения)
+ */
+export type CacheConfig = boolean | {
+    /** Время жизни кэша в миллисекундах */
+    ttl?: number;
+    /** Настройки периодической очистки */
+    cleanup?: {
+        /** Включить периодическую очистку */
+        enabled: boolean;
+        /** Интервал очистки в миллисекундах */
+        interval?: number;
+    };
+    /** Инвалидировать кэш при ошибке */
+    invalidateOnError?: boolean;
+};
+/**
+ * Определение запроса
+ * Содержит всю необходимую информацию для выполнения HTTP-запроса
+ */
+export interface RequestDefinition<RequestParams extends Record<string, any>> {
+    /** Путь запроса (относительный или абсолютный URL) */
+    path: string;
+    /** HTTP-метод */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** Тело запроса (автоматически сериализуется) */
+    body?: any;
+    /** Параметры запроса (автоматически добавляются в URL) */
+    query?: RequestParams;
+    /** HTTP-заголовки */
+    headers?: Record<string, string>;
+    /** Формат ответа (по умолчанию json) */
+    responseFormat?: ResponseFormat;
+    /** Имя файла для автоматического скачивания */
+    fileName?: string;
+    /** Тип контента для автоматического скачивания */
+    fileType?: string;
+}
+/**
+ * Контекст API для использования в prepareHeaders и других функциях
+ * Содержит вспомогательные методы и информацию о запросе
+ */
+export interface ApiContext<RequestParams extends Record<string, any> = any> {
+    /** Параметры запроса */
+    requestParams?: RequestParams;
+    /** Получить значение из localStorage */
+    getFromStorage: <T>(key: string) => T | undefined;
+    /** Получить значение cookie */
+    getCookie: (name: string) => string | undefined;
+    /** Поддержка для дополнительных свойств */
+    [key: string]: any;
+}
+/**
+ * Аргументы для создания fetch-запроса
+ */
+export interface FetchBaseQueryArgs {
+    /** Базовый URL для всех запросов */
+    baseUrl: string;
+    /** Функция для подготовки заголовков, может быть асинхронной */
+    prepareHeaders?: (headers: Headers, context: ApiContext) => Promise<Headers>;
+    /** Таймаут запроса в миллисекундах */
+    timeout?: number;
+    /** Пользовательская fetch-функция */
+    fetchFn?: typeof fetch;
+    credentials?: RequestCredentials;
+}
+/**
+ * Конфигурация повторных попыток запроса
+ */
+export interface RetryConfig {
+    /** Количество повторных попыток (0 = без retry) */
+    count: number;
+    /** Задержка между попытками в мс, или функция (attempt) => ms для кастомной стратегии */
+    delay?: number | ((attempt: number) => number);
+    /** HTTP-статусы, при которых делать retry (по умолчанию: 0, 408, 429, 500, 502, 503, 504) */
+    retryOn?: number[];
+}
+/**
+ * Storage или фабрика для ленивого создания storage
+ * Фабрика вызывается при init() — удобно для универсального кода (SSR + клиент)
+ */
+export type StorageOption = IStorage | (() => IStorage | Promise<IStorage>);
+export interface CreateApiClientOptions<T extends Record<string, EndpointConfig<any, any>> = Record<string, EndpointConfig<any, any>>> {
+    storage: StorageOption;
+    /** Настройки кэша
+     * если явно указан false - значит ни один запрос НЕ будет кэшироваться, даже если в эндпоинтах указаны параметры
+     * */
+    cache?: CacheConfig;
+    /** Базовый запрос или его настройки */
+    baseQuery: FetchBaseQueryArgs;
+    /** Функция для создания эндпоинтов */
+    endpoints?: (create: CreateEndpoint) => Promise<T>;
+    /** Глобальные заголовки, влияющие на кэш */
+    cacheableHeaderKeys?: string[];
+    /** Глобальная конфигурация retry (применяется ко всем эндпоинтам по умолчанию) */
+    retry?: RetryConfig;
+}
+/**
+ * Извлечение типа параметров из конфигурации эндпоинта
+ */
+export type ExtractParamsType<T> = T extends EndpointConfig<infer P, any> ? P : never;
+/**
+ * Извлечение типа результата из конфигурации эндпоинта
+ */
+export type ExtractResultType<T> = T extends EndpointConfig<any, infer R> ? R : never;
+//# sourceMappingURL=api.interface.d.ts.map

package/dist/api/types/api.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.interface.d.ts","sourceRoot":"","sources":["../../../src/api/types/api.interface.ts"],"names":[],"mappings":"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"}

package/dist/api/types/api.interface.js

@@ -0,0 +1,15 @@
+/**
+ * Форматы ответа от сервера
+ */ var api_interface_ResponseFormat = /*#__PURE__*/ function(ResponseFormat) {
+    /** JSON-объект (по умолчанию) */ ResponseFormat["Json"] = "json";
+    /** Blob-объект для файлов */ ResponseFormat["Blob"] = "blob";
+    /** ArrayBuffer для бинарных данных */ ResponseFormat["ArrayBuffer"] = "arrayBuffer";
+    /** Текстовый формат */ ResponseFormat["Text"] = "text";
+    /** FormData для форм */ ResponseFormat["FormData"] = "formData";
+    /** Без преобразования - возвращает сырой ответ */ ResponseFormat["Raw"] = "raw";
+    return ResponseFormat;
+}({});
+
+export { api_interface_ResponseFormat as ResponseFormat };
+
+//# sourceMappingURL=api.interface.js.map

package/dist/api/types/api.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/types/api.interface.js","sources":["../../../src/api/types/api.interface.ts"],"sourcesContent":["import { IStorage, StorageType } from '../../core'\nimport { CreateEndpoint, EndpointConfig } from './endpoint.interface'\n\n/**\n * Форматы ответа от сервера\n */\nexport enum ResponseFormat {\n  /** JSON-объект (по умолчанию) */\n  Json = 'json',\n  /** Blob-объект для файлов */\n  Blob = 'blob',\n  /** ArrayBuffer для бинарных данных */\n  ArrayBuffer = 'arrayBuffer',\n  /** Текстовый формат */\n  Text = 'text',\n  /** FormData для форм */\n  FormData = 'formData',\n  /** Без преобразования - возвращает сырой ответ */\n  Raw = 'raw',\n}\n\n/**\n * Настройки кэша\n * Может быть объектом с параметрами или boolean (true для кэширования с настройками по умолчанию, false для отключения)\n */\nexport type CacheConfig =\n  | boolean\n  | {\n      /** Время жизни кэша в миллисекундах */\n      ttl?: number\n      /** Настройки периодической очистки */\n      cleanup?: {\n        /** Включить периодическую очистку */\n        enabled: boolean\n        /** Интервал очистки в миллисекундах */\n        interval?: number\n      }\n      /** Инвалидировать кэш при ошибке */\n      invalidateOnError?: boolean\n    }\n\n/**\n * Определение запроса\n * Содержит всю необходимую информацию для выполнения HTTP-запроса\n */\nexport interface RequestDefinition<RequestParams extends Record<string, any>> {\n  /** Путь запроса (относительный или абсолютный URL) */\n  path: string\n  /** HTTP-метод */\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'\n  /** Тело запроса (автоматически сериализуется) */\n  body?: any\n  /** Параметры запроса (автоматически добавляются в URL) */\n  query?: RequestParams\n  /** HTTP-заголовки */\n  headers?: Record<string, string>\n  /** Формат ответа (по умолчанию json) */\n  responseFormat?: ResponseFormat\n  /** Имя файла для автоматического скачивания */\n  fileName?: string\n  /** Тип контента для автоматического скачивания */\n  fileType?: string\n}\n\n/**\n * Контекст API для использования в prepareHeaders и других функциях\n * Содержит вспомогательные методы и информацию о запросе\n */\nexport interface ApiContext<RequestParams extends Record<string, any> = any> {\n  /** Параметры запроса */\n  requestParams?: RequestParams\n  /** Получить значение из localStorage */\n  getFromStorage: <T>(key: string) => T | undefined\n  /** Получить значение cookie */\n  getCookie: (name: string) => string | undefined\n  /** Поддержка для дополнительных свойств */\n  [key: string]: any\n}\n\n/**\n * Аргументы для создания fetch-запроса\n */\nexport interface FetchBaseQueryArgs {\n  /** Базовый URL для всех запросов */\n  baseUrl: string\n  /** Функция для подготовки заголовков, может быть асинхронной */\n  prepareHeaders?: (headers: Headers, context: ApiContext) => Promise<Headers>\n  /** Таймаут запроса в миллисекундах */\n  timeout?: number\n  /** Пользовательская fetch-функция */\n  fetchFn?: typeof fetch\n  credentials?: RequestCredentials\n}\n\n/**\n * Конфигурация повторных попыток запроса\n */\nexport interface RetryConfig {\n  /** Количество повторных попыток (0 = без retry) */\n  count: number\n  /** Задержка между попытками в мс, или функция (attempt) => ms для кастомной стратегии */\n  delay?: number | ((attempt: number) => number)\n  /** HTTP-статусы, при которых делать retry (по умолчанию: 0, 408, 429, 500, 502, 503, 504) */\n  retryOn?: number[]\n}\n\n/**\n * Storage или фабрика для ленивого создания storage\n * Фабрика вызывается при init() — удобно для универсального кода (SSR + клиент)\n */\nexport type StorageOption = IStorage | (() => IStorage | Promise<IStorage>)\n\nexport interface CreateApiClientOptions<T extends Record<string, EndpointConfig<any, any>> = Record<string, EndpointConfig<any, any>>> {\n  storage: StorageOption\n  /** Настройки кэша\n   * если явно указан false - значит ни один запрос НЕ будет кэшироваться, даже если в эндпоинтах указаны параметры\n   * */\n  cache?: CacheConfig\n  /** Базовый запрос или его настройки */\n  baseQuery: FetchBaseQueryArgs\n  /** Функция для создания эндпоинтов */\n  endpoints?: (create: CreateEndpoint) => Promise<T>\n  /** Глобальные заголовки, влияющие на кэш */\n  cacheableHeaderKeys?: string[]\n  /** Глобальная конфигурация retry (применяется ко всем эндпоинтам по умолчанию) */\n  retry?: RetryConfig\n}\n\n/**\n * Извлечение типа параметров из конфигурации эндпоинта\n */\nexport type ExtractParamsType<T> = T extends EndpointConfig<infer P, any> ? P : never\n\n/**\n * Извлечение типа результата из конфигурации эндпоинта\n */\nexport type ExtractResultType<T> = T extends EndpointConfig<any, infer R> ? R : never\n"],"names":["ResponseFormat"],"mappings":"AAGA;;CAEC,GACM,IAAKA,4BAAcA,0BAAdA;IACV,+BAA+B;IAE/B,2BAA2B;IAE3B,oCAAoC;IAEpC,qBAAqB;IAErB,sBAAsB;IAEtB,gDAAgD;WAXtCA;MAaX"}

package/dist/api/types/endpoint.interface.d.ts

@@ -0,0 +1,118 @@
+import { ApiContext, CacheConfig, RequestDefinition, RetryConfig } from './api.interface';
+import { QueryOptions, QueryResult, Unsubscribe } from './query.interface';
+/**
+ * Конфигурация эндпоинта
+ */
+export interface EndpointConfig<RequestParams extends Record<string, any> = any, RequestResult = any> {
+    /** Функция для создания определения запроса из параметров */
+    request: (params: RequestParams, context?: Record<string, any>) => RequestDefinition<RequestParams>;
+    /** Настройки кэша для эндпоинта */
+    cache?: CacheConfig;
+    /** Теги эндпоинта для группировки в кэше */
+    tags?: string[];
+    /** Теги, которые инвалидируются при успешном запросе */
+    invalidatesTags?: string[];
+    /** Функция для подготовки заголовков (дополняет глобальную) */
+    prepareHeaders?: (headers: Headers, context: ApiContext<RequestParams>) => Promise<Headers>;
+    /** Добавить ключи заголовков, влияющие на кэш (Дополняет глобавльные ключи) */
+    includeCacheableHeaderKeys?: string[];
+    /** Исключить ключи заголовков, влияющие на кэш (Дополняет глобавльные ключи) */
+    excludeCacheableHeaderKeys?: string[];
+    /** Конфигурация retry для этого эндпоинта (переопределяет глобальную) */
+    retry?: RetryConfig;
+}
+/**
+ * Состояние эндпоинта
+ * Содержит информацию о текущем состоянии запроса и данные
+ */
+export interface EndpointState {
+    /** Статус запроса */
+    status: 'idle' | 'loading' | 'success' | 'error';
+    /** Ошибка (при неуспешном запросе) */
+    error?: Error;
+    /** Количество вызовов */
+    fetchCounts: number;
+    /** Метаданные эндпоинта */
+    meta: Endpoint['meta'];
+    /** Какие заголовки участвовали в формировании ключа кэша (итоговые) */
+    cacheableHeaders: string[];
+}
+/**
+ * Состояние самого запроса
+ */
+export interface RequestState<ResponseData = any, RequestParams extends Record<string, any> = any, E = Error> {
+    status: 'loading' | 'success' | 'error' | 'idle';
+    data?: ResponseData;
+    error?: E;
+    headers: Record<string, any> | Headers;
+    requestParams: RequestParams;
+    fromCache: boolean;
+}
+export interface SubscribeOptions {
+    /** Автоматически отписаться после завершения запроса */
+    autoUnsubscribe?: boolean;
+}
+/**
+ * Дополнительные методы для request
+ */
+export interface RequestResponseModify<T, P extends Record<string, any> = any> {
+    id: string;
+    /**
+     * Подписка на изменения состояния запроса
+     */
+    subscribe: (listener: (state: RequestState<T, P>) => void, options?: SubscribeOptions) => VoidFunction;
+    /**
+     * Ожидание завершения запроса
+     * @returns Promise с результатом запроса
+     */
+    wait: () => Promise<QueryResult<T, Error>>;
+    waitWithCallbacks: (handlers: {
+        idle?: (request: RequestState<T, P>) => void;
+        loading?: (request: RequestState<T, P>) => void;
+        success?: (data: T | undefined, request: RequestState<T, P>) => void;
+        error?: (error: Error | undefined, request: RequestState<T, P>) => void;
+    }) => Promise<QueryResult<T, Error>>;
+    /**
+     * Отменить запрос
+     */
+    abort: VoidFunction;
+    then<TResult1 = QueryResult<T, Error>, TResult2 = never>(onfulfilled?: ((value: QueryResult<T, Error>) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: Error) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: Error) => TResult | PromiseLike<TResult>) | undefined | null): Promise<QueryResult<T, Error> | TResult>;
+    finally(onfinally?: VoidFunction | undefined | null): Promise<QueryResult<T, Error>>;
+}
+/**
+ * Структура эндпоинта
+ *
+ * Эндпоинт - это всего лишь определение того6 как будет вызван метод
+ * Эндпоинт может быть вызван в разных частях приложения с разными параметрами
+ * По этому нет смысла хранить ответы так как они будут перезаписываться
+ * метод subscribe больше нужен для мониторинга
+ * meta - метаинформация по эндпоинту (то как он сконфигурирован)
+ */
+export interface Endpoint<RequestParams extends Record<string, any> = any, ResponseData = any> {
+    /** Счетчик вызова конкретного эндпоинта в проекте */
+    fetchCounts: number;
+    /** Выполнить запрос с параметрами */
+    request: (params: RequestParams, options?: QueryOptions) => RequestResponseModify<ResponseData>;
+    /** Подписаться на изменения состояния эндпоинта (в основном для сбора статистики) */
+    subscribe: (callback: (state: EndpointState) => void) => Unsubscribe;
+    /** Сбросить состояние */
+    reset: () => Promise<void>;
+    /** Метаданные эндпоинта */
+    meta: {
+        /** Имя эндпоинта */
+        name: string;
+        /** Теги эндпоинта */
+        tags: string[];
+        /** Теги, которые инвалидируются */
+        invalidatesTags: string[];
+        /** Настройки кэша */
+        cache: CacheConfig;
+    };
+    destroy: VoidFunction;
+}
+/**
+ * Функция для создания типизированных эндпоинтов
+ */
+export type CreateEndpoint = <RequestParams extends Record<string, any>, RequestResult>(config: EndpointConfig<RequestParams, RequestResult>) => EndpointConfig<RequestParams, RequestResult>;
+//# sourceMappingURL=endpoint.interface.d.ts.map

package/dist/api/types/endpoint.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.interface.d.ts","sourceRoot":"","sources":["../../../src/api/types/endpoint.interface.ts"],"names":[],"mappings":"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"}

package/dist/api/types/endpoint.interface.js

@@ -0,0 +1,6 @@
+/**
+ * Функция для создания типизированных эндпоинтов
+ */ 
+
+
+//# sourceMappingURL=endpoint.interface.js.map

package/dist/api/types/endpoint.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/types/endpoint.interface.js","sources":["../../../src/api/types/endpoint.interface.ts"],"sourcesContent":["import { ApiContext, CacheConfig, RequestDefinition, RetryConfig } from './api.interface'\nimport { QueryOptions, QueryResult, Unsubscribe } from './query.interface'\n\n/**\n * Конфигурация эндпоинта\n */\nexport interface EndpointConfig<RequestParams extends Record<string, any> = any, RequestResult = any> {\n  /** Функция для создания определения запроса из параметров */\n  request: (params: RequestParams, context?: Record<string, any>) => RequestDefinition<RequestParams>\n  /** Настройки кэша для эндпоинта */\n  cache?: CacheConfig\n  /** Теги эндпоинта для группировки в кэше */\n  tags?: string[]\n  /** Теги, которые инвалидируются при успешном запросе */\n  invalidatesTags?: string[]\n  /** Функция для подготовки заголовков (дополняет глобальную) */\n  prepareHeaders?: (headers: Headers, context: ApiContext<RequestParams>) => Promise<Headers>\n  /** Добавить ключи заголовков, влияющие на кэш (Дополняет глобавльные ключи) */\n  includeCacheableHeaderKeys?: string[]\n  /** Исключить ключи заголовков, влияющие на кэш (Дополняет глобавльные ключи) */\n  excludeCacheableHeaderKeys?: string[]\n  /** Конфигурация retry для этого эндпоинта (переопределяет глобальную) */\n  retry?: RetryConfig\n}\n\n/**\n * Состояние эндпоинта\n * Содержит информацию о текущем состоянии запроса и данные\n */\nexport interface EndpointState {\n  /** Статус запроса */\n  status: 'idle' | 'loading' | 'success' | 'error'\n  /** Ошибка (при неуспешном запросе) */\n  error?: Error\n  /** Количество вызовов */\n  fetchCounts: number\n  /** Метаданные эндпоинта */\n  meta: Endpoint['meta']\n  /** Какие заголовки участвовали в формировании ключа кэша (итоговые) */\n  cacheableHeaders: string[]\n}\n\n/**\n * Состояние самого запроса\n */\nexport interface RequestState<ResponseData = any, RequestParams extends Record<string, any> = any, E = Error> {\n  status: 'loading' | 'success' | 'error' | 'idle'\n  data?: ResponseData\n  error?: E\n  headers: Record<string, any> | Headers\n  requestParams: RequestParams\n  fromCache: boolean\n}\n\nexport interface SubscribeOptions {\n  /** Автоматически отписаться после завершения запроса */\n  autoUnsubscribe?: boolean\n}\n\n/**\n * Дополнительные методы для request\n */\nexport interface RequestResponseModify<T, P extends Record<string, any> = any> {\n  id: string\n\n  /**\n   * Подписка на изменения состояния запроса\n   */\n  subscribe: (listener: (state: RequestState<T, P>) => void, options?: SubscribeOptions) => VoidFunction\n\n  /**\n   * Ожидание завершения запроса\n   * @returns Promise с результатом запроса\n   */\n  wait: () => Promise<QueryResult<T, Error>>\n\n  waitWithCallbacks: (handlers: {\n    idle?: (request: RequestState<T, P>) => void\n    loading?: (request: RequestState<T, P>) => void\n    success?: (data: T | undefined, request: RequestState<T, P>) => void\n    error?: (error: Error | undefined, request: RequestState<T, P>) => void\n  }) => Promise<QueryResult<T, Error>>\n\n  /**\n   * Отменить запрос\n   */\n  abort: VoidFunction\n\n  // Promise API для поддержки await и .then()\n  then<TResult1 = QueryResult<T, Error>, TResult2 = never>(\n    onfulfilled?: ((value: QueryResult<T, Error>) => TResult1 | PromiseLike<TResult1>) | undefined | null,\n    onrejected?: ((reason: Error) => TResult2 | PromiseLike<TResult2>) | undefined | null,\n  ): Promise<TResult1 | TResult2>\n\n  catch<TResult = never>(onrejected?: ((reason: Error) => TResult | PromiseLike<TResult>) | undefined | null): Promise<QueryResult<T, Error> | TResult>\n\n  finally(onfinally?: VoidFunction | undefined | null): Promise<QueryResult<T, Error>>\n}\n\n/**\n * Структура эндпоинта\n *\n * Эндпоинт - это всего лишь определение того6 как будет вызван метод\n * Эндпоинт может быть вызван в разных частях приложения с разными параметрами\n * По этому нет смысла хранить ответы так как они будут перезаписываться\n * метод subscribe больше нужен для мониторинга\n * meta - метаинформация по эндпоинту (то как он сконфигурирован)\n */\nexport interface Endpoint<RequestParams extends Record<string, any> = any, ResponseData = any> {\n  /** Счетчик вызова конкретного эндпоинта в проекте */\n  fetchCounts: number\n  /** Выполнить запрос с параметрами */\n  request: (params: RequestParams, options?: QueryOptions) => RequestResponseModify<ResponseData>\n  /** Подписаться на изменения состояния эндпоинта (в основном для сбора статистики) */\n  subscribe: (callback: (state: EndpointState) => void) => Unsubscribe\n  /** Сбросить состояние */\n  reset: () => Promise<void>\n  /** Метаданные эндпоинта */\n  meta: {\n    /** Имя эндпоинта */\n    name: string\n    /** Теги эндпоинта */\n    tags: string[]\n    /** Теги, которые инвалидируются */\n    invalidatesTags: string[]\n    /** Настройки кэша */\n    cache: CacheConfig\n  }\n  destroy: VoidFunction\n}\n\n/**\n * Функция для создания типизированных эндпоинтов\n */\nexport type CreateEndpoint = <RequestParams extends Record<string, any>, RequestResult>(\n  config: EndpointConfig<RequestParams, RequestResult>,\n) => EndpointConfig<RequestParams, RequestResult>\n"],"names":[],"mappings":"AAmIA;;CAEC,GAGgD"}

package/dist/api/types/query.interface.d.ts

@@ -0,0 +1,85 @@
+import { ResponseFormat, RetryConfig } from './api.interface';
+/**
+ * Тип для функции отписки от событий
+ */
+export type Unsubscribe = VoidFunction;
+/**
+ * Опции для выполнения запроса
+ */
+export interface QueryOptions {
+    /** Отключить кэширование для этого запроса */
+    disableCache?: boolean;
+    /** Signal для отмены запроса */
+    signal?: AbortSignal;
+    /** Таймаут в миллисекундах (переопределяет глобальный) */
+    timeout?: number;
+    /** Дополнительные заголовки */
+    headers?: Headers;
+    /** Пользовательский контекст */
+    context?: Record<string, any>;
+    /** Ключи заголовков, влияющие на кэш (для конкретного запроса) */
+    cacheableHeaderKeys?: string[];
+    /** Формат ответа (переопределяет формат из RequestDefinition) */
+    responseFormat?: ResponseFormat;
+    /** Название файла при скачивании (переопределяет fileName из RequestDefinition) */
+    fileName?: string;
+    /** Тип файла при скачивании (переопределяет fileType из RequestDefinition) */
+    fileType?: string;
+    /** Автоматически скачать файл после получения */
+    downloadFile?: boolean;
+    /** Конфигурация retry для этого запроса (переопределяет эндпоинт и глобальную) */
+    retry?: RetryConfig;
+}
+/**
+ * Метаданные для файла
+ */
+export interface FileMetadata {
+    /** Имя файла */
+    fileName: string;
+    /** Тип файла (MIME-тип) */
+    fileType: string;
+    /** Размер файла в байтах */
+    size?: number;
+    /** Дата создания файла */
+    createdAt?: Date | string;
+    /** Дата изменения файла */
+    updatedAt?: Date | string;
+}
+/**
+ * Результат скачивания файла
+ */
+export interface FileDownloadResult<T = Blob | ArrayBuffer> {
+    /** Данные файла */
+    data: T;
+    /** Метаданные файла */
+    metadata: FileMetadata;
+    /** HTTP-статус */
+    status: number;
+    /** Текст статуса */
+    statusText: string;
+    /** Заголовки ответа */
+    headers: Headers;
+    /** Успешна ли загрузка */
+    ok: boolean;
+}
+/**
+ * Результат выполнения запроса
+ */
+export interface QueryResult<T = any, E = Error> {
+    /** Данные ответа (при успешном запросе) */
+    data?: T;
+    /** Ошибка (при неуспешном запросе) */
+    error?: E;
+    /** Флаг успешности запроса */
+    ok: boolean;
+    /** HTTP-статус */
+    status: number;
+    /** Текстовое описание статуса */
+    statusText: string;
+    /** Заголовки ответа */
+    headers: Headers;
+    /** Результат скачивания файла (если responseFormat - Blob или ArrayBuffer) */
+    fileDownloadResult?: FileDownloadResult;
+    fromCache?: boolean;
+}
+//# sourceMappingURL=query.interface.d.ts.map

package/dist/api/types/query.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.interface.d.ts","sourceRoot":"","sources":["../../../src/api/types/query.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7D;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAA;AAEtC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gCAAgC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC9B,iEAAiE;IACjE,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kFAAkF;IAClF,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACzB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,IAAI,GAAG,WAAW;IACxD,mBAAmB;IACnB,IAAI,EAAE,CAAC,CAAA;IACP,uBAAuB;IACvB,QAAQ,EAAE,YAAY,CAAA;IACtB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,0BAA0B;IAC1B,EAAE,EAAE,OAAO,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,KAAK;IAC7C,2CAA2C;IAC3C,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,sCAAsC;IACtC,KAAK,CAAC,EAAE,CAAC,CAAA;IACT,8BAA8B;IAC9B,EAAE,EAAE,OAAO,CAAA;IACX,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB"}

package/dist/api/types/query.interface.js

@@ -0,0 +1,6 @@
+/**
+ * Результат выполнения запроса
+ */ 
+
+
+//# sourceMappingURL=query.interface.js.map

package/dist/api/types/query.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/types/query.interface.js","sources":["../../../src/api/types/query.interface.ts"],"sourcesContent":["import { ResponseFormat, RetryConfig } from './api.interface'\n\n/**\n * Тип для функции отписки от событий\n */\nexport type Unsubscribe = VoidFunction\n\n/**\n * Опции для выполнения запроса\n */\nexport interface QueryOptions {\n  /** Отключить кэширование для этого запроса */\n  disableCache?: boolean\n  /** Signal для отмены запроса */\n  signal?: AbortSignal\n  /** Таймаут в миллисекундах (переопределяет глобальный) */\n  timeout?: number\n  /** Дополнительные заголовки */\n  headers?: Headers\n  /** Пользовательский контекст */\n  context?: Record<string, any>\n  /** Ключи заголовков, влияющие на кэш (для конкретного запроса) */\n  cacheableHeaderKeys?: string[]\n  /** Формат ответа (переопределяет формат из RequestDefinition) */\n  responseFormat?: ResponseFormat\n  /** Название файла при скачивании (переопределяет fileName из RequestDefinition) */\n  fileName?: string\n  /** Тип файла при скачивании (переопределяет fileType из RequestDefinition) */\n  fileType?: string\n  /** Автоматически скачать файл после получения */\n  downloadFile?: boolean\n  /** Конфигурация retry для этого запроса (переопределяет эндпоинт и глобальную) */\n  retry?: RetryConfig\n}\n\n/**\n * Метаданные для файла\n */\nexport interface FileMetadata {\n  /** Имя файла */\n  fileName: string\n  /** Тип файла (MIME-тип) */\n  fileType: string\n  /** Размер файла в байтах */\n  size?: number\n  /** Дата создания файла */\n  createdAt?: Date | string\n  /** Дата изменения файла */\n  updatedAt?: Date | string\n}\n\n/**\n * Результат скачивания файла\n */\nexport interface FileDownloadResult<T = Blob | ArrayBuffer> {\n  /** Данные файла */\n  data: T\n  /** Метаданные файла */\n  metadata: FileMetadata\n  /** HTTP-статус */\n  status: number\n  /** Текст статуса */\n  statusText: string\n  /** Заголовки ответа */\n  headers: Headers\n  /** Успешна ли загрузка */\n  ok: boolean\n}\n\n/**\n * Результат выполнения запроса\n */\nexport interface QueryResult<T = any, E = Error> {\n  /** Данные ответа (при успешном запросе) */\n  data?: T\n  /** Ошибка (при неуспешном запросе) */\n  error?: E\n  /** Флаг успешности запроса */\n  ok: boolean\n  /** HTTP-статус */\n  status: number\n  /** Текстовое описание статуса */\n  statusText: string\n  /** Заголовки ответа */\n  headers: Headers\n  /** Результат скачивания файла (если responseFormat - Blob или ArrayBuffer) */\n  fileDownloadResult?: FileDownloadResult\n  fromCache?: boolean\n}\n"],"names":[],"mappings":"AAqEA;;CAEC,GAiBA"}

package/dist/api/utils/api-helpers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Логгер для API
+ */
+export declare const apiLogger: {
+    debug: (message: string, ...args: any[]) => void;
+    log: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+};
+/**
+ * Создает уникальный идентификатор
+ * @returns Строка с уникальным идентификатором
+ */
+export declare function createUniqueId(name?: string): string;
+/**
+ * Преобразует объект Headers в обычный объект
+ * @param headers Объект Headers
+ * @returns Обычный объект с заголовками
+ */
+export declare function headersToObject(headers: Headers): Record<string, string>;
+//# sourceMappingURL=api-helpers.d.ts.map

package/dist/api/utils/api-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-helpers.d.ts","sourceRoot":"","sources":["../../../src/api/utils/api-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;qBACH,MAAM,WAAW,GAAG,EAAE;mBAMxB,MAAM,WAAW,GAAG,EAAE;oBAMrB,MAAM,WAAW,GAAG,EAAE;oBAItB,MAAM,WAAW,GAAG,EAAE;qBAIrB,MAAM,WAAW,GAAG,EAAE;CAGxC,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxE"}

package/dist/api/utils/api-helpers.js

@@ -0,0 +1,44 @@
+/**
+ * Логгер для API
+ */ const apiLogger = {
+    debug: (message, ...args)=>{
+        if (process.env.NODE_ENV !== 'production') {
+            console.debug(`[API] ${message}`, ...args);
+        }
+    },
+    log: (message, ...args)=>{
+        if (process.env.NODE_ENV !== 'production') {
+            console.log(`[API] ${message}`, ...args);
+        }
+    },
+    info: (message, ...args)=>{
+        console.info(`[API] ${message}`, ...args);
+    },
+    warn: (message, ...args)=>{
+        console.warn(`[API] ${message}`, ...args);
+    },
+    error: (message, ...args)=>{
+        console.error(`[API] ${message}`, ...args);
+    }
+};
+/**
+ * Создает уникальный идентификатор
+ * @returns Строка с уникальным идентификатором
+ */ function createUniqueId(name) {
+    return `${name ? `${name}|` : ''}${Math.random().toString(36).substring(2, 9) + Date.now().toString(36)}`;
+}
+/**
+ * Преобразует объект Headers в обычный объект
+ * @param headers Объект Headers
+ * @returns Обычный объект с заголовками
+ */ function headersToObject(headers) {
+    const result = {};
+    headers.forEach((value, key)=>{
+        result[key.toLowerCase()] = value;
+    });
+    return result;
+}
+
+export { apiLogger, createUniqueId, headersToObject };
+
+//# sourceMappingURL=api-helpers.js.map

package/dist/api/utils/api-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/utils/api-helpers.js","sources":["../../../src/api/utils/api-helpers.ts"],"sourcesContent":["/**\n * Логгер для API\n */\nexport const apiLogger = {\n  debug: (message: string, ...args: any[]) => {\n    if (process.env.NODE_ENV !== 'production') {\n      console.debug(`[API] ${message}`, ...args)\n    }\n  },\n\n  log: (message: string, ...args: any[]) => {\n    if (process.env.NODE_ENV !== 'production') {\n      console.log(`[API] ${message}`, ...args)\n    }\n  },\n\n  info: (message: string, ...args: any[]) => {\n    console.info(`[API] ${message}`, ...args)\n  },\n\n  warn: (message: string, ...args: any[]) => {\n    console.warn(`[API] ${message}`, ...args)\n  },\n\n  error: (message: string, ...args: any[]) => {\n    console.error(`[API] ${message}`, ...args)\n  },\n}\n\n/**\n * Создает уникальный идентификатор\n * @returns Строка с уникальным идентификатором\n */\nexport function createUniqueId(name?: string): string {\n  return `${name ? `${name}|` : ''}${Math.random().toString(36).substring(2, 9) + Date.now().toString(36)}`\n}\n\n/**\n * Преобразует объект Headers в обычный объект\n * @param headers Объект Headers\n * @returns Обычный объект с заголовками\n */\nexport function headersToObject(headers: Headers): Record<string, string> {\n  const result: Record<string, string> = {}\n  headers.forEach((value, key) => {\n    result[key.toLowerCase()] = value\n  })\n  return result\n}\n"],"names":["apiLogger","message","args","process","console","createUniqueId","name","Math","Date","headersToObject","headers","result","value","key"],"mappings":"AAAA;;CAEC,GACM,MAAMA,SAASA,GAAG;IACvB,OAAO,CAACC,SAAiB,GAAGC;QAC1B,IAAIC,QAAQ,GAAG,CAAC,QAAQ,KAAK,cAAc;YACzCC,QAAQ,KAAK,CAAC,CAAC,MAAM,EAAEH,SAAS,KAAKC;QACvC;IACF;IAEA,KAAK,CAACD,SAAiB,GAAGC;QACxB,IAAIC,QAAQ,GAAG,CAAC,QAAQ,KAAK,cAAc;YACzCC,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAEH,SAAS,KAAKC;QACrC;IACF;IAEA,MAAM,CAACD,SAAiB,GAAGC;QACzBE,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAEH,SAAS,KAAKC;IACtC;IAEA,MAAM,CAACD,SAAiB,GAAGC;QACzBE,QAAQ,IAAI,CAAC,CAAC,MAAM,EAAEH,SAAS,KAAKC;IACtC;IAEA,OAAO,CAACD,SAAiB,GAAGC;QAC1BE,QAAQ,KAAK,CAAC,CAAC,MAAM,EAAEH,SAAS,KAAKC;IACvC;AACF,EAAC;AAED;;;CAGC,GACM,SAASG,cAAcA,CAACC,IAAa;IAC1C,OAAO,GAAGA,OAAO,GAAGA,KAAK,CAAC,CAAC,GAAG,KAAKC,KAAK,MAAM,GAAG,QAAQ,CAAC,IAAI,SAAS,CAAC,GAAG,KAAKC,KAAK,GAAG,GAAG,QAAQ,CAAC,KAAK;AAC3G;AAEA;;;;CAIC,GACM,SAASC,eAAeA,CAACC,OAAgB;IAC9C,MAAMC,SAAiC,CAAC;IACxCD,QAAQ,OAAO,CAAC,CAACE,OAAOC;QACtBF,MAAM,CAACE,IAAI,WAAW,GAAG,GAAGD;IAC9B;IACA,OAAOD;AACT"}

package/dist/api/utils/create-header-context.d.ts

@@ -0,0 +1,10 @@
+import { ApiContext } from '../types/api.interface';
+/**
+ * Создает контекст для подготовки заголовков
+ *
+ * @param context - базовый контекст
+ * @param optionContext - дополнительный контекст из опций
+ * @returns - полный контекст для подготовки заголовков
+ */
+export declare function createHeaderContext<RequestParams extends Record<string, any>>(context?: Partial<ApiContext>, optionContext?: Record<string, any>): ApiContext<RequestParams>;
+//# sourceMappingURL=create-header-context.d.ts.map

package/dist/api/utils/create-header-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-header-context.d.ts","sourceRoot":"","sources":["../../../src/api/utils/create-header-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3E,OAAO,GAAE,OAAO,CAAC,UAAU,CAAmC,EAC9D,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACtC,UAAU,CAAC,aAAa,CAAC,CA6B3B"}

package/dist/api/utils/create-header-context.js

@@ -0,0 +1,40 @@
+import { logError } from "../../_utils/error-handling.util.js";
+
+
+
+/**
+ * Создает контекст для подготовки заголовков
+ *
+ * @param context - базовый контекст
+ * @param optionContext - дополнительный контекст из опций
+ * @returns - полный контекст для подготовки заголовков
+ */ function createHeaderContext(context = {}, optionContext = {}) {
+    return {
+        ...context,
+        ...optionContext,
+        getFromStorage: context.getFromStorage || ((key)=>{
+            try {
+                if (typeof globalThis.localStorage === 'undefined') return undefined;
+                const item = localStorage.getItem(key);
+                return item ? JSON.parse(item) : undefined;
+            } catch (error) {
+                logError('createHeaderContext: error reading from localStorage', error, null, 'warn');
+                return undefined;
+            }
+        }),
+        getCookie: context.getCookie || ((name)=>{
+            try {
+                if (typeof globalThis.document === 'undefined') return undefined;
+                const matches = document.cookie.match(new RegExp(`(?:^|; )${name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1')}=([^;]*)`));
+                return matches ? decodeURIComponent(matches[1]) : undefined;
+            } catch (error) {
+                logError('createHeaderContext: error reading cookie', error, null, 'warn');
+                return undefined;
+            }
+        })
+    };
+}
+
+export { createHeaderContext };
+
+//# sourceMappingURL=create-header-context.js.map

package/dist/api/utils/create-header-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/utils/create-header-context.js","sources":["../../../src/api/utils/create-header-context.ts"],"sourcesContent":["import { logError } from '../../_utils/error-handling.util'\nimport { ApiContext } from '../types/api.interface'\n\n/**\n * Создает контекст для подготовки заголовков\n *\n * @param context - базовый контекст\n * @param optionContext - дополнительный контекст из опций\n * @returns - полный контекст для подготовки заголовков\n */\nexport function createHeaderContext<RequestParams extends Record<string, any>>(\n  context: Partial<ApiContext> = {} as ApiContext<RequestParams>,\n  optionContext: Record<string, any> = {},\n): ApiContext<RequestParams> {\n  return {\n    ...context,\n    ...optionContext,\n    getFromStorage:\n      context.getFromStorage ||\n      ((key: string) => {\n        try {\n          if (typeof globalThis.localStorage === 'undefined') return undefined\n          const item = localStorage.getItem(key)\n          return item ? JSON.parse(item) : undefined\n        } catch (error) {\n          logError('createHeaderContext: error reading from localStorage', error, null, 'warn')\n          return undefined\n        }\n      }),\n    getCookie:\n      context.getCookie ||\n      ((name: string) => {\n        try {\n          if (typeof globalThis.document === 'undefined') return undefined\n          const matches = document.cookie.match(new RegExp(`(?:^|; )${name.replace(/([\\.$?*|{}\\(\\)\\[\\]\\\\\\/\\+^])/g, '\\\\$1')}=([^;]*)`))\n          return matches ? decodeURIComponent(matches[1]) : undefined\n        } catch (error) {\n          logError('createHeaderContext: error reading cookie', error, null, 'warn')\n          return undefined\n        }\n      }),\n  }\n}\n"],"names":["logError","createHeaderContext","context","optionContext","key","globalThis","undefined","item","localStorage","JSON","error","name","matches","document","RegExp","decodeURIComponent"],"mappings":";;;AAA2D;AAG3D;;;;;;CAMC,GACM,SAASC,mBAAmBA,CACjCC,UAA+B,CAAC,CAA8B,EAC9DC,gBAAqC,CAAC,CAAC;IAEvC,OAAO;QACL,GAAGD,OAAO;QACV,GAAGC,aAAa;QAChB,gBACED,QAAQ,cAAc,IACrB,EAACE;YACA,IAAI;gBACF,IAAI,OAAOC,WAAW,YAAY,KAAK,aAAa,OAAOC;gBAC3D,MAAMC,OAAOC,aAAa,OAAO,CAACJ;gBAClC,OAAOG,OAAOE,KAAK,KAAK,CAACF,QAAQD;YACnC,EAAE,OAAOI,OAAO;gBACdV,QAAQA,CAAC,wDAAwDU,OAAO,MAAM;gBAC9E,OAAOJ;YACT;QACF;QACF,WACEJ,QAAQ,SAAS,IAChB,EAACS;YACA,IAAI;gBACF,IAAI,OAAON,WAAW,QAAQ,KAAK,aAAa,OAAOC;gBACvD,MAAMM,UAAUC,SAAS,MAAM,CAAC,KAAK,CAAC,IAAIC,OAAO,CAAC,QAAQ,EAAEH,KAAK,OAAO,CAAC,gCAAgC,QAAQ,QAAQ,CAAC;gBAC1H,OAAOC,UAAUG,mBAAmBH,OAAO,CAAC,EAAE,IAAIN;YACpD,EAAE,OAAOI,OAAO;gBACdV,QAAQA,CAAC,6CAA6CU,OAAO,MAAM;gBACnE,OAAOJ;YACT;QACF;IACJ;AACF"}

package/dist/api/utils/endpoint-headers.d.ts

@@ -0,0 +1,23 @@
+import { ApiContext } from '../types/api.interface';
+/**
+ * Тип функции для подготовки заголовков запроса
+ */
+export type PrepareHeadersFunction = (headers: Headers, context: ApiContext<any>) => Promise<Headers>;
+/**
+ * Подготавливает заголовки для запроса на основе контекста и пользовательских функций
+ *
+ * @param prepareHeadersFn - функция подготовки заголовков
+ * @param context - контекст запроса
+ * @returns - подготовленные заголовки
+ */
+export declare function prepareRequestHeaders<RequestParams extends Record<string, any>>(prepareHeadersFn?: PrepareHeadersFunction, context?: ApiContext<RequestParams>): Promise<Headers>;
+/**
+ * Создает комбинированную функцию для подготовки заголовков, объединяющую
+ * глобальные заголовки и заголовки эндпоинта
+ *
+ * @param globalPrepareHeaders - функция подготовки заголовков на глобальном уровне
+ * @param endpointPrepareHeaders - функция подготовки заголовков на уровне эндпоинта
+ * @returns - функция для подготовки заголовков
+ */
+export declare function createPrepareHeaders(globalPrepareHeaders?: PrepareHeadersFunction, endpointPrepareHeaders?: PrepareHeadersFunction): PrepareHeadersFunction;
+//# sourceMappingURL=endpoint-headers.d.ts.map

package/dist/api/utils/endpoint-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-headers.d.ts","sourceRoot":"","sources":["../../../src/api/utils/endpoint-headers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGnD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAErG;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnF,gBAAgB,CAAC,EAAE,sBAAsB,EACzC,OAAO,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,oBAAoB,CAAC,EAAE,sBAAsB,EAAE,sBAAsB,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,CAwB3J"}