@astral/mobx-query 1.8.1 → 1.10.0

package/Sets/InfiniteQuerySet/InfiniteQuerySet.d.ts

@@ -0,0 +1,60 @@
+import { type DeepPartial } from 'utility-types';
+import { type CacheKey } from '../../types';
+import { type InfiniteParams, type InfiniteQuery } from '../../InfiniteQuery';
+import { type CreateInfiniteQueryParams, type MobxQuery } from '../../MobxQuery';
+export type InfiniteQuerySetConfig = {
+    name?: string;
+};
+export type InfiniteQuerySetConfigurator<TParams extends any[], TResponse> = (...params: TParams) => {
+    keys?: CacheKey[];
+    execute: (infiniteParams: InfiniteParams) => Promise<TResponse[]>;
+};
+/**
+ * Набор infinite queries под одним ключем с целью повышения читаемости кода и удобства инвалидации по общему ключу
+ */
+export declare class InfiniteQuerySet<TParams extends any[], TResponse, TDefaultError = unknown> {
+    private readonly _cache;
+    private readonly _queryConfigurator;
+    private readonly baseKey;
+    constructor(_cache: MobxQuery, _queryConfigurator: InfiniteQuerySetConfigurator<TParams, TResponse>, config?: InfiniteQuerySetConfig);
+    /**
+     * Создает infinite query в кэше. Добавляет его в набор
+     * @returns InfiniteQuery объект
+     * @example
+     * const docListQuery = docFetcher.infiniteQueries.docList.create()
+     * // Получает данные
+     * docListQuery.sync()
+     */
+    create: <TError = TDefaultError>(...params: TParams) => InfiniteQuery<TResponse, TError>;
+    /**
+     * Создает infinite query в кэше с дополнительными параметрами конфигурации. Добавляет его в набор
+     * @param config - Параметры конфигурации infinite query. Например, fetchPolicy или incrementCount
+     * @param params - Параметры запроса
+     * @returns InfiniteQuery объект
+     * @example
+     * const docListQuery = docFetcher.infiniteQueries.docList.createWithConfig(
+     *   { fetchPolicy: 'network-only', incrementCount: 10 },
+     *   'docId',
+     * )
+     * // Получает данные из query
+     * docListQuery.sync()
+     */
+    createWithConfig: <TError = TDefaultError, TIsBackground extends boolean = false>(config: CreateInfiniteQueryParams<TResponse, TError, TIsBackground>, ...params: TParams) => InfiniteQuery<TResponse, TError, TIsBackground>;
+    /**
+     * Инвалидирует текущий набор infinite queries в кэше
+     * @param params - Параметры функции, переданной в createInfiniteQuerySet при создании набора. Если не указаны, то инвалидируется все query
+     * @example
+     * const docFetcher = {
+     *   infiniteQueries: {
+     *     docList: createInfiniteQuerySet('docList', (search: string) => ({
+     *       execute: ({ count, offset }) => httpService.get(`/doc/${search}?count=${count}&offset=${offset}`),
+     *     }),
+     *   }
+     * };
+     *
+     * // Инвалидирует infinite query с конкретным переданным search
+     * docFetcher.infiniteQueries.docList.invalidate('документ1')
+     */
+    invalidate: (...params: DeepPartial<TParams>) => void;
+    private configureQuery;
+}

package/Sets/InfiniteQuerySet/InfiniteQuerySet.js

