vv-iiko-pp-parser 1.0.6

package/dist/clients/clients.fetcher.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientsFetcher = void 0;
+/**
+ * Сервис для загрузки HTML страниц клиентов из iiko Partner Portal.
+ *
+ * Выполняет HTTP GET запросы к endpoints:
+ * - AJAX endpoint для получения списка клиентов
+ * - Страница профиля клиента для получения деталей
+ *
+ * Использует авторизованный HTTP клиент с cookies из IikoSessionService.
+ */
+class ClientsFetcher {
+    constructor(sessionService) {
+        this.sessionService = sessionService;
+        this.clientsListEndpoint = '/en/cabinet/ajax/clients-list.html';
+        this.clientAreaEndpoint = '/en/cabinet/client-area/index.html';
+        this.cloudAllocationEndpoint = '/en/cabinet/client-area/licenses/cloud-mapping.html';
+        this.saasAllocationEndpoint = '/en/cabinet/client-area/licenses/saas-mapping.html';
+    }
+    /**
+     * Выполняет HTTP GET запрос к AJAX endpoint для получения списка клиентов.
+     *
+     * Endpoint: GET /en/cabinet/ajax/clients-list.html
+     *
+     * Параметры запроса:
+     * - query: поисковая строка (фильтрует клиентов по имени или UID на сервере)
+     * - perPage: количество клиентов на странице (по умолчанию: 10)
+     * - page: номер страницы (по умолчанию: 1)
+     *
+     * Возвращаемый HTML содержит:
+     * - Полную HTML страницу с <div id="clientsTable_ajax"> (первый запрос)
+     * - ИЛИ только <tbody class="ajax"> фрагмент (последующие AJAX запросы)
+     *
+     * Предусловия:
+     * - Сессия должна быть инициализирована через sessionService.ensureSession()
+     * - HTTP клиент уже содержит валидные cookies
+     *
+     * @param params Опциональные параметры запроса (query, perPage, page)
+     * @returns Promise с HTML строкой со списком клиентов
+     * @throws Error если запрос вернул ошибку или невалидный ответ
+     */
+    async fetchClientsHtml(params) {
+        try {
+            const perPage = params?.perPage || 10;
+            const page = params?.page || 1;
+            // Получаем авторизованный клиент (сессия уже инициализирована)
+            const client = await this.sessionService.getAuthorizedClient();
+            // Формируем параметры запроса
+            const queryParams = {
+                perPage,
+                page,
+            };
+            if (params?.query) {
+                queryParams.query = params.query;
+            }
+            // Выполняем GET запрос к AJAX endpoint
+            const response = await client.get(this.clientsListEndpoint, {
+                params: queryParams,
+            });
+            if (response.status !== 200) {
+                throw new Error(`AJAX endpoint returned status ${response.status}`);
+            }
+            const html = response.data;
+            if (typeof html !== 'string') {
+                throw new Error('AJAX endpoint returned non-HTML response');
+            }
+            return html;
+        }
+        catch (error) {
+            console.error(`❌ Error fetching clients list: ${error.message}`);
+            if (error.response) {
+                console.error(`HTTP status: ${error.response.status}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Загружает HTML страницу профиля конкретного клиента.
+     *
+     * Endpoint: GET /en/cabinet/client-area/index.html?clientId=XXX
+     *
+     * Возвращаемый HTML содержит:
+     * - UUID клиента (в кнопке "UID: XXX-XXX-XXX")
+     * - Версию iiko (в кнопке "Version iiko: X.X.XXXX")
+     * - Контактную информацию (email, phone в таблице)
+     * - Юридические данные (Legal entity и Company tax id в таблице)
+     * - Информацию о лицензиях и хостинге
+     *
+     * Предусловия:
+     * - Сессия должна быть инициализирована
+     * - Пользователь должен иметь доступ к данному clientId
+     *
+     * @param clientId ID клиента (целочисленный идентификатор)
+     * @returns Promise с HTML строкой страницы профиля клиента
+     * @throws Error если запрос вернул ошибку или клиент не найден
+     */
+    async fetchClientProfile(clientId) {
+        try {
+            const client = await this.sessionService.getAuthorizedClient();
+            const response = await client.get(this.clientAreaEndpoint, {
+                params: { clientId },
+            });
+            if (response.status !== 200) {
+                throw new Error(`Client profile endpoint returned status ${response.status}`);
+            }
+            const html = response.data;
+            if (typeof html !== 'string') {
+                throw new Error('Client profile endpoint returned non-HTML response');
+            }
+            return html;
+        }
+        catch (error) {
+            console.error(`❌ Error fetching client profile ${clientId}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Загружает HTML страницу Cloud license allocation для chain.
+     *
+     * Endpoint: GET /en/cabinet/client-area/licenses/cloud-mapping.html?clientId=XXX
+     *
+     * Эта страница содержит таблицу "Store of the chain" с членами chain и их Cloud лицензиями.
+     * Каждая строка таблицы содержит:
+     * - Имя клиента (ссылка на client-area)
+     * - Input поле с количеством выделенных Cloud лицензий
+     *
+     * Предусловия:
+     * - Сессия должна быть инициализирована
+     * - clientId должен быть Chain (иметь Cloud license allocation)
+     *
+     * @param clientId ID chain для загрузки allocation
+     * @returns Promise с HTML строкой страницы cloud allocation
+     * @throws Error если запрос вернул ошибку или клиент не chain
+     */
+    async fetchCloudAllocationHtml(clientId) {
+        try {
+            const client = await this.sessionService.getAuthorizedClient();
+            const response = await client.get(this.cloudAllocationEndpoint, {
+                params: { clientId },
+            });
+            if (response.status !== 200) {
+                throw new Error(`Cloud allocation endpoint returned status ${response.status}`);
+            }
+            const html = response.data;
+            if (typeof html !== 'string') {
+                throw new Error('Cloud allocation endpoint returned non-HTML response');
+            }
+            return html;
+        }
+        catch (error) {
+            console.error(`❌ Error fetching cloud allocation for ${clientId}: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Загружает HTML страницу SaaS license allocation для chain.
+     *
+     * Endpoint: GET /en/cabinet/client-area/licenses/saas-mapping.html?clientId=XXX
+     *
+     * Эта страница содержит таблицу "Store of the chain" с членами chain и их SaaS лицензиями.
+     * Каждая строка таблицы содержит:
+     * - Имя клиента (ссылка на client-area)
+     * - Input поле с количеством выделенных SaaS лицензий
+     *
+     * Предусловия:
+     * - Сессия должна быть инициализирована
+     * - clientId должен быть Chain (иметь SaaS license allocation)
+     *
+     * @param clientId ID chain для загрузки allocation
+     * @returns Promise с HTML строкой страницы saas allocation
+     * @throws Error если запрос вернул ошибку или клиент не chain
+     */
+    async fetchSaasAllocationHtml(clientId) {
+        try {
+            const client = await this.sessionService.getAuthorizedClient();
+            const response = await client.get(this.saasAllocationEndpoint, {
+                params: { clientId },
+            });
+            if (response.status !== 200) {
+                throw new Error(`SaaS allocation endpoint returned status ${response.status}`);
+            }
+            const html = response.data;
+            if (typeof html !== 'string') {
+                throw new Error('SaaS allocation endpoint returned non-HTML response');
+            }
+            return html;
+        }
+        catch (error) {
+            console.error(`❌ Error fetching saas allocation for ${clientId}: ${error.message}`);
+            throw error;
+        }
+    }
+}
+exports.ClientsFetcher = ClientsFetcher;
+//# sourceMappingURL=clients.fetcher.js.map

package/dist/clients/clients.fetcher.js.map

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

package/dist/clients/clients.parser.d.ts

@@ -0,0 +1,144 @@
+import { ClientListItem, ClientData, AllocationMember } from './clients.types';
+export declare class ClientsParser {
+    /**
+     * Парсит HTML таблицу со списком клиентов.
+     *
+     * Поддерживает две структуры HTML:
+     * 1. Полный HTML с контейнером #clientsTable_ajax (используется на странице /en/cabinet/clients.html)
+     * 2. AJAX фрагмент только с <tbody class="ajax"> (используется в AJAX endpoint /en/cabinet/ajax/clients-list.html)
+     *
+     * Из каждой строки таблицы извлекает:
+     * - name: название клиента (текст из ссылки <a>)
+     * - clientId: идентификатор клиента (из href ?clientId=XXX)
+     * - shortName: краткое название (опционально, из <div class="small mt-2">)
+     *
+     * @param html HTML контент от /en/cabinet/ajax/clients-list.html или полная страница
+     * @returns Массив объектов с базовой информацией о клиентах
+     */
+    parseClientsTable(html: string): ClientListItem[];
+    /**
+     * Извлекает общее количество страниц из HTML пагинации.
+     *
+     * Основной способ:
+     * - Ищет все элементы пагинации: '.pagination a.page-link[data-page]'
+     * - Находит максимальное значение атрибута data-page
+     * - Возвращает его как totalPages
+     *
+     * Резервный способ (fallback):
+     * - Если пагинация отсутствует, ищет '.pagination-total'
+     * - Извлекает общее количество записей из текста
+     * - Вычисляет totalPages = Math.ceil(totalEntries / perPage)
+     *
+     * @param html HTML контент страницы со списком клиентов
+     * @param perPage Количество элементов на странице (для расчета fallback)
+     * @returns Общее количество страниц или 1, если определить не удалось
+     */
+    parseTotalPages(html: string, perPage: number): number;
+    /**
+     * Парсит HTML страницу профиля клиента.
+     *
+     * Извлекает детальную информацию о клиенте со страницы /en/cabinet/client-area/index.html?clientId=XXX:
+     *
+     * - uuid: Уникальный идентификатор (UID) из кнопки "UID: XXX-XXX-XXX"
+     * - iikoVersion: Версия iiko из кнопки "Version iiko: X.X.XXXX"
+     * - email: Email из таблицы (строка "E-mail")
+     * - phone: Телефон из таблицы (строка "Phone")
+     * - address: Адрес из таблицы (строка "Address")
+     * - legalEntity: Название юридического лица (из строки "Legal entity", убираются кавычки «»)
+     * - tin: ИНН (Company tax id, только цифры)
+     *
+     * Нормализация данных:
+     * - UUID: возвращается как есть (формат: XXX-XXX-XXX)
+     * - TIN: удаляются все нечисловые символы (пробелы, дефисы и т.д.)
+     * - Legal Entity: удаляются внешние кавычки «», экранированные кавычки \" заменяются на "
+     *
+     * @param html HTML контент страницы профиля клиента
+     * @param clientId ID клиента для логирования ошибок
+     * @param name Имя клиента для включения в результат
+     * @returns Объект ClientData со всей информацией о клиенте или null при ошибке парсинга
+     */
+    parseClientProfile(html: string, clientId: string, name: string): ClientData | null;
+    /**
+     * Нормализует строку с названием юридического лица.
+     *
+     * Выполняет следующие преобразования:
+     * 1. Удаляет внешние кавычки-ёлочки («»)
+     * 2. Заменяет экранированные кавычки \" на обычные "
+     * 3. Удаляет лишние пробелы в начале и конце
+     *
+     * Примеры:
+     * - «ООО \"AEF GROUP\"» → ООО "AEF GROUP"
+     * - «ИП Иванов» → ИП Иванов
+     *
+     * @param text Исходная строка с названием юридического лица
+     * @returns Нормализованная строка или undefined, если входные данные пусты
+     */
+    private normalizeLegalEntity;
+    /**
+     * Извлекает ИНН (Tax Identification Number) из текста.
+     *
+     * Ищет последовательность цифр в тексте и удаляет все нечисловые символы
+     * (пробелы, дефисы, точки и т.д.), оставляя только цифры.
+     *
+     * Примеры:
+     * - "304 467 088" → "304467088"
+     * - "12-34-567890" → "1234567890"
+     * - "123.456.789" → "123456789"
+     *
+     * @param text Исходная строка с ИНН
+     * @returns Строка, содержащая только цифры, или undefined, если ИНН не найден
+     */
+    private extractTin;
+    /**
+     * Определяет, является ли клиент Chain (группой компаний).
+     *
+     * Chain определяется наличием хотя бы одной из кнопок на странице client-area:
+     * - "Cloud license allocation"
+     * - "SaaS license allocation"
+     *
+     * Эти кнопки ведут на:
+     * - /client-area/licenses/cloud-mapping.html
+     * - /client-area/licenses/saas-mapping.html
+     *
+     * Метод ищет ссылки (<a>) содержащие эти пути в атрибуте href.
+     *
+     * @param html HTML контент страницы client-area
+     * @returns true если клиент является Chain, иначе false
+     */
+    detectIsChain(html: string): boolean;
+    /**
+     * Парсит HTML страницу allocation (cloud или saas).
+     *
+     * Извлекает членов chain из JSON данных в атрибуте data-template-params.
+     *
+     * Структура JSON:
+     * - tps: массив торговых точек (members chain)
+     * - mapping: распределение лицензий по продуктам
+     *
+     * Каждый элемент tps содержит:
+     * - id: внутренний ID
+     * - obfuscated_id: ID для URL (используется как clientId)
+     * - name: название торговой точки
+     * - link: ссылка на профиль (/client-area/index.html?clientId=XXX)
+     *
+     * Mapping содержит количество лицензий по формуле:
+     * mapping[productId][date][firmId][tpId] = количество
+     *
+     * Для подсчёта allocation суммируются все значения для каждого tp.
+     *
+     * @param html HTML контент страницы cloud-mapping или saas-mapping
+     * @returns Массив AllocationMember с информацией о членах и их allocation
+     */
+    parseAllocationPage(html: string): AllocationMember[];
+    /**
+     * Legacy метод парсинга allocation через HTML таблицу.
+     *
+     * Используется как fallback если JSON парсинг не сработал.
+     * Ищет таблицу с членами chain и input полями с allocation.
+     *
+     * @param html HTML контент страницы allocation
+     * @returns Массив AllocationMember
+     */
+    private parseAllocationPageLegacy;
+}
+//# sourceMappingURL=clients.parser.d.ts.map

package/dist/clients/clients.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.parser.d.ts","sourceRoot":"","sources":["../../src/clients/clients.parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,qBAAa,aAAa;IACxB;;;;;;;;;;;;;;OAcG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAoCxD;;;;;;;;;;;;;;;;OAgBG;IACI,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAkC7D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAiG1F;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,UAAU;IAalB;;;;;;;;;;;;;;;OAeG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAsB3C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAwF5D;;;;;;;;OAQG;IACH,OAAO,CAAC,yBAAyB;CAiDlC"}