synapse-storage 3.0.19 → 4.0.1

package/dist/api/components/query-storage.d.ts

@@ -0,0 +1,100 @@
+import { IStorage, StorageKeyType } from '../../core';
+import { CacheConfig, CreateApiClientOptions, StorageOption } from '../types/api.interface';
+import { EndpointConfig } from '../types/endpoint.interface';
+import { QueryOptions } from '../types/query.interface';
+/**
+ * Менеджер хранилища для API
+ * Объединяет в себе функционал хранилища и управления кэшем
+ */
+export declare class QueryStorage {
+    private readonly storageExternal;
+    private readonly globalCacheConfig;
+    /** Экземпляр хранилища */
+    private storage;
+    private cleanupInterval;
+    /** Индекс тегов: tag → Set<cacheKey> для быстрой инвалидации */
+    private tagIndex;
+    /** Настройки кэша по умолчанию */
+    private defaultCacheOptions;
+    /** Флаг завершённой инициализации */
+    private _initialized;
+    /** Промис текущей инициализации */
+    private _initPromise;
+    constructor(storageExternal: StorageOption, globalCacheConfig: CreateApiClientOptions['cache']);
+    initialize(): Promise<this>;
+    private _doInitialize;
+    private createStorage;
+    private startCleanupInterval;
+    /**
+     * Получает экземпляр хранилища
+     */
+    getStorage(): IStorage | null;
+    /**
+     * Создает ключ кэша для запроса с учетом заголовков
+     * @param endpoint Имя эндпоинта
+     * @param params Параметры запроса (все что посчитаем нужным)
+     */
+    createCacheKey<CacheParams extends Record<string, any>>(endpoint: string, params: CacheParams): [StorageKeyType, Record<string, any> | undefined];
+    /**
+     * Получает результат запроса из кэша
+     */
+    getCachedResult<T>(cacheKey: StorageKeyType): Promise<T | undefined>;
+    /**
+     * Сохраняет результат запроса в кэш
+     * @param cacheKey Ключ кэша
+     * @param data Данные для кэширования
+     * @param cacheOptions Метаданные
+     * @param cacheParams Параметры которые влияли на создание ключа
+     * @param tags Тэги эндпоинта
+     */
+    setCachedResult<T, CacheParams extends Record<string, any>>(cacheKey: StorageKeyType, data: T, cacheOptions: Exclude<CacheConfig, boolean>, cacheParams: CacheParams, tags: string[]): Promise<void>;
+    /**
+     * Проверяет, должен ли запрос быть кэширован
+     * @param endpointConfig Конфигурация эндпоинта
+     * @param options Опции запроса
+     * @param method HTTP-метод запроса (только GET кэшируется по REST-стандарту)
+     * @returns true если запрос должен кэшироваться
+     */
+    shouldCache(endpointConfig?: EndpointConfig, options?: QueryOptions, method?: string): boolean;
+    /**
+     * Создает итоговую конфигурацию кэширования для конкретного эндпоинта
+     * Объединяет глобальный конфиг с текущим
+     * @param endpointConfig Конфигурация эндпоинта
+     */
+    createCacheConfig(endpointConfig?: EndpointConfig): {
+        ttl?: number;
+        cleanup?: {
+            enabled: boolean;
+            interval?: number;
+        };
+        invalidateOnError?: boolean;
+    };
+    /**
+     * Инвалидирует кэш по тегам (использует индекс для O(1) поиска по тегу)
+     * @param tags Теги для инвалидации
+     */
+    invalidateCacheByTags(tags: string[]): Promise<void>;
+    /**
+     * Инвалидирует кэш по ключу
+     * @param cacheKey Ключ кэша
+     */
+    invalidateCache(cacheKey: StorageKeyType): Promise<void>;
+    /**
+     * Выполняет очистку всех просроченных записей кэша
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Уничтожает хранилище и освобождает ресурсы
+     */
+    destroy(): Promise<void>;
+    /**
+     * Перестраивает индекс тегов из существующих записей в storage
+     * Вызывается при инициализации для восстановления после перезагрузки
+     */
+    private rebuildTagIndex;
+    /**
+     * Удаляет ключ из индекса тегов
+     */
+    private removeKeyFromTagIndex;
+}
+//# sourceMappingURL=query-storage.d.ts.map

package/dist/api/components/query-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-storage.d.ts","sourceRoot":"","sources":["../../../src/api/components/query-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAErD,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD;;;GAGG;AACH,qBAAa,YAAY;IA0BrB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IA1BpC,0BAA0B;IAC1B,OAAO,CAAC,OAAO,CAAwB;IAEvC,OAAO,CAAC,eAAe,CAAuC;IAE9D,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAiC;IAEjD,kCAAkC;IAClC,OAAO,CAAC,mBAAmB,CAO1B;IAED,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAAQ;IAE5B,mCAAmC;IACnC,OAAO,CAAC,YAAY,CAA6B;gBAG9B,eAAe,EAAE,aAAa,EAC9B,iBAAiB,EAAE,sBAAsB,CAAC,OAAO,CAAC;IAGxD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAQ1B,aAAa;YAiBb,aAAa;IAY3B,OAAO,CAAC,oBAAoB;IAiB5B;;OAEG;IACI,UAAU,IAAI,QAAQ,GAAG,IAAI;IAIpC;;;;OAIG;IACI,cAAc,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;IAIpG;;OAEG;IACU,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAuBjF;;;;;;;OAOG;IACU,eAAe,CAAC,CAAC,EAAE,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrE,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,CAAC,EACP,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,EAC3C,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC;IA2BhB;;;;;;OAMG;IACI,WAAW,CAAC,cAAc,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM;IAiB3F;;;;OAIG;IACI,iBAAiB,CAAC,cAAc,CAAC,EAAE,cAAc;;;;oBAvLpD,CAAN;;;;IA2ME;;;OAGG;IACU,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjE;;;OAGG;IACU,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrE;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAerC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrC;;;OAGG;YACW,eAAe;IA4B7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAU9B"}