@@ -0,0 +1,71 @@
+import { generateQuerySetBaseKey, generateQuerySetKeys } from '../utils';
+/**
+ * Набор infinite queries под одним ключем с целью повышения читаемости кода и удобства инвалидации по общему ключу
+ */
+export class InfiniteQuerySet {
+    constructor(_cache, _queryConfigurator, config) {
+        var _a;
+        this._cache = _cache;
+        this._queryConfigurator = _queryConfigurator;
+        /**
+         * Создает infinite query в кэше. Добавляет его в набор
+         * @returns InfiniteQuery объект
+         * @example
+         * const docListQuery = docFetcher.infiniteQueries.docList.create()
+         * // Получает данные
+         * docListQuery.sync()
+         */
+        this.create = (...params) => {
+            const { keys, execute } = this.configureQuery(...params);
+            return this._cache.createInfiniteQuery(keys, execute);
+        };
+        /**
+         * Создает infinite query в кэше с дополнительными параметрами конфигурации. Добавляет его в набор
+         * @param config - Параметры конфигурации infinite query. Например, fetchPolicy или incrementCount
+         * @param params - Параметры запроса
+         * @returns InfiniteQuery объект
+         * @example
+         * const docListQuery = docFetcher.infiniteQueries.docList.createWithConfig(
+         *   { fetchPolicy: 'network-only', incrementCount: 10 },
+         *   'docId',
+         * )
+         * // Получает данные из query
+         * docListQuery.sync()
+         */
+        this.createWithConfig = (config, ...params) => {
+            const { keys, execute } = this.configureQuery(...params);
+            return this._cache.createInfiniteQuery(keys, execute, config);
+        };
+        /**
+         * Инвалидирует текущий набор infinite queries в кэше
+         * @param params - Параметры функции, переданной в createInfiniteQuerySet при создании набора. Если не указаны, то инвалидируется все query
+         * @example
+         * const docFetcher = {
+         *   infiniteQueries: {
+         *     docList: createInfiniteQuerySet('docList', (search: string) => ({
+         *       execute: ({ count, offset }) => httpService.get(`/doc/${search}?count=${count}&offset=${offset}`),
+         *     }),
+         *   }
+         * };
+         *
+         * // Инвалидирует infinite query с конкретным переданным search
+         * docFetcher.infiniteQueries.docList.invalidate('документ1')
+         */
+        this.invalidate = (...params) => {
+            if (params.length === 0) {
+                this._cache.invalidate([this.baseKey]);
+                return;
+            }
+            const { keys } = this.configureQuery(...params);
+            this._cache.invalidate(keys, 'chain-match');
+        };
+        this.configureQuery = (...params) => {
+            const { keys, execute } = this._queryConfigurator(...params);
+            return {
+                keys: generateQuerySetKeys(this.baseKey, keys !== null && keys !== void 0 ? keys : params),
+                execute,
+            };
+        };
+        this.baseKey = (_a = config === null || config === void 0 ? void 0 : config.name) !== null && _a !== void 0 ? _a : generateQuerySetBaseKey(_queryConfigurator);
+    }
+}

package/Sets/InfiniteQuerySet/index.d.ts

@@ -0,0 +1 @@
+export * from './InfiniteQuerySet';

package/Sets/InfiniteQuerySet/index.js

@@ -0,0 +1 @@
+export * from './InfiniteQuerySet';

package/Sets/MutationSet/MutationSet.d.ts

@@ -0,0 +1,32 @@
+import { type MobxQuery } from '../../MobxQuery';
+import { type Mutation, type MutationExecutor } from '../../Mutation';
+/**
+ * Налор мутаций. Цель: единый интерфейс создания и использования наборов Query и Mutation
+ * @example
+ * const docFetcher = {
+ *   mutations: {
+ *     editDoc: mobxQuery.createMutationSet((params: DocsEndpointsDTO.EditDocInput) => {
+ *       return docsEndpoint.editDoc(params);
+ *     }),
+ *   },
+ *  queries: {
+ *     doc: mobxQuery.createQuerySet((id: string) => ({
+ *       execute: () => docsEndpoint.getDoc(id).then(({ data }) => data),
+ *     })),
+ *   },
+ * }
+ */
+export declare class MutationSet<TResponse, TParams = void, TDefaultError = unknown> {
+    private readonly _cache;
+    private readonly _executor;
+    constructor(_cache: MobxQuery, _executor: MutationExecutor<TResponse, TParams>);
+    /**
+     * Создает мутацию
+     * @returns Mutation объект
+     * @example
+     * const editDocMutation = docFetcher.mutations.editDoc.create();
+     * // Выполняет мутацию
+     * editDocMutation.sync({ params: { id: 'docId', content: 'Новое содержимое' } });
+     */
+    create: <TError = TDefaultError>() => Mutation<TResponse, TError, TParams>;
+}

package/Sets/MutationSet/MutationSet.js

@@ -0,0 +1,31 @@
+/**
+ * Налор мутаций. Цель: единый интерфейс создания и использования наборов Query и Mutation
+ * @example
+ * const docFetcher = {
+ *   mutations: {
+ *     editDoc: mobxQuery.createMutationSet((params: DocsEndpointsDTO.EditDocInput) => {
+ *       return docsEndpoint.editDoc(params);
+ *     }),
+ *   },
+ *  queries: {
+ *     doc: mobxQuery.createQuerySet((id: string) => ({
+ *       execute: () => docsEndpoint.getDoc(id).then(({ data }) => data),
+ *     })),
+ *   },
+ * }
+ */
+export class MutationSet {
+    constructor(_cache, _executor) {
+        this._cache = _cache;
+        this._executor = _executor;
+        /**
+         * Создает мутацию
+         * @returns Mutation объект
+         * @example
+         * const editDocMutation = docFetcher.mutations.editDoc.create();
+         * // Выполняет мутацию
+         * editDocMutation.sync({ params: { id: 'docId', content: 'Новое содержимое' } });
+         */
+        this.create = () => this._cache.createMutation(this._executor);
+    }
+}

package/Sets/MutationSet/index.d.ts

@@ -0,0 +1 @@
+export * from './MutationSet';

package/Sets/MutationSet/index.js

@@ -0,0 +1 @@
+export * from './MutationSet';

package/Sets/QuerySet/QuerySet.d.ts

@@ -0,0 +1,64 @@
+import { type DeepPartial } from 'utility-types';
+import { type CacheKey } from '../../types';
+import { type Query } from '../../Query';
+import { type CreateQueryParams, type MobxQuery } from '../../MobxQuery';
+export type QuerySetConfig = {
+    name?: string;
+};
+export type QuerySetConfigurator<TParams extends any[], TResponse> = (...params: TParams) => {
+    keys?: CacheKey[];
+    execute: () => Promise<TResponse>;
+};
+/**
+ * Набор queries под одним ключем с целью повышения читаемости кода и удобства инвалидации по общему ключу
+ */
+export declare class QuerySet<TParams extends any[], TResponse, TDefaultError = unknown> {
+    private readonly _cache;
+    private readonly _queryConfigurator;
+    /**
+     * Хэш от queryConfigurator
+     */
+    private readonly baseKey;
+    constructor(_cache: MobxQuery, _queryConfigurator: QuerySetConfigurator<TParams, TResponse>, config?: QuerySetConfig);
+    /**
+     * Создает query в кэше. Добавляет его в набор
+     * @returns Query объект
+     * @example
+     * const docQuery = docFetcher.queries.doc.create('docId')
+     * // Получает данные
+     * docQuery.sync()
+     */
+    create: <TError = TDefaultError>(...params: TParams) => Query<TResponse, TError>;
+    /**
+     * Создает query в кэше с дополнительными параметрами конфигурации. Добавляет его в набор
+     * @param config - Параметры конфигурации query. Например, fetchPolicy
+     * @param params - Параметры запроса
+     * @returns Query объект
+     * @example
+     * const docQuery = docFetcher.queries.doc.createWithConfig(
+     *   { fetchPolicy: 'network-only' },
+     *   'docId',
+     * )
+     * // Получает данные из query
+     * docQuery.sync()
+     */
+    createWithConfig: <TError = TDefaultError, TIsBackground extends boolean = false>(config: CreateQueryParams<Awaited<TResponse>, TError, TIsBackground>, ...params: TParams) => Query<TResponse, TError, TIsBackground>;
+    /**
+     * Инвалидирует текущий query в кэше
+     * @param keys - Дополнительные ключи для инвалидации. Если не указаны, то инвалидируется весь набор query
+     * @example
+     * const docFetcher = {
+     *   doc: mobxQuery.createQuerySet((id: string) => ({
+     *     execute: () => httpService.get(`/doc/${id}?page=${page}`),
+     *   })),
+     * };
+     *
+     * // Инвалидирует все query doc
+     * docFetcher.doc.invalidate()
+     *
+     * // Инвалидирует query doc с конкретным переданным id. Доступные ключи инвалидации зависят от указанных additionalKeys, переданных при определении query в фабрике createDataFetcher
+     * docFetcher.doc.invalidate('docId')
+     */
+    invalidate: (...params: DeepPartial<TParams>) => void;
+    private configureQuery;
+}

package/Sets/QuerySet/QuerySet.js

@@ -0,0 +1,72 @@
+import { generateQuerySetBaseKey, generateQuerySetKeys } from '../utils';
+/**
+ * Набор queries под одним ключем с целью повышения читаемости кода и удобства инвалидации по общему ключу
+ */
+export class QuerySet {
+    constructor(_cache, _queryConfigurator, config) {
+        var _a;
+        this._cache = _cache;
+        this._queryConfigurator = _queryConfigurator;
+        /**
+         * Создает query в кэше. Добавляет его в набор
+         * @returns Query объект
+         * @example
+         * const docQuery = docFetcher.queries.doc.create('docId')
+         * // Получает данные
+         * docQuery.sync()
+         */
+        this.create = (...params) => {
+            const { keys, execute } = this.configureQuery(...params);
+            return this._cache.createQuery(keys, execute);
+        };
+        /**
+         * Создает query в кэше с дополнительными параметрами конфигурации. Добавляет его в набор
+         * @param config - Параметры конфигурации query. Например, fetchPolicy
+         * @param params - Параметры запроса
+         * @returns Query объект
+         * @example
+         * const docQuery = docFetcher.queries.doc.createWithConfig(
+         *   { fetchPolicy: 'network-only' },
+         *   'docId',
+         * )
+         * // Получает данные из query
+         * docQuery.sync()
+         */
+        this.createWithConfig = (config, ...params) => {
+            const { keys, execute } = this.configureQuery(...params);
+            return this._cache.createQuery(keys, execute, config);
+        };
+        /**
+         * Инвалидирует текущий query в кэше
+         * @param keys - Дополнительные ключи для инвалидации. Если не указаны, то инвалидируется весь набор query
+         * @example
+         * const docFetcher = {
+         *   doc: mobxQuery.createQuerySet((id: string) => ({
+         *     execute: () => httpService.get(`/doc/${id}?page=${page}`),
+         *   })),
+         * };
+         *
+         * // Инвалидирует все query doc
+         * docFetcher.doc.invalidate()
+         *
+         * // Инвалидирует query doc с конкретным переданным id. Доступные ключи инвалидации зависят от указанных additionalKeys, переданных при определении query в фабрике createDataFetcher
+         * docFetcher.doc.invalidate('docId')
+         */
+        this.invalidate = (...params) => {
+            if (params.length === 0) {
+                this._cache.invalidate([this.baseKey]);
+                return;
+            }
+            const { keys } = this.configureQuery(...params);
+            this._cache.invalidate(keys, 'chain-match');
+        };
+        this.configureQuery = (...params) => {
+            const { keys, execute } = this._queryConfigurator(...params);
+            return {
+                keys: generateQuerySetKeys(this.baseKey, keys !== null && keys !== void 0 ? keys : params),
+                execute,
+            };
+        };
+        this.baseKey = (_a = config === null || config === void 0 ? void 0 : config.name) !== null && _a !== void 0 ? _a : generateQuerySetBaseKey(_queryConfigurator);
+    }
+}

package/Sets/QuerySet/index.d.ts

@@ -0,0 +1 @@
+export * from './QuerySet';

package/Sets/QuerySet/index.js

@@ -0,0 +1 @@
+export * from './QuerySet';

package/Sets/index.d.ts

@@ -0,0 +1,3 @@
+export * from './MutationSet';
+export * from './QuerySet';
+export * from './InfiniteQuerySet';

package/Sets/index.js

@@ -0,0 +1,3 @@
+export * from './MutationSet';
+export * from './QuerySet';
+export * from './InfiniteQuerySet';

package/Sets/utils/generateQuerySetBaseKey/generateQuerySetBaseKey.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Создает базовый ключ на основе хэша от configurator
+ */
+export declare const generateQuerySetBaseKey: (configurator: Function) => string;

package/Sets/utils/generateQuerySetBaseKey/generateQuerySetBaseKey.js

@@ -0,0 +1,5 @@
+import hash from '@emotion/hash';
+/**
+ * Создает базовый ключ на основе хэша от configurator
+ */
+export const generateQuerySetBaseKey = (configurator) => hash(configurator.toString());

package/Sets/utils/generateQuerySetBaseKey/index.d.ts

@@ -0,0 +1 @@
+export * from './generateQuerySetBaseKey';

package/Sets/utils/generateQuerySetBaseKey/index.js

@@ -0,0 +1 @@
+export * from './generateQuerySetBaseKey';

package/Sets/utils/generateQuerySetKeys/generateQuerySetKeys.d.ts

