Changelog
=========

All notable changes to this project will be documented in this file.

The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.0.0/>`_,
and this project adheres to `Semantic Versioning <https://semver.org/spec/v2.0.0/>`_.

[2.5.0] - 2025-01-15
--------------------

Added
~~~~~

- 🔒 Enhanced security features with improved validation mechanisms
- 🚀 Optimized performance across all core modules
- 📚 Updated documentation and improved examples
- 🛡️ Strengthened webhook security mechanisms
- 🔧 Better error messages and enhanced debugging support
- ⚡ Added TgCrypto as core dependency for faster Pyrogram operations

Changed
~~~~~~~

- Improved async/sync compatibility across all adapters
- Streamlined error handling with clearer, more informative messages
- Optimized memory usage and faster library initialization
- Simplified webhook processing pipeline for better performance

Improved
~~~~~~~~

- Better separation of concerns in core modules
- Enhanced debugging capabilities with more detailed error information
- Reduced memory footprint and improved startup time
- More robust validation and error recovery mechanisms

Security
~~~~~~~~

- Enhanced input validation with stricter security checks
- Improved webhook signature verification
- Additional security layers for payment processing
- Better protection against common attack vectors

Migration Guide
~~~~~~~~~~~~~~

- Review error handling code for potential exception type changes
- Update custom implementations to handle enhanced validation
- Ensure webhook endpoints are compatible with new security checks

[2.4.0] - 2025-09-04
--------------------

Added
~~~~~

- 🆕 Official BotAPIAdapter for Telegram Bot API support
- ✅ Full async and sync compatibility across all adapters
- 🔒 Enhanced security with stricter input validation
- 🛡️ Webhook signature verification and timestamp validation
- 📚 Streamlined English-only documentation
- ⚡ Further complexity reduction while maintaining security

Changed
~~~~~~~

- Standardized adapters for both async and sync usage
- Unified payload handling across all adapters
- Improved error handling and performance across all modules

Breaking Changes
~~~~~~~~~~~~~~~~

- BotAPIAdapter introduces a slightly different async callback mechanism
- All adapters now require explicit setup for payment handlers
- PaymentStage validation stricter: title ≤ 32 chars, description ≤ 255 chars

Migration Guide
~~~~~~~~~~~~~~

- Use `BotAPIAdapter` for official Telegram Bot API integration
- Ensure explicit registration of payment handlers for all adapters
- Review updated PaymentStage validation rules

[2.3.0] - 2025-08-29
--------------------

Removed
~~~~~~~

- **BREAKING**: Complete removal of localization system
- Removed `neonpay/localization.py` module
- Removed `LocalizationManager` class
- Removed `Language` enum
- Removed all translation files
- Removed multilingual documentation
- Removed language parameter from all adapters
- Removed localization imports from base adapter and webhooks
- Removed localization dependencies from tests and examples

Changed
~~~~~~~

- **BREAKING**: All error messages and user-facing text now in English only
- Simplified `PaymentAdapter` base class (no language parameter)
- Simplified all framework adapters (Aiogram, Pyrogram, PTB, Telebot)
- Reduced library complexity by ~40% while maintaining all core functionality
- Updated examples to use static English text instead of localization system

Improved
~~~~~~~~

- Faster library initialization (no translation loading)
- Reduced memory footprint
- Cleaner, more focused codebase
- Better maintainability

Migration Guide
~~~~~~~~~~~~~~

- Remove any `language` parameters from adapter constructors
- Replace localized error handling with English-only messages
- Update custom implementations that relied on localization features

[2.2.0] - 2025-04-18
--------------------

Added
~~~~~

- 🔒 Enhanced security with comprehensive input validation
- 🛡️ Webhook signature verification and timestamp validation
- ✅ Improved async/sync handling for all adapters
- 🧪 Comprehensive security testing suite
- 📚 Complete security documentation and guides

Changed
~~~~~~~

- **BREAKING**: PaymentStage validation enforces stricter limits
- **BREAKING**: WebhookHandler now requires WebhookVerifier for security
- **BREAKING**: NeonPayCore constructor parameters changed

Improved
~~~~~~~~

- 🚀 Performance improvements and better error handling
- Better async/sync compatibility across all adapters

[2.1.0] - 2024-12-18
--------------------

Added
~~~~~

- Simplified architecture
- Cleaner API design

Removed
~~~~~~~

- Unnecessary complexity in core modules

[2.0.0] - 2024-12-17
--------------------

Added
~~~~~

- Major security improvements
- Enhanced validation system
- Webhook security features
- Comprehensive testing suite

Changed
~~~~~~~

- **BREAKING**: Enhanced security requirements
- Improved error handling

[1.0.0] - 2024-12-16
--------------------

Added
~~~~~

- Initial release with basic functionality
- Support for Aiogram, Pyrogram, python-telegram-bot, and pyTelegramBotAPI
- Basic payment processing
- Webhook handling
- Multi-stage payment support