package/dist/api/components/query-storage.js

@@ -0,0 +1,293 @@
+import { handleCleanupError, handleOperationError } from "../../_utils/error-handling.util.js";
+import { CacheUtils } from "../../core/storage/utils/cache.util.js";
+
+
+
+
+
+/**
+ * Менеджер хранилища для API
+ * Объединяет в себе функционал хранилища и управления кэшем
+ */ class QueryStorage {
+    storageExternal;
+    globalCacheConfig;
+    /** Экземпляр хранилища */ storage = null;
+    cleanupInterval = null;
+    /** Индекс тегов: tag → Set<cacheKey> для быстрой инвалидации */ tagIndex = new Map();
+    /** Настройки кэша по умолчанию */ defaultCacheOptions = {
+        ttl: 5 * 60 * 1000,
+        cleanup: {
+            enabled: true,
+            interval: 10 * 60 * 1000
+        },
+        invalidateOnError: true
+    };
+    /** Флаг завершённой инициализации */ _initialized = false;
+    /** Промис текущей инициализации */ _initPromise = null;
+    constructor(storageExternal, globalCacheConfig){
+        this.storageExternal = storageExternal;
+        this.globalCacheConfig = globalCacheConfig;
+    }
+    async initialize() {
+        if (this._initialized) return this;
+        if (this._initPromise) return this._initPromise;
+        this._initPromise = this._doInitialize();
+        return this._initPromise;
+    }
+    async _doInitialize() {
+        try {
+            // 1. Создаем хранилище
+            await this.createStorage();
+            // 2. Перестраиваем индекс тегов из существующих записей в storage
+            await this.rebuildTagIndex();
+            // 3. Запускаем периодическую очистку, если это указано в настройках
+            this.startCleanupInterval();
+            this._initialized = true;
+            return this;
+        } catch (error) {
+            this._initPromise = null;
+            throw error;
+        }
+    }
+    async createStorage() {
+        try {
+            // Резолвим storage: может быть инстанс или фабрика
+            const s = typeof this.storageExternal === 'function' ? await this.storageExternal() : this.storageExternal;
+            await s.initialize();
+            this.storage = s;
+        } catch (error) {
+            handleOperationError('QueryStorage: storage initialization error', error);
+        }
+    }
+    startCleanupInterval() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        // Получаем настройки очистки
+        const cleanupConfig = typeof this.globalCacheConfig === 'object' ? this.globalCacheConfig.cleanup : this.defaultCacheOptions.cleanup;
+        // Запускаем интервал очистки, если он включен
+        if (cleanupConfig?.enabled && cleanupConfig.interval) {
+            this.cleanupInterval = setInterval(()=>{
+                this.cleanup().catch((err)=>handleCleanupError('QueryStorage: cache cleanup error', err));
+            }, cleanupConfig.interval);
+        }
+    }
+    /**
+   * Получает экземпляр хранилища
+   */ getStorage() {
+        return this.storage;
+    }
+    /**
+   * Создает ключ кэша для запроса с учетом заголовков
+   * @param endpoint Имя эндпоинта
+   * @param params Параметры запроса (все что посчитаем нужным)
+   */ createCacheKey(endpoint, params) {
+        return CacheUtils.createApiKey(endpoint, params);
+    }
+    /**
+   * Получает результат запроса из кэша
+   */ async getCachedResult(cacheKey) {
+        if (!this.storage) throw new Error('Хранилище не инициализировано');
+        const cachedEntry = await this.storage.get(cacheKey);
+        if (!cachedEntry) return undefined;
+        // Проверяем срок годности кэша
+        if (CacheUtils.isExpired(cachedEntry.metadata)) {
+            this.removeKeyFromTagIndex(String(cacheKey), cachedEntry.metadata.tags);
+            await this.storage.remove(cacheKey);
+            return undefined;
+        }
+        // Обновляем метаданные кэша (счетчик доступа, время обновления)
+        const updatedEntry = {
+            ...cachedEntry,
+            metadata: CacheUtils.updateMetadata(cachedEntry.metadata)
+        };
+        await this.storage.set(cacheKey, updatedEntry);
+        return cachedEntry.data;
+    }
+    /**
+   * Сохраняет результат запроса в кэш
+   * @param cacheKey Ключ кэша
+   * @param data Данные для кэширования
+   * @param cacheOptions Метаданные
+   * @param cacheParams Параметры которые влияли на создание ключа
+   * @param tags Тэги эндпоинта
+   */ async setCachedResult(cacheKey, data, cacheOptions, cacheParams, tags) {
+        if (!this.storage) throw new Error('Хранилище не инициализировано');
+        // Создаем метаданные кэша
+        const cacheMetadata = CacheUtils.createMetadata(cacheOptions.ttl, tags);
+        // Создаем запись кэша
+        const cacheEntry = {
+            data,
+            metadata: cacheMetadata,
+            params: cacheParams
+        };
+        await this.storage.set(cacheKey, cacheEntry);
+        // Обновляем индекс тегов
+        const keyStr = String(cacheKey);
+        for (const tag of tags){
+            let keys = this.tagIndex.get(tag);
+            if (!keys) {
+                keys = new Set();
+                this.tagIndex.set(tag, keys);
+            }
+            keys.add(keyStr);
+        }
+    }
+    /**
+   * Проверяет, должен ли запрос быть кэширован
+   * @param endpointConfig Конфигурация эндпоинта
+   * @param options Опции запроса
+   * @param method HTTP-метод запроса (только GET кэшируется по REST-стандарту)
+   * @returns true если запрос должен кэшироваться
+   */ shouldCache(endpointConfig, options, method) {
+        // Мутации (POST/PUT/DELETE/PATCH) не кэшируются по REST-стандарту
+        if (method && method !== 'GET') return false;
+        // Если глобальный кэш отключен, возвращаем false
+        if (this.globalCacheConfig === false) return false;
+        // Если эндпоинт явно отключает кэш, возвращаем false
+        if (endpointConfig?.cache === false) return false;
+        // Если по какой то причине указали время кэша 0
+        if (typeof endpointConfig?.cache === 'object' && endpointConfig?.cache.ttl === 0) return false;
+        // Если при вызове самого запроса явно указали НЕ кэшировать
+        if (options?.disableCache === true) return false;
+        // Если настройки нигде не указаны - по умолчанию НЕ кэшируем
+        if (this.globalCacheConfig === undefined && endpointConfig?.cache === undefined) return false;
+        return true;
+    }
+    /**
+   * Создает итоговую конфигурацию кэширования для конкретного эндпоинта
+   * Объединяет глобальный конфиг с текущим
+   * @param endpointConfig Конфигурация эндпоинта
+   */ createCacheConfig(endpointConfig) {
+        // Создаем опции по умолчанию
+        let resultConfig = this.defaultCacheOptions;
+        // Если в глобальном конфиге кэш передан как объект а не boolean - по умолчанию станет он
+        if (typeof this.globalCacheConfig === 'object') {
+            resultConfig = this.globalCacheConfig;
+        }
+        // Если в настройках эндпоинта кэш как объект - дополняем этими параметрами итоговый объект кэша
+        if (typeof endpointConfig?.cache === 'object') {
+            const endpointCache = endpointConfig.cache;
+            resultConfig = {
+                ...resultConfig,
+                ...endpointCache
+            };
+        }
+        return resultConfig;
+    }
+    /**
+   * Инвалидирует кэш по тегам (использует индекс для O(1) поиска по тегу)
+   * @param tags Теги для инвалидации
+   */ async invalidateCacheByTags(tags) {
+        if (!this.storage) throw new Error('Хранилище не инициализировано');
+        // Собираем все ключи для удаления через индекс
+        const keysToRemove = new Set();
+        for (const tag of tags){
+            const keys = this.tagIndex.get(tag);
+            if (keys) {
+                keys.forEach((k)=>keysToRemove.add(k));
+                this.tagIndex.delete(tag);
+            }
+        }
+        // Удаляем из остальных тегов индекса (ключ может быть в нескольких тегах)
+        for (const key of keysToRemove){
+            for (const [tag, keys] of this.tagIndex){
+                keys.delete(key);
+                if (keys.size === 0) this.tagIndex.delete(tag);
+            }
+        }
+        // Удаляем записи из хранилища
+        await Promise.all([
+            ...keysToRemove
+        ].map((key)=>this.storage.remove(key)));
+    }
+    /**
+   * Инвалидирует кэш по ключу
+   * @param cacheKey Ключ кэша
+   */ async invalidateCache(cacheKey) {
+        if (!this.storage) throw new Error('Хранилище не инициализировано');
+        // Читаем теги записи для очистки индекса
+        const cachedEntry = await this.storage.get(cacheKey);
+        if (cachedEntry) {
+            this.removeKeyFromTagIndex(String(cacheKey), cachedEntry.metadata.tags);
+        }
+        await this.storage.remove(cacheKey);
+    }
+    /**
+   * Выполняет очистку всех просроченных записей кэша
+   */ async cleanup() {
+        if (!this.storage) {
+            throw new Error('Хранилище не инициализировано');
+        }
+        const keys = await this.storage.keys();
+        for (const key of keys){
+            const value = await this.storage.get(key);
+            if (value && CacheUtils.isExpired(value.metadata)) {
+                this.removeKeyFromTagIndex(String(key), value.metadata.tags);
+                await this.storage.remove(key);
+            }
+        }
+    }
+    /**
+   * Уничтожает хранилище и освобождает ресурсы
+   */ async destroy() {
+        // Останавливаем интервал очистки
+        if (this.cleanupInterval) {
+            globalThis.clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        // Очищаем индекс тегов
+        this.tagIndex.clear();
+        // Очищаем хранилище
+        if (this.storage) {
+            await this.storage.destroy();
+            this.storage = null;
+        }
+        // Сбрасываем состояние инициализации
+        this._initialized = false;
+        this._initPromise = null;
+    }
+    /**
+   * Перестраивает индекс тегов из существующих записей в storage
+   * Вызывается при инициализации для восстановления после перезагрузки
+   */ async rebuildTagIndex() {
+        if (!this.storage) return;
+        this.tagIndex.clear();
+        const keys = await this.storage.keys();
+        for (const key of keys){
+            const entry = await this.storage.get(key);
+            if (!entry?.metadata?.tags) continue;
+            // Удаляем протухшие записи сразу
+            if (CacheUtils.isExpired(entry.metadata)) {
+                await this.storage.remove(key);
+                continue;
+            }
+            const keyStr = String(key);
+            for (const tag of entry.metadata.tags){
+                let tagKeys = this.tagIndex.get(tag);
+                if (!tagKeys) {
+                    tagKeys = new Set();
+                    this.tagIndex.set(tag, tagKeys);
+                }
+                tagKeys.add(keyStr);
+            }
+        }
+    }
+    /**
+   * Удаляет ключ из индекса тегов
+   */ removeKeyFromTagIndex(key, tags) {
+        if (!tags) return;
+        for (const tag of tags){
+            const keys = this.tagIndex.get(tag);
+            if (keys) {
+                keys.delete(key);
+                if (keys.size === 0) this.tagIndex.delete(tag);
+            }
+        }
+    }
+}
+
+export { QueryStorage };
+
+//# sourceMappingURL=query-storage.js.map

