vv-iiko-pp-parser 1.0.6

package/CHANGELOG.md

@@ -0,0 +1,151 @@
+# Changelog
+
+## [1.0.6] - 2026-01-18
+
+### ✨ Added
+- **Chain support**: Полная поддержка групп компаний (Chain)
+  - Новые поля в `ClientData`: `isChain: boolean`, `members: ClientMember[]`
+  - Интерфейс `ClientMember` с полями: uuid, name, clientId, iikoVersion, email, phone, legalEntity, tin, address, cloudAllocation, saasAllocation
+  - Автоматическое определение Chain через наличие ссылок на Cloud/SaaS allocation
+  - Загрузка членов группы из `/client-area/licenses/cloud-mapping.html` и `/client-area/licenses/saas-mapping.html`
+  - Парсинг JSON из атрибута `data-template-params` с декодированием HTML entities
+  - Агрегация лицензий: `cloudAllocation` и `saasAllocation` для каждого члена
+  - Дедупликация клиентов через `Map<clientId, ClientData>`
+  - Исключение членов Chain из корневого списка через `Set<memberClientIds>`
+  - Новые стадии прогресса: `detect_chain`, `load_chain_members`
+
+### 📚 Documentation
+- **INTEGRATION_GUIDE.md**: Полное руководство для разработчиков с примерами использования Chain API
+- **CHAIN_IMPLEMENTATION.md**: Техническая документация реализации Chain логики
+
+### 🔧 Technical
+- Новые методы в `ClientsFetcher`: `fetchCloudAllocationHtml()`, `fetchSaasAllocationHtml()`
+- Новые методы в `ClientsParser`: `detectIsChain()`, `parseAllocationPage()`, `parseAllocationPageLegacy()`
+- Полная переработка `ClientsService.enrichWithDetails()` с Map/Set алгоритмами
+- Метод `loadChainMembers()` для загрузки и обогащения данных членов группы
+
+---
+
+## [1.0.5] - 2026-01-18
+
+### ✨ Added
+- **Address field**: Добавлено поле `address` в интерфейс `ClientData`
+  - Парсинг адреса из таблицы профиля клиента (строка "Address")
+  - Автоматическая нормализация адреса (удаление лишних пробелов, переносов строк и HTML тегов)
+  - Замена `<br>` тегов на пробелы для читаемости
+  - Обновлена документация и примеры использования
+
+### 🔧 Technical
+- Нормализация адреса: `replace(/<br\s*\/?>/gi, ' ')` → `replace(/\s+/g, ' ')` → `trim()`
+- Поддержка многострочных адресов из HTML
+
+---
+
+## [1.0.4] - 2026-01-18
+
+### ✨ Added
+- **getClients() functionality**: Новая функция для получения списка клиентов с полной информацией
+  - Модуль `clients/` с архитектурой: fetcher, parser, service, types
+  - Парсинг списка клиентов из `/en/cabinet/ajax/clients-list.html`
+  - Парсинг профилей клиентов из `/en/cabinet/client-area/index.html`
+  - Извлечение данных: UUID, name, clientId, iikoVersion, email, phone, legalEntity, tin
+  - Нормализация: TIN (только цифры), Legal Entity (удаление кавычек «»)
+  
+- **totalPages support**: Автоматическое определение общего количества страниц
+  - Парсинг из `.pagination a.page-link[data-page]`
+  - Fallback через `.pagination-total` с расчетом `ceil(totalEntries / perPage)`
+  - Корректное отображение прогресса: `[1/14]`, `[2/14]` вместо `[1/?]`
+
+- **Progress tracking для клиентов**: Новые стадии прогресса
+  - `fetch_clients`: загрузка страниц списка клиентов
+  - `parse_clients`: парсинг списка клиентов
+  - `fetch_client_details`: загрузка профилей клиентов
+
+### 🔧 Technical
+- Правильные селекторы: `#clientsTable_ajax tbody.ajax tr` с fallback на `tbody.ajax tr`
+- Поддержка полного HTML и AJAX фрагментов
+- Подробная JSDoc документация для всех методов
+- 87 файлов в пакете, размер: 65.8 kB
+
+### 📝 Documentation
+- Добавлен раздел "Получение списка клиентов" в README
+- Примеры фильтрации и обработки данных клиентов
+- Обновлена таблица событий прогресса
+
+---
+
+## [1.0.3] - 2026-01-16
+
+### ✨ Added
+- **Progress Tracking (Stage 8)**: Механизм отслеживания прогресса выполнения
+  - Новый интерфейс `ParserProgressEvent` с этапами: `session`, `auth`, `fetch_invoices`, `parse_invoices`, `fetch_invoice_details`, `done`
+  - Опциональный callback `onProgress` в `IikoParserOptions`
+  - События прогресса во всех ключевых точках: сессия, авторизация, пагинация, парсинг, загрузка деталей
+  - Поддержка счетчиков для операций с прогрессом (`current`/`total`)
+  - Информация о текущем инвойсе при загрузке деталей (`invoiceNumber`)
+
+### 📝 Documentation
+- Добавлен раздел "Progress Tracking" в README
+- Примеры интеграции с WebSocket и SSE
+- Новый example `progress-tracking.js` с 4 сценариями использования
+- Таблица событий прогресса с описанием полей
+
+### 🔧 Technical
+- Callback передается через конструкторы всех сервисов
+- Безопасная реализация без side-effects при отсутствии callback
+- WebSocket-ready архитектура (без привязки к конкретной реализации)
+- Экспорт `ParserProgressEvent` и `ParserProgressCallback` типов
+
+---
+
+## [1.0.2] - 2026-01-14
+
+### 🐛 Fixed
+- **README**: Исправлена опечатка в import statement (двойной `@mirzaev/`)
+
+---
+
+## [1.0.1] - 2026-01-14
+
+### 🐛 Fixed
+- **Фильтрация по датам**: Исправлена ошибка, когда параметры `dateFrom` и `dateTo` игнорировались
+  - Добавлена конвертация формата даты из `YYYY-MM-DD` в `dd.mm.yyyy` (формат iiko API)
+  - Параметры `invoice_created_from` и `invoice_created_to` теперь корректно передаются в HTTP запрос
+  - Фильтрация теперь возвращает инвойсы только за указанный период
+
+### ✨ Added
+- Новый пример `examples/date-filtering.js` с 5 сценариями использования фильтрации по датам
+- Метод `InvoicesFilters.convertDateFormat()` для конвертации дат
+
+### 📝 Documentation
+- Обновлена документация с пояснением формата дат
+- Добавлено примечание об автоматической конвертации формата
+
+---
+
+## [1.0.0] - 2026-01-14
+
+### 🎉 Initial Release
+
+#### Core Features
+- ✅ Авторизация через форму (email + password)
+- ✅ Автоматическое сохранение и переиспользование cookies
+- ✅ Парсинг таблицы инвойсов с полями (номер, дата, клиент, tax_id, сумма и т.д.)
+- ✅ Парсинг модальных окон (items и subscriptions)
+- ✅ Пагинация с контролем (pageSize, maxPages)
+- ✅ Фильтрация по параметрам (searchBy, searchValue, dateFrom, dateTo)
+- ✅ Нормализация tax_id (удаление пробелов)
+
+#### Documentation
+- 📖 Comprehensive README с примерами
+- 📖 6 рабочих примеров в папке `examples/`
+- 📖 JSDoc для всех публичных API
+- 📖 TypeScript definitions с полным export
+
+#### Package Configuration
+- 📦 Scoped package: `@mirzaev/vv-iiko-pp-parser`
+- 🔒 Private access (restricted)
+- 📝 UNLICENSED license
+- 🏗️ TypeScript source → JavaScript dist
+- 🎯 Node.js >= 16.0.0
+