just_firebase 0.1.0
just_firebase: ^0.1.0 copied to clipboard
Firebase integration for the just ecosystem — Auth, Firestore, Analytics, and Remote Config with reactive signals, secure storage, and offline caching.
0.1.0 #
Initial release.
Features #
FirebaseManager— singleton coordinator that initialises all modules in one call; exposesisInitializedguard and a top-leveldispose().JustFirebaseConfig— immutable configuration for every sub-manager (cache TTL, rate-limit windows, minimum fetch intervals, per-module enable flags).- Auth (
JustFirebaseAuth)- Email/password sign-up and sign-in.
- Google Sign-In and Play Games sign-in (Android).
- Anonymous sign-in.
- Password reset email.
- ID-token retrieval with optional force-refresh.
- Account deletion.
- Client-side rate limiting (configurable retry count and sliding window).
- Secure session persistence via
just_storage(AES-256-GCM). - Reactive
Signal<AuthState>andSignal<JustFirebaseUser?>viajust_signals.
- Firestore (
JustFirestore)- Offline-first document reads with configurable TTL cache (backed by
just_database). getDocument/watchDocument/documentSignalfor single documents.getCollection/watchCollectionfor collections.- Fluent query builder:
JustFirestoreQuerywithJustFirestoreFilter,JustFirestoreOrderBy, and pagination cursor support. setDocument,updateDocument,deleteDocumentwrites.- Atomic
JustFirestoreBatchfor grouped writes.
- Offline-first document reads with configurable TTL cache (backed by
- Remote Config (
JustRemoteConfig)- In-app defaults via
setDefaults. fetchAndActivatewith configurable minimum fetch interval.- Typed accessors:
getString,getBool,getInt,getDouble. - Reactive
Signal<T>watcher viawatch<T>. configSignalexposing all active values as aMap.
- In-app defaults via
- Analytics (
JustFirebaseAnalytics)- Platform-safe wrapper (all methods are no-ops on Windows, Linux, and macOS).
logEvent,setUserId,setUserProperty,logScreenView,setEnabled.- Convenience helpers:
logLogin,logSignUp,logLevelStart,logLevelComplete,logEarnVirtualCurrency.
- Error hierarchy — sealed
JustFirebaseErrorwith typed subclassesAuthError,FirestoreError,RemoteConfigError,NetworkError, andUnknownFirebaseErrorfor exhaustive error handling.