package/dist/api/components/query-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/components/query-storage.js","sources":["../../../src/api/components/query-storage.ts"],"sourcesContent":["import { handleCleanupError, handleOperationError } from '../../_utils/error-handling.util'\nimport { IStorage, StorageKeyType } from '../../core'\nimport { CacheEntry, CacheUtils } from '../../core/storage/utils/cache.util'\nimport { CacheConfig, CreateApiClientOptions, StorageOption } from '../types/api.interface'\nimport { EndpointConfig } from '../types/endpoint.interface'\nimport { QueryOptions } from '../types/query.interface'\n\n/**\n * Менеджер хранилища для API\n * Объединяет в себе функционал хранилища и управления кэшем\n */\nexport class QueryStorage {\n  /** Экземпляр хранилища */\n  private storage: IStorage | null = null\n\n  private cleanupInterval: NodeJS.Timeout | number | null = null\n\n  /** Индекс тегов: tag → Set<cacheKey> для быстрой инвалидации */\n  private tagIndex = new Map<string, Set<string>>()\n\n  /** Настройки кэша по умолчанию */\n  private defaultCacheOptions: Exclude<CacheConfig, boolean> = {\n    ttl: 5 * 60 * 1000, // 5 минут по умолчанию\n    cleanup: {\n      enabled: true,\n      interval: 10 * 60 * 1000, // 10 минут\n    },\n    invalidateOnError: true,\n  }\n\n  /** Флаг завершённой инициализации */\n  private _initialized = false\n\n  /** Промис текущей инициализации */\n  private _initPromise: Promise<this> | null = null\n\n  constructor(\n    private readonly storageExternal: StorageOption,\n    private readonly globalCacheConfig: CreateApiClientOptions['cache'],\n  ) {}\n\n  public async initialize(): Promise<this> {\n    if (this._initialized) return this\n    if (this._initPromise) return this._initPromise\n\n    this._initPromise = this._doInitialize()\n    return this._initPromise\n  }\n\n  private async _doInitialize(): Promise<this> {\n    try {\n      // 1. Создаем хранилище\n      await this.createStorage()\n      // 2. Перестраиваем индекс тегов из существующих записей в storage\n      await this.rebuildTagIndex()\n      // 3. Запускаем периодическую очистку, если это указано в настройках\n      this.startCleanupInterval()\n\n      this._initialized = true\n      return this\n    } catch (error) {\n      this._initPromise = null\n      throw error\n    }\n  }\n\n  private async createStorage() {\n    try {\n      // Резолвим storage: может быть инстанс или фабрика\n      const s: IStorage = typeof this.storageExternal === 'function' ? await this.storageExternal() : this.storageExternal\n\n      await s.initialize()\n      this.storage = s\n    } catch (error) {\n      handleOperationError('QueryStorage: storage initialization error', error)\n    }\n  }\n\n  private startCleanupInterval(): void {\n    if (this.cleanupInterval) {\n      clearInterval(this.cleanupInterval)\n      this.cleanupInterval = null\n    }\n\n    // Получаем настройки очистки\n    const cleanupConfig = typeof this.globalCacheConfig === 'object' ? this.globalCacheConfig.cleanup : this.defaultCacheOptions.cleanup\n\n    // Запускаем интервал очистки, если он включен\n    if (cleanupConfig?.enabled && cleanupConfig.interval) {\n      this.cleanupInterval = setInterval(() => {\n        this.cleanup().catch((err) => handleCleanupError('QueryStorage: cache cleanup error', err))\n      }, cleanupConfig.interval)\n    }\n  }\n\n  /**\n   * Получает экземпляр хранилища\n   */\n  public getStorage(): IStorage | null {\n    return this.storage\n  }\n\n  /**\n   * Создает ключ кэша для запроса с учетом заголовков\n   * @param endpoint Имя эндпоинта\n   * @param params Параметры запроса (все что посчитаем нужным)\n   */\n  public createCacheKey<CacheParams extends Record<string, any>>(endpoint: string, params: CacheParams) {\n    return CacheUtils.createApiKey(endpoint, params)\n  }\n\n  /**\n   * Получает результат запроса из кэша\n   */\n  public async getCachedResult<T>(cacheKey: StorageKeyType): Promise<T | undefined> {\n    if (!this.storage) throw new Error('Хранилище не инициализировано')\n\n    const cachedEntry = await this.storage.get<CacheEntry<T>>(cacheKey)\n    if (!cachedEntry) return undefined\n\n    // Проверяем срок годности кэша\n    if (CacheUtils.isExpired(cachedEntry.metadata)) {\n      this.removeKeyFromTagIndex(String(cacheKey), cachedEntry.metadata.tags)\n      await this.storage.remove(cacheKey)\n      return undefined\n    }\n\n    // Обновляем метаданные кэша (счетчик доступа, время обновления)\n    const updatedEntry: CacheEntry<T> = {\n      ...cachedEntry,\n      metadata: CacheUtils.updateMetadata(cachedEntry.metadata),\n    }\n    await this.storage.set(cacheKey, updatedEntry)\n\n    return cachedEntry.data\n  }\n\n  /**\n   * Сохраняет результат запроса в кэш\n   * @param cacheKey Ключ кэша\n   * @param data Данные для кэширования\n   * @param cacheOptions Метаданные\n   * @param cacheParams Параметры которые влияли на создание ключа\n   * @param tags Тэги эндпоинта\n   */\n  public async setCachedResult<T, CacheParams extends Record<string, any>>(\n    cacheKey: StorageKeyType,\n    data: T,\n    cacheOptions: Exclude<CacheConfig, boolean>,\n    cacheParams: CacheParams,\n    tags: string[],\n  ): Promise<void> {\n    if (!this.storage) throw new Error('Хранилище не инициализировано')\n\n    // Создаем метаданные кэша\n    const cacheMetadata = CacheUtils.createMetadata(cacheOptions.ttl, tags)\n\n    // Создаем запись кэша\n    const cacheEntry: CacheEntry<T> = {\n      data,\n      metadata: cacheMetadata,\n      params: cacheParams,\n    }\n\n    await this.storage.set(cacheKey, cacheEntry)\n\n    // Обновляем индекс тегов\n    const keyStr = String(cacheKey)\n    for (const tag of tags) {\n      let keys = this.tagIndex.get(tag)\n      if (!keys) {\n        keys = new Set()\n        this.tagIndex.set(tag, keys)\n      }\n      keys.add(keyStr)\n    }\n  }\n\n  /**\n   * Проверяет, должен ли запрос быть кэширован\n   * @param endpointConfig Конфигурация эндпоинта\n   * @param options Опции запроса\n   * @param method HTTP-метод запроса (только GET кэшируется по REST-стандарту)\n   * @returns true если запрос должен кэшироваться\n   */\n  public shouldCache(endpointConfig?: EndpointConfig, options?: QueryOptions, method?: string) {\n    // Мутации (POST/PUT/DELETE/PATCH) не кэшируются по REST-стандарту\n    if (method && method !== 'GET') return false\n    // Если глобальный кэш отключен, возвращаем false\n    if (this.globalCacheConfig === false) return false\n    // Если эндпоинт явно отключает кэш, возвращаем false\n    if (endpointConfig?.cache === false) return false\n    // Если по какой то причине указали время кэша 0\n    if (typeof endpointConfig?.cache === 'object' && endpointConfig?.cache.ttl === 0) return false\n    // Если при вызове самого запроса явно указали НЕ кэшировать\n    if (options?.disableCache === true) return false\n    // Если настройки нигде не указаны - по умолчанию НЕ кэшируем\n    if (this.globalCacheConfig === undefined && endpointConfig?.cache === undefined) return false\n\n    return true\n  }\n\n  /**\n   * Создает итоговую конфигурацию кэширования для конкретного эндпоинта\n   * Объединяет глобальный конфиг с текущим\n   * @param endpointConfig Конфигурация эндпоинта\n   */\n  public createCacheConfig(endpointConfig?: EndpointConfig) {\n    // Создаем опции по умолчанию\n    let resultConfig = this.defaultCacheOptions\n\n    // Если в глобальном конфиге кэш передан как объект а не boolean - по умолчанию станет он\n    if (typeof this.globalCacheConfig === 'object') {\n      resultConfig = this.globalCacheConfig\n    }\n    // Если в настройках эндпоинта кэш как объект - дополняем этими параметрами итоговый объект кэша\n    if (typeof endpointConfig?.cache === 'object') {\n      const endpointCache = endpointConfig.cache as Exclude<CacheConfig, boolean>\n      resultConfig = {\n        ...resultConfig,\n        ...endpointCache,\n      }\n    }\n\n    return resultConfig\n  }\n\n  /**\n   * Инвалидирует кэш по тегам (использует индекс для O(1) поиска по тегу)\n   * @param tags Теги для инвалидации\n   */\n  public async invalidateCacheByTags(tags: string[]): Promise<void> {\n    if (!this.storage) throw new Error('Хранилище не инициализировано')\n\n    // Собираем все ключи для удаления через индекс\n    const keysToRemove = new Set<string>()\n    for (const tag of tags) {\n      const keys = this.tagIndex.get(tag)\n      if (keys) {\n        keys.forEach((k) => keysToRemove.add(k))\n        this.tagIndex.delete(tag)\n      }\n    }\n\n    // Удаляем из остальных тегов индекса (ключ может быть в нескольких тегах)\n    for (const key of keysToRemove) {\n      for (const [tag, keys] of this.tagIndex) {\n        keys.delete(key)\n        if (keys.size === 0) this.tagIndex.delete(tag)\n      }\n    }\n\n    // Удаляем записи из хранилища\n    await Promise.all([...keysToRemove].map((key) => this.storage!.remove(key)))\n  }\n\n  /**\n   * Инвалидирует кэш по ключу\n   * @param cacheKey Ключ кэша\n   */\n  public async invalidateCache(cacheKey: StorageKeyType): Promise<void> {\n    if (!this.storage) throw new Error('Хранилище не инициализировано')\n\n    // Читаем теги записи для очистки индекса\n    const cachedEntry = await this.storage.get<CacheEntry<any>>(cacheKey)\n    if (cachedEntry) {\n      this.removeKeyFromTagIndex(String(cacheKey), cachedEntry.metadata.tags)\n    }\n\n    await this.storage.remove(cacheKey)\n  }\n\n  /**\n   * Выполняет очистку всех просроченных записей кэша\n   */\n  public async cleanup(): Promise<void> {\n    if (!this.storage) {\n      throw new Error('Хранилище не инициализировано')\n    }\n\n    const keys = await this.storage.keys()\n    for (const key of keys) {\n      const value = await this.storage.get<CacheEntry<any>>(key)\n      if (value && CacheUtils.isExpired(value.metadata)) {\n        this.removeKeyFromTagIndex(String(key), value.metadata.tags)\n        await this.storage.remove(key)\n      }\n    }\n  }\n\n  /**\n   * Уничтожает хранилище и освобождает ресурсы\n   */\n  public async destroy(): Promise<void> {\n    // Останавливаем интервал очистки\n    if (this.cleanupInterval) {\n      globalThis.clearInterval(this.cleanupInterval)\n      this.cleanupInterval = null\n    }\n\n    // Очищаем индекс тегов\n    this.tagIndex.clear()\n\n    // Очищаем хранилище\n    if (this.storage) {\n      await this.storage.destroy()\n      this.storage = null\n    }\n\n    // Сбрасываем состояние инициализации\n    this._initialized = false\n    this._initPromise = null\n  }\n\n  /**\n   * Перестраивает индекс тегов из существующих записей в storage\n   * Вызывается при инициализации для восстановления после перезагрузки\n   */\n  private async rebuildTagIndex(): Promise<void> {\n    if (!this.storage) return\n\n    this.tagIndex.clear()\n    const keys = await this.storage.keys()\n\n    for (const key of keys) {\n      const entry = await this.storage.get<CacheEntry<any>>(key)\n      if (!entry?.metadata?.tags) continue\n\n      // Удаляем протухшие записи сразу\n      if (CacheUtils.isExpired(entry.metadata)) {\n        await this.storage.remove(key)\n        continue\n      }\n\n      const keyStr = String(key)\n      for (const tag of entry.metadata.tags) {\n        let tagKeys = this.tagIndex.get(tag)\n        if (!tagKeys) {\n          tagKeys = new Set()\n          this.tagIndex.set(tag, tagKeys)\n        }\n        tagKeys.add(keyStr)\n      }\n    }\n  }\n\n  /**\n   * Удаляет ключ из индекса тегов\n   */\n  private removeKeyFromTagIndex(key: string, tags?: string[]): void {\n    if (!tags) return\n    for (const tag of tags) {\n      const keys = this.tagIndex.get(tag)\n      if (keys) {\n        keys.delete(key)\n        if (keys.size === 0) this.tagIndex.delete(tag)\n      }\n    }\n  }\n}\n"],"names":["handleCleanupError","handleOperationError","CacheUtils","QueryStorage","Map","storageExternal","globalCacheConfig","error","s","clearInterval","cleanupConfig","setInterval","err","endpoint","params","cacheKey","Error","cachedEntry","undefined","String","updatedEntry","data","cacheOptions","cacheParams","tags","cacheMetadata","cacheEntry","keyStr","tag","keys","Set","endpointConfig","options","method","resultConfig","endpointCache","keysToRemove","k","key","Promise","value","globalThis","entry","tagKeys"],"mappings":"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"}

package/dist/api/example.d.ts

@@ -0,0 +1,83 @@
+import { ApiClient } from './api.module';
+export interface PokemonListResponse {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: {
+        name: string;
+        url: string;
+    }[];
+}
+export interface PokemonDetails {
+    id: number;
+    name: string;
+    height: number;
+    weight: number;
+    sprites: {
+        front_default: string;
+        back_default: string;
+        other?: {
+            'official-artwork'?: {
+                front_default: string;
+            };
+        };
+    };
+    types: {
+        slot: number;
+        type: {
+            name: string;
+            url: string;
+        };
+    }[];
+    abilities: {
+        ability: {
+            name: string;
+            url: string;
+        };
+        is_hidden: boolean;
+        slot: number;
+    }[];
+    stats: {
+        base_stat: number;
+        effort: number;
+        stat: {
+            name: string;
+            url: string;
+        };
+    }[];
+}
+export interface PokemonSearchParams {
+    limit?: number;
+    offset?: number;
+}
+export declare const api: ApiClient<(create: import("./types/endpoint.interface").CreateEndpoint) => Promise<{
+    updatePokemonById: import("./types/endpoint.interface").EndpointConfig<{
+        id: number;
+    }, PokemonDetails>;
+    getPokemonById: import("./types/endpoint.interface").EndpointConfig<{
+        id: number;
+    }, PokemonDetails>;
+    getPokemonList: import("./types/endpoint.interface").EndpointConfig<PokemonSearchParams, PokemonListResponse>;
+}>>;
+export declare const pokemonApi: ApiClient<(create: import("./types/endpoint.interface").CreateEndpoint) => Promise<{
+    updatePokemonById: import("./types/endpoint.interface").EndpointConfig<{
+        id: number;
+    }, PokemonDetails>;
+    getPokemonById: import("./types/endpoint.interface").EndpointConfig<{
+        id: number;
+    }, PokemonDetails>;
+    getPokemonList: import("./types/endpoint.interface").EndpointConfig<PokemonSearchParams, PokemonListResponse>;
+}>>;
+export declare const pokemonEndpoints: {
+    updatePokemonById: import("./types/endpoint.interface").Endpoint<{
+        id: number;
+    }, PokemonDetails>;
+    getPokemonById: import("./types/endpoint.interface").Endpoint<{
+        id: number;
+    }, PokemonDetails>;
+    getPokemonList: import("./types/endpoint.interface").Endpoint<PokemonSearchParams, PokemonListResponse>;
+};
+export declare const getPokemonById: (params: {
+    id: number;
+}, options?: import("./types/query.interface").QueryOptions) => import("./types/endpoint.interface").RequestResponseModify<PokemonDetails, any>;
+//# sourceMappingURL=example.d.ts.map

package/dist/api/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/api/example.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAIxC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,GAAG,EAAE,MAAM,CAAA;KACZ,EAAE,CAAA;CACJ;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAA;QACrB,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,CAAC,EAAE;YACN,kBAAkB,CAAC,EAAE;gBACnB,aAAa,EAAE,MAAM,CAAA;aACtB,CAAA;SACF,CAAA;KACF,CAAA;IACD,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAA;YACZ,GAAG,EAAE,MAAM,CAAA;SACZ,CAAA;KACF,EAAE,CAAA;IACH,SAAS,EAAE;QACT,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAA;YACZ,GAAG,EAAE,MAAM,CAAA;SACZ,CAAA;QACD,SAAS,EAAE,OAAO,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;KACb,EAAE,CAAA;IACH,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM,CAAA;YACZ,GAAG,EAAE,MAAM,CAAA;SACZ,CAAA;KACF,EAAE,CAAA;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAkCD,eAAO,MAAM,GAAG;;YAmBoB,MAAM;;;YAQT,MAAM;;;GA2BrC,CAAA;AAEF,eAAO,MAAM,UAAU;;YArCa,MAAM;;;YAQT,MAAM;;;GA6BG,CAAA;AAC1C,eAAO,MAAM,gBAAgB;;YAtCO,MAAM;;;YAQT,MAAM;;;CA8BkB,CAAA;AACzD,eAAO,MAAM,cAAc;QA/BM,MAAM;+IA+B8B,CAAA"}

package/dist/api/example.js

@@ -0,0 +1,90 @@
+import { IndexedDBStorage, MemoryStorage } from "../core/index.js";
+import { ApiClient } from "./api.module.js";
+import { ResponseFormat } from "./types/api.interface.js";
+
+
+
+
+
+
+
+// Создаем базу данных в indexedDB
+const { pokemonStorageIdb: pokemonStorageIdb } = await IndexedDBStorage.createStorages('pokemon-api-cache', {
+    // Создаем хранилище в базе данных
+    pokemonStorageIdb: {
+        name: 'pokemon-api'
+    },
+    // И так далее
+    myStorage1: {
+        name: 'some-api-1'
+    }
+});
+// Для MemoryStorage и LocalStorage как обычно
+const pokemonStorageMemory = await new MemoryStorage({
+    name: 'pokemon-api'
+}).initialize();
+const api = new ApiClient({
+    cacheableHeaderKeys: [
+        'X-Global-Header'
+    ],
+    // Передаем готовое хранилище
+    storage: pokemonStorageIdb,
+    cache: true,
+    // Базовый запрос
+    baseQuery: {
+        baseUrl: 'https://pokeapi.co/api/v2',
+        timeout: 10000,
+        prepareHeaders: async (headers, context)=>{
+            // Устанавливаем заголовки для тестирования
+            headers.set('X-Global-Header', 'global-value');
+            headers.set('X-BaseQuery-Header', 'basequery-value');
+            return headers;
+        },
+        credentials: 'same-origin'
+    },
+    // Типизированные endpoints
+    endpoints: async (create)=>({
+            updatePokemonById: create({
+                request: ({ id })=>({
+                        path: `/pokemon/${id}`,
+                        method: 'PUT',
+                        body: {}
+                    })
+            }),
+            // Запрос деталей покемона по ID (с явно включенным кэшированием)
+            getPokemonById: create({
+                request: (params)=>({
+                        path: `/pokemon/${params.id}`,
+                        method: 'GET',
+                        responseFormat: ResponseFormat.Json
+                    }),
+                // Включаем кэширование с настройками по умолчанию
+                // cache: {},
+                tags: [
+                    'pokemon-details'
+                ]
+            }),
+            // Запрос списка покемонов (без кэширования)
+            getPokemonList: create({
+                request: (params = {
+                    limit: 20,
+                    offset: 0
+                })=>({
+                        path: '/pokemon',
+                        method: 'GET',
+                        query: params,
+                        responseFormat: ResponseFormat.Json
+                    })
+            })
+        })
+});
+console.log('Starting API initialization...');
+const pokemonApi = await api.init();
+const pokemonEndpoints = pokemonApi.getEndpoints();
+const getPokemonById = pokemonEndpoints.getPokemonById.request;
+// const t = pokemonEndpoints.getPokemonById.request({ id: 1 }, { disableCache: true })
+console.log('Endpoints received');
+
+export { api, getPokemonById, pokemonApi, pokemonEndpoints };
+
+//# sourceMappingURL=example.js.map

package/dist/api/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api/example.js","sources":["../../src/api/example.ts"],"sourcesContent":["import { IndexedDBStorage, LocalStorage, MemoryStorage } from '../core'\nimport { ApiClient } from './api.module'\nimport { ResponseFormat } from './types/api.interface'\n\n// Типы данных для PokeAPI\nexport interface PokemonListResponse {\n  count: number\n  next: string | null\n  previous: string | null\n  results: {\n    name: string\n    url: string\n  }[]\n}\n\nexport interface PokemonDetails {\n  id: number\n  name: string\n  height: number\n  weight: number\n  sprites: {\n    front_default: string\n    back_default: string\n    other?: {\n      'official-artwork'?: {\n        front_default: string\n      }\n    }\n  }\n  types: {\n    slot: number\n    type: {\n      name: string\n      url: string\n    }\n  }[]\n  abilities: {\n    ability: {\n      name: string\n      url: string\n    }\n    is_hidden: boolean\n    slot: number\n  }[]\n  stats: {\n    base_stat: number\n    effort: number\n    stat: {\n      name: string\n      url: string\n    }\n  }[]\n}\n\nexport interface PokemonSearchParams {\n  limit?: number\n  offset?: number\n}\n\n// Создаем базу данных в indexedDB\nconst { pokemonStorageIdb } = await IndexedDBStorage.createStorages<{\n  pokemonStorageIdb: Record<string, any>\n  myStorage1: Record<string, any>\n}>('pokemon-api-cache', {\n  // Создаем хранилище в базе данных\n  pokemonStorageIdb: {\n    name: 'pokemon-api',\n  },\n  // И так далее\n  myStorage1: {\n    name: 'some-api-1',\n    // Тоже самое что при\n    // initialState: ,\n    // middlewares: ,\n    // pluginExecutor: ,\n    // eventEmitter: ,\n  },\n})\n\n// Для MemoryStorage и LocalStorage как обычно\nconst pokemonStorageMemory = await new MemoryStorage(\n  {\n    name: 'pokemon-api',\n    // middlewares: ,\n    // initialState: {},\n  },\n  // pluginExecutor: ,  // IPluginExecutor\n  // eventEmitter: , // IEventEmitter\n  // logger: , // ILogger\n).initialize()\n\nexport const api = new ApiClient({\n  cacheableHeaderKeys: ['X-Global-Header'],\n  // Передаем готовое хранилище\n  storage: pokemonStorageIdb, // или pokemonStorageMemory\n  cache: true,\n  // Базовый запрос\n  baseQuery: {\n    baseUrl: 'https://pokeapi.co/api/v2',\n    timeout: 10000,\n    prepareHeaders: async (headers, context) => {\n      // Устанавливаем заголовки для тестирования\n      headers.set('X-Global-Header', 'global-value')\n      headers.set('X-BaseQuery-Header', 'basequery-value')\n      return headers\n    },\n    credentials: 'same-origin',\n  },\n  // Типизированные endpoints\n  endpoints: async (create) => ({\n    updatePokemonById: create<{ id: number }, PokemonDetails>({\n      request: ({ id }) => ({\n        path: `/pokemon/${id}`,\n        method: 'PUT',\n        body: {},\n      }),\n    }),\n    // Запрос деталей покемона по ID (с явно включенным кэшированием)\n    getPokemonById: create<{ id: number }, PokemonDetails>({\n      request: (params) => ({\n        path: `/pokemon/${params.id}`,\n        method: 'GET',\n        responseFormat: ResponseFormat.Json,\n      }),\n      // Включаем кэширование с настройками по умолчанию\n      // cache: {},\n      tags: ['pokemon-details'],\n    }),\n    // Запрос списка покемонов (без кэширования)\n    getPokemonList: create<PokemonSearchParams, PokemonListResponse>({\n      request: (\n        params = {\n          limit: 20,\n          offset: 0,\n        },\n      ) => ({\n        path: '/pokemon',\n        method: 'GET',\n        query: params,\n        responseFormat: ResponseFormat.Json,\n      }),\n      // Явное отключение кэша для этого эндпоинта\n      // cache: false,\n    }),\n  }),\n})\nconsole.log('Starting API initialization...')\nexport const pokemonApi = await api.init()\nexport const pokemonEndpoints = pokemonApi.getEndpoints()\nexport const getPokemonById = pokemonEndpoints.getPokemonById.request\n\n// const t = pokemonEndpoints.getPokemonById.request({ id: 1 }, { disableCache: true })\nconsole.log('Endpoints received')\n"],"names":["IndexedDBStorage","MemoryStorage","ApiClient","ResponseFormat","pokemonStorageIdb","pokemonStorageMemory","api","headers","context","create","id","params","console","pokemonApi","pokemonEndpoints","getPokemonById"],"mappings":";;;;;;;AAAuE;AAC/B;AACc;AAyDtD,kCAAkC;AAClC,MAAM,EAAEI,oCAAiB,EAAE,GAAG,MAAMJ,+BAA+B,CAGhE,qBAAqB;IACtB,kCAAkC;IAClC,mBAAmB;QACjB,MAAM;IACR;IACA,cAAc;IACd,YAAY;QACV,MAAM;IAMR;AACF;AAEA,8CAA8C;AAC9C,MAAMK,oBAAoBA,GAAG,MAAM,IAAIJ,aAAaA,CAClD;IACE,MAAM;AAGR,GAIA,UAAU;AAEL,MAAMK,GAAGA,GAAG,IAAIJ,SAASA,CAAC;IAC/B,qBAAqB;QAAC;KAAkB;IACxC,6BAA6B;IAC7B,SAASE,iBAAiBA;IAC1B,OAAO;IACP,iBAAiB;IACjB,WAAW;QACT,SAAS;QACT,SAAS;QACT,gBAAgB,OAAOG,SAASC;YAC9B,2CAA2C;YAC3CD,QAAQ,GAAG,CAAC,mBAAmB;YAC/BA,QAAQ,GAAG,CAAC,sBAAsB;YAClC,OAAOA;QACT;QACA,aAAa;IACf;IACA,2BAA2B;IAC3B,WAAW,OAAOE,SAAY;YAC5B,mBAAmBA,OAAuC;gBACxD,SAAS,CAAC,EAAEC,EAAE,EAAE,GAAM;wBACpB,MAAM,CAAC,SAAS,EAAEA,IAAI;wBACtB,QAAQ;wBACR,MAAM,CAAC;oBACT;YACF;YACA,iEAAiE;YACjE,gBAAgBD,OAAuC;gBACrD,SAAS,CAACE,SAAY;wBACpB,MAAM,CAAC,SAAS,EAAEA,OAAO,EAAE,EAAE;wBAC7B,QAAQ;wBACR,gBAAgBR,mBAAmB;oBACrC;gBACA,kDAAkD;gBAClD,aAAa;gBACb,MAAM;oBAAC;iBAAkB;YAC3B;YACA,4CAA4C;YAC5C,gBAAgBM,OAAiD;gBAC/D,SAAS,CACPE,SAAS;oBACP,OAAO;oBACP,QAAQ;gBACV,CAAC,GACG;wBACJ,MAAM;wBACN,QAAQ;wBACR,OAAOA;wBACP,gBAAgBR,mBAAmB;oBACrC;YAGF;QACF;AACF,GAAE;AACFS,QAAQ,GAAG,CAAC;AACL,MAAMC,UAAUA,GAAG,MAAMP,GAAGA,CAAC,IAAI,GAAE;AACnC,MAAMQ,gBAAgBA,GAAGD,UAAUA,CAAC,YAAY,GAAE;AAClD,MAAME,cAAcA,GAAGD,gBAAgBA,CAAC,cAAc,CAAC,OAAO;AAErE,uFAAuF;AACvFF,QAAQ,GAAG,CAAC"}

package/dist/api/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api.module';
+export { ResponseFormat, type RetryConfig } from './types/api.interface';
+export * from './utils/api-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxE,cAAc,qBAAqB,CAAA"}