migration-script-runner / msr-core / fec3ca21-f623-48f9-8f17-586d21fcb45f

100%

Build Type

push

circleci

Committed by Vova Lavrynovych

Commit Message

#67: Add version control support with migrateTo() and downTo()

Implement controlled upgrade/downgrade to specific database versions for staged deployments, testing, and rollback scenarios.

New Features:
- migrateTo(targetVersion): Execute migrations up to specific version
- downTo(targetVersion): Roll back migrations to specific version
- Immediate save pattern: Migration state saved after each operation
- Version selector methods: getPendingUpTo(), getMigratedDownTo(), getMigratedInRange()
- ISchemaVersion.remove(): Remove migration records during rollback

Key Implementation Details:
- Added validation and hooks to all version control methods
- Fixed critical bug: schema version table now initialized BEFORE scan()
- scan() needs to query schema_version table, must be initialized first
- Proper error handling with rollback support in migrateTo()
- downTo() validates migrations and calls down() methods in reverse order

Breaking Changes: None - purely additive features

Testing:
- Added 31 new tests for version control functionality
- Achieved 100% test coverage (989/989 statements, 486/486 branches)
- All 525 tests passing

Documentation:
- Added comprehensive API reference for new methods
- Created version-control.md guide with real-world use cases
- Updated getting-started.md with version control examples
- Enhanced architecture.md with selector method details

Use Cases:
- Staged production deployments
- Emergency rollback to known-good versions
- Testing specific migration versions
- Blue-green deployments with version parity

Run Details

486 of 486 branches covered (100.0%)

Branch coverage included in aggregate %.

89 of 89 new or added lines in 3 files covered. (100.0%)

931 of 931 relevant lines covered (100.0%)

585.47 hits per line