Repository navigation
π v0.2.0 - Production-Ready Firebase Migrations
Major upgrade bringing production-ready features and MSR Core v0.8.4 integration.
β¨ What's New
π Migration Locking
- Distributed locking for Kubernetes, Docker, and multi-instance deployments
- Prevents concurrent migration race conditions
FirebaseLockingServicewith atomic Firebase transactions- CLI commands:
lock-status,force-release-lock - Comprehensive locking guide
π¦ MSR Core v0.8.4
- Upgraded from migration-script-runner v0.1.11 to @migration-script-runner/core v0.8.4
- Latest core features: handler access API, improved locking lifecycle
- Full compatibility with MSR ecosystem
π§ Type-Safe API
- Generic type parameters throughout codebase
- TypeScript best practices with
readonlymodifiers - Improved error types:
TypeError,ReferenceError,LockOperationError
π Documentation Portal
- Complete Jekyll site: https://migration-script-runner.github.io/msr-firebase
- 25 documentation files covering all features
- API reference, guides, and examples
- Migration guide for upgrading from v0.1.x
π§ͺ Quality & Testing
- 285 passing tests (171 unit + 114 integration)
- 100% test coverage (statements/functions/lines)
- SonarCloud Quality Gate: PASSED
- GitHub Actions CI/CD with Firebase Emulator
π Breaking Changes
Only ONE breaking change:
# Package name changed
npm uninstall msr-firebase
npm install @migration-script-runner/firebase@^0.2.0Then find-and-replace imports:
// OLD
import { FirebaseRunner } from 'msr-firebase';
// NEW
import { FirebaseRunner } from '@migration-script-runner/firebase';Migration time: 5-15 minutes
See the Migration Guide for detailed instructions.
π¦ Installation
npm install @migration-script-runner/firebase@^0.2.0π Documentation
- π Documentation Home
- π Getting Started
- π API Reference
- π Migration Locking Guide
- β¬οΈ Migration Guide v0.1.x β v0.2.0
π Statistics
- 52 issues closed across 3 epics
- 25 documentation files created/updated
- 285 passing tests with 100% coverage
- Zero critical bugs or technical debt
- Production-ready distributed locking
π Credits
Developed and tested by @vlavrynovych
Part of the Migration Script Runner ecosystem
Proudly made in Ukraine πΊπ¦
π Full Changelog
Milestone: v0.2.0
Epics:
Key Issues: