vv-iiko-pp-parser 1.0.6

package/dist/iiko-parser.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IikoParser = void 0;
+const iiko_parser_config_1 = require("./core/iiko-parser.config");
+const iiko_http_client_1 = require("./core/http/iiko-http.client");
+const iiko_auth_service_1 = require("./core/auth/iiko-auth.service");
+const iiko_session_service_1 = require("./core/session/iiko-session.service");
+const iiko_parser_service_1 = require("./core/parser/iiko-parser.service");
+const invoices_service_1 = require("./invoices/invoices.service");
+const invoices_fetcher_1 = require("./invoices/invoices.fetcher");
+const invoices_parser_1 = require("./invoices/invoices.parser");
+const invoices_filters_1 = require("./invoices/invoices.filters");
+const invoices_storage_service_1 = require("./invoices/invoices.storage.service");
+const clients_service_1 = require("./clients/clients.service");
+/**
+ * Главный класс для работы с iiko Partner Portal.
+ *
+ * Предоставляет высокоуровневое API для:
+ * - Получения списка инвойсов с фильтрацией
+ * - Парсинга деталей инвойсов из модальных окон
+ * - Получения профиля компании
+ *
+ * Управляет всеми внутренними сервисами: авторизацией, HTTP-клиентом,
+ * парсингом HTML и хранением cookies.
+ */
+class IikoParser {
+    /**
+     * Создаёт экземпляр парсера iiko Partner Portal.
+     *
+     * Инициализирует все внутренние сервисы в правильном порядке зависимостей.
+     * Cookies сохраняются автоматически после авторизации для переиспользования.
+     *
+     * @param options - Конфигурация парсера (логин, пароль, опциональные настройки)
+     */
+    constructor(options) {
+        this.options = options;
+        // Setup cookies path
+        this.cookiesPath = iiko_parser_config_1.IikoParserConfig.getCookiesPath(options.cookiesPath);
+        // Create all services following the same dependency chain as reference
+        this.httpClient = new iiko_http_client_1.IikoHttpClient();
+        this.authService = new iiko_auth_service_1.IikoAuthService(options.login, options.password, this.httpClient, this.cookiesPath, this.report.bind(this));
+        this.sessionService = new iiko_session_service_1.IikoSessionService(this.authService, this.httpClient, this.report.bind(this));
+        this.parserService = new iiko_parser_service_1.IikoParserService(this.sessionService);
+        // Create invoices services
+        const invoicesFetcher = new invoices_fetcher_1.InvoicesFetcher(this.sessionService);
+        const invoicesParser = new invoices_parser_1.InvoicesParser();
+        const invoicesFilters = new invoices_filters_1.InvoicesFilters();
+        const invoicesStorage = new invoices_storage_service_1.IikoInvoicesStorageService();
+        this.invoicesService = new invoices_service_1.InvoicesService(invoicesFetcher, invoicesParser, invoicesFilters, invoicesStorage, this.report.bind(this));
+        // Create clients service
+        this.clientsService = new clients_service_1.ClientsService(this.sessionService, this.report.bind(this));
+    }
+    /**
+     * Безопасно сообщает о прогрессе выполнения.
+     *
+     * Вызывает callback только если он был передан в options.
+     * Не выбрасывает исключения при ошибках в callback.
+     *
+     * @param event - Событие прогресса
+     */
+    report(event) {
+        this.options.onProgress?.(event);
+    }
+    /**
+     * Инициализирует или проверяет текущую сессию.
+     *
+     * Порядок действий:
+     * 1. Пытается загрузить cookies из файла
+     * 2. Если cookies валидные — использует их
+     * 3. Если cookies отсутствуют или невалидные — выполняет авторизацию
+     *
+     * Метод безопасно вызывать многократно. Повторная авторизация
+     * выполняется только при необходимости.
+     *
+     * @returns Promise, который резолвится после успешной инициализации сессии
+     */
+    async ensureSession() {
+        // This follows the EXACT same logic as the reference
+        await this.sessionService.ensureSession();
+    }
+    /**
+     * Получает список инвойсов с опциональной фильтрацией и деталями.
+     *
+     * Без флага `withDetails` возвращает только основные данные (быстро).
+     * С флагом `withDetails: true` дополнительно загружает items и subscriptions
+     * из модальных окон каждого инвойса (медленнее).
+     *
+     * Поддерживаемые фильтры:
+     * - searchBy: 'invoice_number' | 'tax_id' | 'client' | 'firm'
+     * - searchValue: значение для поиска
+     * - dateFrom / dateTo: фильтрация по дате (YYYY-MM-DD)
+     * - pagination: управление пагинацией (pageSize, maxPages)
+     * - withDetails: загружать ли детали из модальных окон
+     *
+     * Пагинация:
+     * - По умолчанию загружаются все страницы
+     * - Можно ограничить через pagination.maxPages
+     * - Размер страницы задаётся через pagination.pageSize (по умолчанию: 50)
+     *
+     * @param filter - Опциональные параметры фильтрации и загрузки деталей
+     * @returns Массив инвойсов с заполненными полями
+     *
+     * @example
+     * // Быстрый поиск без деталей
+     * const invoices = await parser.getInvoices({ searchBy: 'invoice_number', searchValue: 'INV123' });
+     *
+     * @example
+     * // Полная загрузка с деталями
+     * const invoices = await parser.getInvoices({ withDetails: true });
+     *
+     * @example
+     * // Загрузка с ограничением пагинации
+     * const invoices = await parser.getInvoices({
+     *   pagination: { maxPages: 2, pageSize: 100 }
+     * });
+     */
+    async getInvoices(filter) {
+        // Extract pagination options
+        const pageSize = filter?.pagination?.pageSize || 50;
+        const maxPages = filter?.pagination?.maxPages;
+        // Delegate to invoices service with pagination and date filters
+        const invoices = await this.invoicesService.fetchAndParseInvoices({
+            searchBy: filter?.searchBy,
+            searchValue: filter?.searchValue,
+            dateFrom: filter?.dateFrom,
+            dateTo: filter?.dateTo,
+            pageSize,
+            maxPages,
+        });
+        // Enrich with details from modal windows if requested
+        if (filter?.withDetails === true) {
+            const enrichedInvoices = await this.invoicesService.enrichInvoicesWithDetails(invoices);
+            this.report({ stage: 'done', message: 'Invoices parsing completed with details' });
+            return enrichedInvoices;
+        }
+        this.report({ stage: 'done', message: 'Invoices parsing completed' });
+        return invoices;
+    }
+    /**
+     * Получает профиль компании из кабинета iiko Partner Portal.
+     *
+     * Извлекает информацию о компании, включая название, телефон и email.
+     * Требует предварительной инициализации сессии через `ensureSession()`.
+     *
+     * @returns Профиль компании с основными данными
+     */
+    async getCompanyProfile() {
+        // Get profile using parser service
+        const profile = await this.parserService.parseCompanyProfile();
+        // Convert to our public API format
+        return {
+            name: profile.companyName,
+            phone: profile.phone,
+            email: profile.email,
+            address: '', // Not available in original interface
+        };
+    }
+    /**
+     * Получает список клиентов с детальной информацией.
+     *
+     * Загружает все страницы клиентов из /en/cabinet/ajax/clients-list.html,
+     * затем для каждого клиента загружает детальную информацию профиля
+     * из /en/cabinet/client-area/index.html.
+     *
+     * Детали клиента включают:
+     * - UUID клиента
+     * - Версия iiko
+     * - Email и телефон
+     * - Юридическое лицо (Legal Entity)
+     * - ИНН (TIN - только цифры)
+     *
+     * Поддерживаемые фильтры:
+     * - query: поисковый запрос по названию клиента
+     * - perPage: количество клиентов на странице (по умолчанию: 20)
+     * - maxPages: максимальное количество страниц для загрузки (по умолчанию: все)
+     *
+     * Пагинация:
+     * - По умолчанию загружаются все страницы
+     * - Можно ограничить через maxPages
+     *
+     * Progress stages:
+     * - fetch_clients: загрузка страниц со списком клиентов
+     * - parse_clients: парсинг списка клиентов
+     * - fetch_client_details: загрузка деталей каждого клиента
+     * - done: завершение работы
+     *
+     * @param filter - Опциональные параметры фильтрации
+     * @returns Массив клиентов с полной информацией
+     *
+     * @example
+     * // Загрузить всех клиентов
+     * const clients = await parser.getClients();
+     *
+     * @example
+     * // Поиск клиентов по запросу
+     * const clients = await parser.getClients({ query: 'Restaurant' });
+     *
+     * @example
+     * // Ограничить количество страниц
+     * const clients = await parser.getClients({ maxPages: 2, perPage: 50 });
+     */
+    async getClients(filter) {
+        const clients = await this.clientsService.fetchAndParseClients(filter);
+        this.report({ stage: 'done', message: 'Clients parsing completed' });
+        return clients;
+    }
+}
+exports.IikoParser = IikoParser;
+//# sourceMappingURL=iiko-parser.js.map

package/dist/iiko-parser.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { IikoParser } from './iiko-parser';
+export type { IikoParserOptions, InvoicesFilter, InvoiceData, CompanyProfile, ParserProgressEvent, ParserProgressCallback } from './types';
+export type { ClientsFilter, ClientData } from './clients/clients.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IikoParser = void 0;
+// Public API exports
+var iiko_parser_1 = require("./iiko-parser");
+Object.defineProperty(exports, "IikoParser", { enumerable: true, get: function () { return iiko_parser_1.IikoParser; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qBAAqB;AACrB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA"}

package/dist/interfaces/company-profile.interface.d.ts

@@ -0,0 +1,12 @@
+export interface CompanyProfile {
+    companyName: string;
+    phone: string;
+    email: string;
+    partnerStatus: string;
+    masterPartner: {
+        company: string;
+        manager: string;
+        email: string;
+    };
+}
+//# sourceMappingURL=company-profile.interface.d.ts.map

package/dist/interfaces/company-profile.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"company-profile.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/company-profile.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/interfaces/company-profile.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=company-profile.interface.js.map

package/dist/interfaces/company-profile.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"company-profile.interface.js","sourceRoot":"","sources":["../../src/interfaces/company-profile.interface.ts"],"names":[],"mappings":""}

package/dist/invoices/index.d.ts

@@ -0,0 +1,6 @@
+export * from './invoices.service';
+export * from './invoices.fetcher';
+export * from './invoices.parser';
+export * from './invoices.filters';
+export * from './invoices.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/invoices/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/invoices/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./invoices.service"), exports);
+__exportStar(require("./invoices.fetcher"), exports);
+__exportStar(require("./invoices.parser"), exports);
+__exportStar(require("./invoices.filters"), exports);
+__exportStar(require("./invoices.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/invoices/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/invoices/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,qDAAmC;AACnC,oDAAkC;AAClC,qDAAmC;AACnC,mDAAiC"}

package/dist/invoices/invoices.fetcher.d.ts

@@ -0,0 +1,49 @@
+import { IikoSessionService } from '../core/session/iiko-session.service';
+import { InvoicesFetchParams } from './invoices.types';
+/**
+ * Сервис для загрузки HTML страниц из iiko Partner Portal.
+ *
+ * Выполняет HTTP GET запросы к различным endpoints портала:
+ * - AJAX endpoint для получения таблицы инвойсов
+ * - Modal endpoint для получения деталей конкретного инвойса
+ *
+ * Использует авторизованный HTTP клиент с cookies из IikoSessionService.
+ */
+export declare class InvoicesFetcher {
+    private readonly sessionService;
+    private readonly ajaxEndpoint;
+    private readonly modalEndpoint;
+    constructor(sessionService: IikoSessionService);
+    /**
+     * Выполняет HTTP GET запрос к AJAX endpoint iiko PP
+     * для получения HTML таблицы инвойсов.
+     *
+     * Использует уже авторизованный HTTP клиент с CookieJar.
+     * Не выполняет авторизацию и не валидирует сессию.
+     *
+     * Поддерживает пагинацию и кастомные query-параметры для фильтрации
+     * (searchBy, query и другие).
+     *
+     * @param params - Параметры пагинации (perPage, page)
+     * @param customParams - Дополнительные query-параметры (search_by, query, и т.д.)
+     * @returns HTML строку с таблицей инвойсов
+     */
+    fetchInvoicesHtml(params?: InvoicesFetchParams, customParams?: Record<string, any>): Promise<string>;
+    /**
+     * Загружает HTML модального окна с деталями инвойса
+     */
+    fetchInvoiceModal(clientId: string, invoiceId: string): Promise<string>;
+    /**
+     * Загружает HTML модального окна с деталями инвойса по прямому URL.
+     *
+     * URL обычно извлекается из поля `detailsUrl` объекта InvoiceData.
+     * Выполняет простой GET запрос без дополнительной обработки.
+     *
+     * Использует авторизованный HTTP клиент с CookieJar.
+     *
+     * @param url - Относительный или абсолютный URL модального окна
+     * @returns HTML строку с деталями инвойса (items, subscriptions)
+     */
+    fetchInvoiceDetails(url: string): Promise<string>;
+}
+//# sourceMappingURL=invoices.fetcher.d.ts.map

package/dist/invoices/invoices.fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.fetcher.d.ts","sourceRoot":"","sources":["../../src/invoices/invoices.fetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,cAAc;IAH3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiD;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;gBAE7C,cAAc,EAAE,kBAAkB;IAE/D;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CACrB,MAAM,CAAC,EAAE,mBAAmB,EAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;IA0DlB;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAkClB;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA0BxD"}

package/dist/invoices/invoices.fetcher.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoicesFetcher = void 0;
+/**
+ * Сервис для загрузки HTML страниц из iiko Partner Portal.
+ *
+ * Выполняет HTTP GET запросы к различным endpoints портала:
+ * - AJAX endpoint для получения таблицы инвойсов
+ * - Modal endpoint для получения деталей конкретного инвойса
+ *
+ * Использует авторизованный HTTP клиент с cookies из IikoSessionService.
+ */
+class InvoicesFetcher {
+    constructor(sessionService) {
+        this.sessionService = sessionService;
+        this.ajaxEndpoint = '/en/cabinet/invoices/get-for-customers-ajax';
+        this.modalEndpoint = '/en/cabinet/invoices/invoice-info.html';
+    }
+    /**
+     * Выполняет HTTP GET запрос к AJAX endpoint iiko PP
+     * для получения HTML таблицы инвойсов.
+     *
+     * Использует уже авторизованный HTTP клиент с CookieJar.
+     * Не выполняет авторизацию и не валидирует сессию.
+     *
+     * Поддерживает пагинацию и кастомные query-параметры для фильтрации
+     * (searchBy, query и другие).
+     *
+     * @param params - Параметры пагинации (perPage, page)
+     * @param customParams - Дополнительные query-параметры (search_by, query, и т.д.)
+     * @returns HTML строку с таблицей инвойсов
+     */
+    async fetchInvoicesHtml(params, customParams) {
+        try {
+            const perPage = params?.perPage || 10;
+            const page = params?.page || 1;
+            // Получаем авторизованный клиент (сессия уже инициализирована)
+            const client = await this.sessionService.getAuthorizedClient();
+            // Объединяем параметры
+            const queryParams = {
+                perPage,
+                page,
+                ...customParams,
+            };
+            // Выполняем GET запрос к AJAX endpoint
+            const response = await client.get(this.ajaxEndpoint, {
+                params: queryParams,
+                paramsSerializer: (params) => {
+                    // Кастомный сериализатор для поддержки массивов в формате key[]=value
+                    const parts = [];
+                    Object.keys(params).forEach((key) => {
+                        const value = params[key];
+                        if (Array.isArray(value)) {
+                            value.forEach((v) => {
+                                parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);
+                            });
+                        }
+                        else {
+                            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+                        }
+                    });
+                    return parts.join('&');
+                },
+            });
+            if (response.status !== 200) {
+                throw new Error(`AJAX endpoint вернул статус ${response.status}`);
+            }
+            const html = response.data;
+            if (typeof html !== 'string') {
+                throw new Error('AJAX endpoint вернул не HTML');
+            }
+            return html;
+        }
+        catch (error) {
+            console.error(`❌ Ошибка при запросе таблицы инвойсов: ${error.message}`);
+            if (error.response) {
+                console.error(`HTTP статус: ${error.response.status}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Загружает HTML модального окна с деталями инвойса
+     */
+    async fetchInvoiceModal(clientId, invoiceId) {
+        try {
+            // Получаем авторизованный клиент (сессия уже инициализирована)
+            const client = await this.sessionService.getAuthorizedClient();
+            const response = await client.get(this.modalEndpoint, {
+                params: {
+                    client_id: clientId,
+                    invoice_id: invoiceId,
+                },
+            });
+            if (response.status !== 200) {
+                throw new Error(`Modal endpoint вернул статус ${response.status}`);
+            }
+            const html = response.data;
+            if (typeof html !== 'string') {
+                throw new Error('Modal endpoint вернул не HTML');
+            }
+            return html;
+        }
+        catch (error) {
+            console.error(`❌ Ошибка при загрузке модального окна (client=${clientId}, invoice=${invoiceId}): ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Загружает HTML модального окна с деталями инвойса по прямому URL.
+     *
+     * URL обычно извлекается из поля `detailsUrl` объекта InvoiceData.
+     * Выполняет простой GET запрос без дополнительной обработки.
+     *
+     * Использует авторизованный HTTP клиент с CookieJar.
+     *
+     * @param url - Относительный или абсолютный URL модального окна
+     * @returns HTML строку с деталями инвойса (items, subscriptions)
+     */
+    async fetchInvoiceDetails(url) {
+        try {
+            // Получаем авторизованный клиент (сессия уже инициализирована)
+            const client = await this.sessionService.getAuthorizedClient();
+            const response = await client.get(url);
+            if (response.status !== 200) {
+                throw new Error(`Запрос к ${url} вернул статус ${response.status}`);
+            }
+            const html = response.data;
+            if (typeof html !== 'string') {
+                throw new Error('Endpoint вернул не HTML');
+            }
+            return html;
+        }
+        catch (error) {
+            console.error(`❌ Ошибка при загрузке деталей инвойса (${url}): ${error.message}`);
+            throw error;
+        }
+    }
+}
+exports.InvoicesFetcher = InvoicesFetcher;
+//# sourceMappingURL=invoices.fetcher.js.map

package/dist/invoices/invoices.fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.fetcher.js","sourceRoot":"","sources":["../../src/invoices/invoices.fetcher.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;GAQG;AACH,MAAa,eAAe;IAI1B,YAA6B,cAAkC;QAAlC,mBAAc,GAAd,cAAc,CAAoB;QAH9C,iBAAY,GAAG,6CAA6C,CAAC;QAC7D,kBAAa,GAAG,wCAAwC,CAAC;IAER,CAAC;IAEnE;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,iBAAiB,CACrB,MAA4B,EAC5B,YAAkC;QAElC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC;YAE/B,+DAA+D;YAC/D,MAAM,MAAM,GACV,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,EAAE,CAAC;YAElD,uBAAuB;YACvB,MAAM,WAAW,GAAG;gBAClB,OAAO;gBACP,IAAI;gBACJ,GAAG,YAAY;aAChB,CAAC;YAEF,uCAAuC;YACvC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE;gBACnD,MAAM,EAAE,WAAW;gBACnB,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE;oBAC3B,sEAAsE;oBACtE,MAAM,KAAK,GAAa,EAAE,CAAC;oBAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;wBAClC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;4BACzB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gCAClB,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BACpE,CAAC,CAAC,CAAC;wBACL,CAAC;6BAAM,CAAC;4BACN,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;wBACxE,CAAC;oBACH,CAAC,CAAC,CAAC;oBACH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzB,CAAC;aACF,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACpE,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;YAE3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,0CAA2C,KAAa,CAAC,OAAO,EAAE,CACnE,CAAC;YACF,IAAK,KAAa,CAAC,QAAQ,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,gBAAiB,KAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,QAAgB,EAChB,SAAiB;QAEjB,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,MAAM,GACV,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,EAAE,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE;gBACpD,MAAM,EAAE;oBACN,SAAS,EAAE,QAAQ;oBACnB,UAAU,EAAE,SAAS;iBACtB;aACF,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,MAAM,EAAE,CAClD,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;YAE3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,iDAAiD,QAAQ,aAAa,SAAS,MAAO,KAAa,CAAC,OAAO,EAAE,CAC9G,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,mBAAmB,CAAC,GAAW;QACnC,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,MAAM,GACV,MAAM,IAAI,CAAC,cAAc,CAAC,mBAAmB,EAAE,CAAC;YAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEvC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,kBAAkB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;YAE3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,0CAA0C,GAAG,MAAO,KAAa,CAAC,OAAO,EAAE,CAC5E,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AA9JD,0CA8JC"}

package/dist/invoices/invoices.filters.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Утилиты для работы с фильтрами и query-параметрами инвойсов.
+ *
+ * Формирует корректные параметры для AJAX endpoint iiko Partner Portal
+ * с учётом специфики API (массивы статусов, форматы дат, поисковые запросы).
+ */
+export declare class InvoicesFilters {
+    /**
+     * Конвертирует дату из формата YYYY-MM-DD в dd.mm.yyyy
+     * @param date - Дата в формате YYYY-MM-DD (например, "2026-01-15")
+     * @returns Дата в формате dd.mm.yyyy (например, "15.01.2026")
+     */
+    convertDateFormat(date: string): string;
+    /**
+     * Формирует query параметры для фильтрации инвойсов.
+     *
+     * Конвертирует высокоуровневые параметры (год, месяц, статусы, поиск)
+     * в формат query-параметров, ожидаемый API iiko Partner Portal.
+     *
+     * Статусы передаются как массив с ключом `invoiceStatus[]`.
+     * Месяц форматируется как `YYYY-MM`.
+     *
+     * @param params - Параметры фильтрации
+     * @returns Объект с query-параметрами для axios
+     */
+    buildFilterParams(params: {
+        year: number;
+        month: number;
+        statuses: string[];
+        page: number;
+        perPage: number;
+        searchBy?: string;
+        searchValue?: string;
+    }): Record<string, string | string[]>;
+    /**
+     * Форматирует query параметры для axios
+     */
+    formatForAxios(params: Record<string, string | string[]>): any;
+}
+//# sourceMappingURL=invoices.filters.d.ts.map

package/dist/invoices/invoices.filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.filters.d.ts","sourceRoot":"","sources":["../../src/invoices/invoices.filters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKvC;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAmCrC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,GAAG;CAe/D"}

package/dist/invoices/invoices.filters.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoicesFilters = void 0;
+/**
+ * Утилиты для работы с фильтрами и query-параметрами инвойсов.
+ *
+ * Формирует корректные параметры для AJAX endpoint iiko Partner Portal
+ * с учётом специфики API (массивы статусов, форматы дат, поисковые запросы).
+ */
+class InvoicesFilters {
+    /**
+     * Конвертирует дату из формата YYYY-MM-DD в dd.mm.yyyy
+     * @param date - Дата в формате YYYY-MM-DD (например, "2026-01-15")
+     * @returns Дата в формате dd.mm.yyyy (например, "15.01.2026")
+     */
+    convertDateFormat(date) {
+        const [year, month, day] = date.split('-');
+        return `${day}.${month}.${year}`;
+    }
+    /**
+     * Формирует query параметры для фильтрации инвойсов.
+     *
+     * Конвертирует высокоуровневые параметры (год, месяц, статусы, поиск)
+     * в формат query-параметров, ожидаемый API iiko Partner Portal.
+     *
+     * Статусы передаются как массив с ключом `invoiceStatus[]`.
+     * Месяц форматируется как `YYYY-MM`.
+     *
+     * @param params - Параметры фильтрации
+     * @returns Объект с query-параметрами для axios
+     */
+    buildFilterParams(params) {
+        const { year, month, statuses, page, perPage, searchBy, searchValue } = params;
+        // Формируем месяц в формате YYYY-MM
+        const monthStr = month.toString().padStart(2, '0');
+        const monthValue = `${year}-${monthStr}`;
+        const queryParams = {
+            invoice_created_month_value: monthValue,
+            page: page.toString(),
+            perPage: perPage.toString(),
+        };
+        // Добавляем статусы как массив
+        if (statuses && statuses.length > 0) {
+            // Используем специальный ключ для массива
+            statuses.forEach((status) => {
+                const key = 'invoiceStatus[]';
+                if (Array.isArray(queryParams[key])) {
+                    queryParams[key].push(status);
+                }
+                else {
+                    queryParams[key] = [status];
+                }
+            });
+        }
+        // Добавляем параметры поиска если указаны
+        if (searchBy && searchValue) {
+            queryParams['search_by'] = searchBy;
+            queryParams['search'] = searchValue;
+        }
+        return queryParams;
+    }
+    /**
+     * Форматирует query параметры для axios
+     */
+    formatForAxios(params) {
+        const result = {};
+        Object.keys(params).forEach((key) => {
+            const value = params[key];
+            if (Array.isArray(value)) {
+                // Для массивов axios нужен специальный формат
+                result[key] = value;
+            }
+            else {
+                result[key] = value;
+            }
+        });
+        return result;
+    }
+}
+exports.InvoicesFilters = InvoicesFilters;
+//# sourceMappingURL=invoices.filters.js.map

package/dist/invoices/invoices.filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.filters.js","sourceRoot":"","sources":["../../src/invoices/invoices.filters.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,eAAe;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,IAAY;QAC5B,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,GAAG,GAAG,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,MAQjB;QACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAE/E,oCAAoC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC;QAEzC,MAAM,WAAW,GAAsC;YACrD,2BAA2B,EAAE,UAAU;YACvC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;YACrB,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;SAC5B,CAAC;QAEF,+BAA+B;QAC/B,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,0CAA0C;YAC1C,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC1B,MAAM,GAAG,GAAG,iBAAiB,CAAC;gBAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBACnC,WAAW,CAAC,GAAG,CAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9C,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,0CAA0C;QAC1C,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YAC5B,WAAW,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC;YACpC,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC;QACtC,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAyC;QACtD,MAAM,MAAM,GAAQ,EAAE,CAAC;QAEvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,8CAA8C;gBAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AApFD,0CAoFC"}