BREAKING CHANGE(core): Rebrand XInvoice to EInvoice: update package name, class names, imports, and documentation

changelog.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 2025-05-24 - 5.0.0 - BREAKING CHANGE(core)
+Rebrand XInvoice to EInvoice: update package name, class names, imports, and documentation
+
+- Renamed package from '@fin.cx/xinvoice' to '@fin.cx/einvoice' in package.json, repository URLs, and readme
+- Renamed main class from XInvoice to EInvoice and updated type interfaces (XInvoiceOptions to EInvoiceOptions)
+- Updated all import paths and references throughout the codebase including tests, factories, and plugins
+- Added a detailed migration guide in MIGRATION.md and updated changelog with breaking changes
+- Improved error handling by introducing specialized error classes and recovery utilities
+- Ensured all tests and validation suites now reference EInvoice instead of XInvoice
+
+## [5.0.0] - Unreleased
+
+### BREAKING CHANGES
+- Renamed package from `@fin.cx/xinvoice` to `@fin.cx/einvoice`
+- Renamed main class from `XInvoice` to `EInvoice`
+- Renamed `XInvoiceOptions` interface to `EInvoiceOptions`
+- Renamed main file from `classes.xinvoice.ts` to `einvoice.ts`
+- Updated all exports and imports to use new naming
+
+### Migration Guide
+To migrate from v4.x to v5.x:
+1. Update package dependency: `@fin.cx/xinvoice` → `@fin.cx/einvoice`
+2. Update imports: `import { XInvoice } from '@fin.cx/xinvoice'` → `import { EInvoice } from '@fin.cx/einvoice'`
+3. Update class usage: `new XInvoice()` → `new EInvoice()`
+4. Update type references: `XInvoiceOptions` → `EInvoiceOptions`
+
 ## 2025-05-24 - 4.3.0 - feat(readme.plan)
 Add detailed EInvoice Improvement Plan outlining project rebranding, performance optimizations, enhanced error handling, comprehensive test suite, format conversion, and future enterprise features.