@@ -0,0 +1,9 @@
+import { type CacheKey } from '../../../types';
+/**
+ * Создает ключи на основе каждого параметра
+ * @param additionalKeys - Создает для каждого параметра отдельный ключ, чтобы по нему можно было инвалидировать query
+ * @example
+ * // Создаст ключи ['22f4', ['22f4', 'organizationID', '1'], ['22f4', 'employeeID', '2']]
+ * generateQuerySetKeys('22f4', params)
+ */
+export declare const generateQuerySetKeys: (baseKey: string, params: CacheKey[]) => CacheKey[];

package/Sets/utils/generateQuerySetKeys/generateQuerySetKeys.js

@@ -0,0 +1,20 @@
+import { isPlainObject } from '@astral/utils';
+/**
+ * Создает ключи на основе каждого параметра
+ * @param additionalKeys - Создает для каждого параметра отдельный ключ, чтобы по нему можно было инвалидировать query
+ * @example
+ * // Создаст ключи ['22f4', ['22f4', 'organizationID', '1'], ['22f4', 'employeeID', '2']]
+ * generateQuerySetKeys('22f4', params)
+ */
+export const generateQuerySetKeys = (baseKey, params) => {
+    const resultKeys = [];
+    params.forEach((param) => {
+        if (isPlainObject(param)) {
+            resultKeys.push(...Object.entries(param).map(([key, value]) => [baseKey, key, value]));
+        }
+        else {
+            resultKeys.push(param);
+        }
+    });
+    return [baseKey, ...resultKeys];
+};

package/Sets/utils/generateQuerySetKeys/index.d.ts

@@ -0,0 +1 @@
+export * from './generateQuerySetKeys';

package/Sets/utils/generateQuerySetKeys/index.js

@@ -0,0 +1 @@
+export * from './generateQuerySetKeys';

package/Sets/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './generateQuerySetKeys';
+export * from './generateQuerySetBaseKey';

package/Sets/utils/index.js

@@ -0,0 +1,2 @@
+export * from './generateQuerySetKeys';
+export * from './generateQuerySetBaseKey';

package/index.d.ts

@@ -1,5 +1,6 @@
 export { Mutation } from './Mutation';
 export { Query } from './Query';
-export { type InfiniteParams } from './InfiniteQuery';
+export { type InfiniteParams, InfiniteQuery } from './InfiniteQuery';
 export { MobxQuery, type CreateQueryParams, type CreateInfiniteQueryParams, type CreateMutationParams, } from './MobxQuery';
+export { type QuerySet, type InfiniteQuerySet, type MutationSet } from './Sets';
 export { type CacheKey, type FetchPolicy } from './types';

package/index.js

@@ -1,3 +1,4 @@
 export { Mutation } from './Mutation';
 export { Query } from './Query';
+export { InfiniteQuery } from './InfiniteQuery';
 export { MobxQuery, } from './MobxQuery';

package/node/MobxQuery/MobxQuery.d.ts

@@ -2,6 +2,7 @@ import { Query, type QueryExecutor, type QueryParams } from '../Query';
 import { type InfiniteExecutor, InfiniteQuery, type InfiniteQueryParams } from '../InfiniteQuery';
 import { Mutation, type MutationExecutor, type MutationParams } from '../Mutation';
 import type { CacheKey, FetchPolicy } from '../types';
+import { InfiniteQuerySet, type InfiniteQuerySetConfig, type InfiniteQuerySetConfigurator, MutationSet, QuerySet, type QuerySetConfig, type QuerySetConfigurator } from '../Sets';
 /**
  * Стандартный обработчик ошибки запроса,
  * будет вызван, если при вызове sync не был передан отдельный onError параметр
@@ -128,5 +129,48 @@ export declare class MobxQuery<TDefaultError = void> {
      * Метод создания мутации, не кешируется
      */
     createMutation: <TResult, TError = TDefaultError, TExecutorParams = void>(executor: MutationExecutor<TResult, TExecutorParams>, params?: CreateMutationParams<TResult, TError>) => Mutation<TResult, TError, TExecutorParams>;
+    /**
+     * Создает набор queries под одним ключем
+     * @param configurator - Функция конфигурации набора запросов. Она должна возвращать объект с полями:
+     *   - keys (необязательно): массив ключей для кеширования;
+     *   - execute: функция, которая возвращает промис с результатом выполнения запроса.
+     * @example
+     * const docQuerySet = mobxQuery.createQuerySet((id: string, count?: number) => ({
+     *   execute: () => docEndpoint.getDoc(id),
+     * }));
+     *
+     * const docQuery = docQuerySet.create();
+     *
+     * docQuery.data // { data: [id, count] }
+     */
+    createQuerySet: <TParams extends any[], TResponse>(configurator: QuerySetConfigurator<TParams, TResponse>, config?: QuerySetConfig) => QuerySet<TParams, TResponse, TDefaultError>;
+    /**
+     * Создает набор infinite queries под одним ключем
+     * @param configurator - Функция конфигурации набора запросов. Она должна возвращать объект с полями:
+     *   - keys (необязательно): массив ключей для кеширования;
+     *   - execute: функция, которая возвращает промис с результатом выполнения запроса.
+     * @example
+     * const docListInfiniteQuerySet = mobxQuery.createInfiniteQuerySet((id: string, count?: number) => ({
+     *   execute: ({ offset, count }) => docEndpoint.getDocList(id, offset, count),
+     * }));
+     *
+     * const docListInfiniteQuery = docListInfiniteQuerySet.create();
+     *
+     * docListInfiniteQuery.data
+     */
+    createInfiniteQuerySet: <TParams extends any[], TResponse>(configurator: InfiniteQuerySetConfigurator<TParams, TResponse>, config?: InfiniteQuerySetConfig) => InfiniteQuerySet<TParams, TResponse, TDefaultError>;
+    /**
+     * Создает набор мутаций для единого интерфейса с query sets
+     * @param executor - Функция-исполнитель мутации. Она должна возвращать промис с результатом выполнения мутации.
+     * @example
+     * const editDocMutationSet = mobxQuery.createMutationSet((params: DocsEndpointsDTO.EditDocInput) => {
+     *   return docsEndpoint.editDoc(params);
+     * });
+     *
+     * const editDocMutation = editDocMutationSet.create();
+     *
+     * editDocMutation.sync({ params: { id: 'docId', content: 'Новое содержимое' } });
+     */
+    createMutationSet: <TResponse, TExecutorParams = void>(executor: MutationExecutor<TResponse, TExecutorParams>) => MutationSet<TResponse, TExecutorParams, TDefaultError>;
 }
 export {};

package/node/MobxQuery/MobxQuery.js

@@ -7,6 +7,7 @@ const Mutation_1 = require("../Mutation");
 const DataStorage_1 = require("../DataStorage");
 const StatusStorage_1 = require("../StatusStorage");
 const AdaptableMap_1 = require("../AdaptableMap");
+const Sets_1 = require("../Sets");
 /**
  * Сервис, позволяющий кэшировать данные.
  */
@@ -169,6 +170,53 @@ class MobxQuery {
          * Метод создания мутации, не кешируется
          */
         this.createMutation = (executor, params) => new Mutation_1.Mutation(executor, Object.assign(Object.assign({}, params), { onError: (params === null || params === void 0 ? void 0 : params.onError) || this.defaultErrorHandler }));
+        /**
+         * Создает набор queries под одним ключем
+         * @param configurator - Функция конфигурации набора запросов. Она должна возвращать объект с полями:
+         *   - keys (необязательно): массив ключей для кеширования;
+         *   - execute: функция, которая возвращает промис с результатом выполнения запроса.
+         * @example
+         * const docQuerySet = mobxQuery.createQuerySet((id: string, count?: number) => ({
+         *   execute: () => docEndpoint.getDoc(id),
+         * }));
+         *
+         * const docQuery = docQuerySet.create();
+         *
+         * docQuery.data // { data: [id, count] }
+         */
+        // any нужен для вывода типов
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.createQuerySet = (configurator, config) => new Sets_1.QuerySet(this, configurator, config);
+        /**
+         * Создает набор infinite queries под одним ключем
+         * @param configurator - Функция конфигурации набора запросов. Она должна возвращать объект с полями:
+         *   - keys (необязательно): массив ключей для кеширования;
+         *   - execute: функция, которая возвращает промис с результатом выполнения запроса.
+         * @example
+         * const docListInfiniteQuerySet = mobxQuery.createInfiniteQuerySet((id: string, count?: number) => ({
+         *   execute: ({ offset, count }) => docEndpoint.getDocList(id, offset, count),
+         * }));
+         *
+         * const docListInfiniteQuery = docListInfiniteQuerySet.create();
+         *
+         * docListInfiniteQuery.data
+         */
+        // any нужен для вывода типов
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.createInfiniteQuerySet = (configurator, config) => new Sets_1.InfiniteQuerySet(this, configurator, config);
+        /**
+         * Создает набор мутаций для единого интерфейса с query sets
+         * @param executor - Функция-исполнитель мутации. Она должна возвращать промис с результатом выполнения мутации.
+         * @example
+         * const editDocMutationSet = mobxQuery.createMutationSet((params: DocsEndpointsDTO.EditDocInput) => {
+         *   return docsEndpoint.editDoc(params);
+         * });
+         *
+         * const editDocMutation = editDocMutationSet.create();
+         *
+         * editDocMutation.sync({ params: { id: 'docId', content: 'Новое содержимое' } });
+         */
+        this.createMutationSet = (executor) => new Sets_1.MutationSet(this, executor);
         this.defaultErrorHandler = onError;
         this.defaultFetchPolicy = fetchPolicy;
         this.defaultEnabledAutoFetch = enabledAutoFetch;

package/node/Sets/InfiniteQuerySet/InfiniteQuerySet.d.ts

@@ -0,0 +1,60 @@
+import { type DeepPartial } from 'utility-types';
+import { type CacheKey } from '../../types';
+import { type InfiniteParams, type InfiniteQuery } from '../../InfiniteQuery';
+import { type CreateInfiniteQueryParams, type MobxQuery } from '../../MobxQuery';
+export type InfiniteQuerySetConfig = {
+    name?: string;
+};
+export type InfiniteQuerySetConfigurator<TParams extends any[], TResponse> = (...params: TParams) => {
+    keys?: CacheKey[];
+    execute: (infiniteParams: InfiniteParams) => Promise<TResponse[]>;
+};
+/**
+ * Набор infinite queries под одним ключем с целью повышения читаемости кода и удобства инвалидации по общему ключу
+ */
+export declare class InfiniteQuerySet<TParams extends any[], TResponse, TDefaultError = unknown> {
+    private readonly _cache;
+    private readonly _queryConfigurator;
+    private readonly baseKey;
+    constructor(_cache: MobxQuery, _queryConfigurator: InfiniteQuerySetConfigurator<TParams, TResponse>, config?: InfiniteQuerySetConfig);
+    /**
+     * Создает infinite query в кэше. Добавляет его в набор
+     * @returns InfiniteQuery объект
+     * @example
+     * const docListQuery = docFetcher.infiniteQueries.docList.create()
+     * // Получает данные
+     * docListQuery.sync()
+     */
+    create: <TError = TDefaultError>(...params: TParams) => InfiniteQuery<TResponse, TError>;
+    /**
+     * Создает infinite query в кэше с дополнительными параметрами конфигурации. Добавляет его в набор
+     * @param config - Параметры конфигурации infinite query. Например, fetchPolicy или incrementCount
+     * @param params - Параметры запроса
+     * @returns InfiniteQuery объект
+     * @example
+     * const docListQuery = docFetcher.infiniteQueries.docList.createWithConfig(
+     *   { fetchPolicy: 'network-only', incrementCount: 10 },
+     *   'docId',
+     * )
+     * // Получает данные из query
+     * docListQuery.sync()
+     */
+    createWithConfig: <TError = TDefaultError, TIsBackground extends boolean = false>(config: CreateInfiniteQueryParams<TResponse, TError, TIsBackground>, ...params: TParams) => InfiniteQuery<TResponse, TError, TIsBackground>;
+    /**
+     * Инвалидирует текущий набор infinite queries в кэше
+     * @param params - Параметры функции, переданной в createInfiniteQuerySet при создании набора. Если не указаны, то инвалидируется все query
+     * @example
+     * const docFetcher = {
+     *   infiniteQueries: {
+     *     docList: createInfiniteQuerySet('docList', (search: string) => ({
+     *       execute: ({ count, offset }) => httpService.get(`/doc/${search}?count=${count}&offset=${offset}`),
+     *     }),
+     *   }
+     * };
+     *
+     * // Инвалидирует infinite query с конкретным переданным search
+     * docFetcher.infiniteQueries.docList.invalidate('документ1')
+     */
+    invalidate: (...params: DeepPartial<TParams>) => void;
+    private configureQuery;
+}