@umituz/react-native-firebase 1.3.0 → 1.4.0

package/LICENSE

@@ -20,3 +20,14 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
+
+
+
+
+
+
+
+
+
+
+

package/README.md

@@ -72,7 +72,9 @@ if (!app) {
 #### Direct Access
 
 ```typescript
-import { getFirebaseApp, getFirebaseAuth, getFirestore } from '@umituz/react-native-firebase';
+import { getFirebaseApp } from '@umituz/react-native-firebase';
+import { getFirebaseAuth } from '@umituz/react-native-firebase-auth';
+import { getFirestore } from '@umituz/react-native-firestore';
 
 // Get instances
 const app = getFirebaseApp();
@@ -134,9 +136,7 @@ if (isFirebaseInitialized()) {
 - **Single Responsibility**: Each class has one clear purpose
   - `FirebaseConfigValidator`: Only validates configuration
   - `FirebaseAppInitializer`: Only initializes Firebase App
-  - `FirebaseAuthInitializer`: Only initializes Auth
-  - `FirebaseFirestoreInitializer`: Only initializes Firestore
-  - `FirebaseClient`: Only orchestrates initialization
+  - `FirebaseClient`: Only orchestrates Firebase App initialization
 
 - **Open/Closed**: Extensible through configuration, closed for modification
 
@@ -157,28 +157,30 @@ if (isFirebaseInitialized()) {
 
 ### Functions
 
-- `initializeFirebase(config)`: Initialize Firebase client with configuration
-- `getFirebaseApp()`: Get Firebase app instance (throws if not initialized)
-- `getFirebaseAuth()`: Get Firebase Auth instance (throws if not initialized)
-- `getFirestore()`: Get Firestore instance (throws if not initialized)
-- `isFirebaseInitialized()`: Check if client is initialized
+- `initializeFirebase(config)`: Initialize Firebase App with configuration
+- `getFirebaseApp()`: Get Firebase App instance (throws if not initialized)
+- `isFirebaseInitialized()`: Check if Firebase App is initialized
 - `getFirebaseInitializationError()`: Get initialization error if any
 - `resetFirebaseClient()`: Reset client instance (useful for testing)
 
 ### Types
 
 - `FirebaseConfig`: Configuration interface
-- `FirebaseApp`: Firebase app type
-- `Auth`: Firebase Auth type
-- `Firestore`: Firestore type
+- `FirebaseApp`: Firebase App type
 
 ### Errors
 
 - `FirebaseError`: Base error class
 - `FirebaseInitializationError`: Initialization errors
 - `FirebaseConfigurationError`: Configuration errors
-- `FirebaseAuthError`: Authentication errors
-- `FirebaseFirestoreError`: Firestore errors
+
+### Related Packages
+
+For other Firebase services, use dedicated packages:
+- `@umituz/react-native-firebase-auth` - Firebase Authentication
+- `@umituz/react-native-firebase-analytics` - Firebase Analytics
+- `@umituz/react-native-firebase-crashlytics` - Firebase Crashlytics
+- `@umituz/react-native-firestore` - Firestore initialization and utilities
 
 ## Integration with Expo
 
@@ -213,3 +215,7 @@ module.exports = () => {
 
 MIT
 
+
+
+
+

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "1.3.0",
-  "description": "Domain-Driven Design Firebase client for React Native apps with type-safe operations and singleton pattern",
+  "version": "1.4.0",
+  "description": "Firebase core package for React Native apps - Centralized initialization for all Firebase services (App, Auth, Analytics, Crashlytics). Use dedicated packages for service-specific operations.",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "scripts": {
@@ -14,30 +14,26 @@
   "keywords": [
     "react-native",
     "firebase",
+    "firebase-core",
+    "firestore",
     "ddd",
-    "domain-driven-design",
-    "type-safe",
-    "solid",
-    "dry",
-    "kiss",
-    "singleton"
+    "domain-driven-design"
   ],
   "author": "Ümit UZ <umit@umituz.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/umituz/react-native-firebase.git"
+    "url": "https://github.com/umituz/react-native-firebase"
   },
   "peerDependencies": {
     "firebase": ">=11.0.0",
     "react": ">=18.2.0",
-    "react-native": ">=0.74.0",
-    "@react-native-async-storage/async-storage": ">=1.21.0"
+    "react-native": ">=0.74.0"
   },
   "devDependencies": {
-    "firebase": "^11.10.0",
     "@types/react": "^18.2.45",
     "@types/react-native": "^0.73.0",
+    "firebase": "^11.0.0",
     "react": "^18.2.0",
     "react-native": "^0.74.0",
     "typescript": "^5.3.3"

package/src/application/ports/IFirebaseClient.ts

@@ -6,31 +6,22 @@
  */
 
 import type { FirebaseApp } from 'firebase/app';
-import type { Auth } from 'firebase/auth';
-import type { Firestore } from 'firebase/firestore';
 
 /**
  * Firebase Client Interface
  * Defines the contract for Firebase client operations
+ * 
+ * Note: 
+ * - Firebase Auth is now handled by @umituz/react-native-firebase-auth
+ * - Firestore is now handled by @umituz/react-native-firestore
  */
 export interface IFirebaseClient {
   /**
    * Get the Firebase app instance
-   * @throws {FirebaseInitializationError} If client is not initialized
+   * Returns null if config is not available (offline mode)
+   * @returns Firebase app instance or null if not initialized
    */
-  getApp(): FirebaseApp;
-
-  /**
-   * Get the Firebase Auth instance
-   * @throws {FirebaseInitializationError} If client is not initialized
-   */
-  getAuth(): Auth;
-
-  /**
-   * Get the Firestore instance
-   * @throws {FirebaseInitializationError} If client is not initialized
-   */
-  getFirestore(): Firestore;
+  getApp(): FirebaseApp | null;
 
   /**
    * Check if client is initialized
@@ -49,3 +40,7 @@ export interface IFirebaseClient {
   reset(): void;
 }
 
+
+
+
+

package/src/domain/errors/FirebaseError.ts

@@ -43,51 +43,14 @@ export class FirebaseConfigurationError extends FirebaseError {
   }
 }
 
-/**
- * Analytics Error
- * Thrown when analytics operations fail
- */
-export class FirebaseAnalyticsError extends FirebaseError {
-  constructor(message: string, originalError?: unknown) {
-    super(message, 'ANALYTICS_ERROR', originalError);
-    this.name = 'FirebaseAnalyticsError';
-    Object.setPrototypeOf(this, FirebaseAnalyticsError.prototype);
-  }
-}
+// Note: FirebaseAnalyticsError, FirebaseCrashlyticsError, FirebaseAuthError, and FirebaseFirestoreError
+// have been moved to their respective packages:
+// - @umituz/react-native-firebase-analytics
+// - @umituz/react-native-firebase-crashlytics
+// - @umituz/react-native-firebase-auth
+// - @umituz/react-native-firestore
+
 
-/**
- * Crashlytics Error
- * Thrown when crashlytics operations fail
- */
-export class FirebaseCrashlyticsError extends FirebaseError {
-  constructor(message: string, originalError?: unknown) {
-    super(message, 'CRASHLYTICS_ERROR', originalError);
-    this.name = 'FirebaseCrashlyticsError';
-    Object.setPrototypeOf(this, FirebaseCrashlyticsError.prototype);
-  }
-}
 
-/**
- * Auth Error
- * Thrown when authentication operations fail
- */
-export class FirebaseAuthError extends FirebaseError {
-  constructor(message: string, originalError?: unknown) {
-    super(message, 'AUTH_ERROR', originalError);
-    this.name = 'FirebaseAuthError';
-    Object.setPrototypeOf(this, FirebaseAuthError.prototype);
-  }
-}
 
-/**
- * Firestore Error
- * Thrown when Firestore operations fail
- */
-export class FirebaseFirestoreError extends FirebaseError {
-  constructor(message: string, originalError?: unknown) {
-    super(message, 'FIRESTORE_ERROR', originalError);
-    this.name = 'FirebaseFirestoreError';
-    Object.setPrototypeOf(this, FirebaseFirestoreError.prototype);
-  }
-}
 

package/src/domain/value-objects/FirebaseConfig.ts

@@ -38,16 +38,6 @@ export interface FirebaseConfig {
    * Firebase App ID
    */
   appId?: string;
-
-  /**
-   * Optional: Custom storage adapter for Auth persistence
-   * If not provided, AsyncStorage will be used for React Native
-   */
-  authStorage?: {
-    getItem: (key: string) => Promise<string | null>;
-    setItem: (key: string, value: string) => Promise<void>;
-    removeItem: (key: string) => Promise<void>;
-  };
 }
 
 // Validation moved to FirebaseConfigValidator class (SOLID: Single Responsibility)

package/src/index.ts

@@ -1,19 +1,22 @@
 /**
- * React Native Firebase - Public API
+ * React Native Firebase - Minimal Core Package
  *
  * Domain-Driven Design (DDD) Architecture
  *
- * This is the SINGLE SOURCE OF TRUTH for all Firebase operations.
- * ALL imports from the Firebase package MUST go through this file.
+ * This package provides ONLY Firebase App initialization.
+ * For other Firebase services, use dedicated packages:
+ * - @umituz/react-native-firebase-auth - Firebase Authentication
+ * - @umituz/react-native-firebase-analytics - Firebase Analytics
+ * - @umituz/react-native-firebase-crashlytics - Firebase Crashlytics
+ * - @umituz/react-native-firestore - Firestore initialization and utilities
  *
  * Architecture:
  * - domain: Entities, value objects, errors (business logic)
  * - application: Ports (interfaces)
- * - infrastructure: Firebase client implementation + services
- * - presentation: Hooks, decorators (React integration)
+ * - infrastructure: Firebase client implementation
  *
  * Usage:
- *   import { initializeFirebase, firebaseAnalyticsService, TrackEvent } from '@umituz/react-native-firebase';
+ *   import { initializeFirebase, getFirebaseApp } from '@umituz/react-native-firebase';
  */
 
 // =============================================================================
@@ -24,10 +27,6 @@ export {
   FirebaseError,
   FirebaseInitializationError,
   FirebaseConfigurationError,
-  FirebaseAnalyticsError,
-  FirebaseCrashlyticsError,
-  FirebaseAuthError,
-  FirebaseFirestoreError,
 } from './domain/errors/FirebaseError';
 
 export type { FirebaseConfig } from './domain/value-objects/FirebaseConfig';
@@ -45,8 +44,8 @@ export type { IFirebaseClient } from './application/ports/IFirebaseClient';
 export {
   initializeFirebase,
   getFirebaseApp,
-  getFirebaseAuth,
-  getFirestore,
+  autoInitializeFirebase,
+  initializeAllFirebaseServices,
   isFirebaseInitialized,
   getFirebaseInitializationError,
   resetFirebaseClient,
@@ -55,45 +54,5 @@ export {
 
 export type {
   FirebaseApp,
-  Auth,
-  Firestore,
 } from './infrastructure/config/FirebaseClient';
 
-// =============================================================================
-// SERVICES - Analytics, Crashlytics, Performance
-// =============================================================================
-
-export {
-  firebaseAnalyticsService,
-} from './infrastructure/services/analytics/FirebaseAnalyticsService';
-export type { IAnalyticsService } from './infrastructure/services/analytics/FirebaseAnalyticsService';
-
-export {
-  firebaseCrashlyticsService,
-} from './infrastructure/services/crashlytics/FirebaseCrashlyticsService';
-export type { ICrashlyticsService } from './infrastructure/services/crashlytics/FirebaseCrashlyticsService';
-
-export {
-  performanceTracker,
-  PerformanceTracker,
-} from './infrastructure/services/performance/PerformanceTracker';
-
-// =============================================================================
-// PRESENTATION LAYER - Decorators
-// =============================================================================
-
-export {
-  TrackEvent,
-  trackEvent,
-} from './presentation/decorators/TrackingDecorator';
-
-export {
-  TrackErrors,
-  trackErrors,
-} from './presentation/decorators/ErrorTrackingDecorator';
-
-export {
-  TrackPerformance,
-  TrackOperation,
-} from './presentation/decorators/PerformanceDecorator';
-

package/src/infrastructure/config/FirebaseClient.ts

@@ -14,15 +14,12 @@
  */
 
 import type { FirebaseApp } from 'firebase/app';
-import type { Auth } from 'firebase/auth';
-import type { Firestore } from 'firebase/firestore';
 import type { FirebaseConfig } from '../../domain/value-objects/FirebaseConfig';
 import { FirebaseInitializationError } from '../../domain/errors/FirebaseError';
 import type { IFirebaseClient } from '../../application/ports/IFirebaseClient';
 import { FirebaseConfigValidator } from './validators/FirebaseConfigValidator';
 import { FirebaseAppInitializer } from './initializers/FirebaseAppInitializer';
-import { FirebaseAuthInitializer } from './initializers/FirebaseAuthInitializer';
-import { FirebaseFirestoreInitializer } from './initializers/FirebaseFirestoreInitializer';
+import { loadFirebaseConfig } from './FirebaseConfigLoader';
 
 /**
  * Firebase Client Singleton
@@ -31,8 +28,6 @@ import { FirebaseFirestoreInitializer } from './initializers/FirebaseFirestoreIn
 class FirebaseClientSingleton implements IFirebaseClient {
   private static instance: FirebaseClientSingleton | null = null;
   private app: FirebaseApp | null = null;
-  private auth: Auth | null = null;
-  private db: Firestore | null = null;
   private initializationError: string | null = null;
 
   private constructor() {
@@ -74,12 +69,6 @@ class FirebaseClientSingleton implements IFirebaseClient {
       // Initialize Firebase App
       this.app = FirebaseAppInitializer.initialize(config);
 
-      // Initialize Auth
-      this.auth = FirebaseAuthInitializer.initialize(this.app, config);
-
-      // Initialize Firestore
-      this.db = FirebaseFirestoreInitializer.initialize(this.app);
-
       return this.app;
     } catch (error) {
       this.initializationError =
@@ -92,45 +81,23 @@ class FirebaseClientSingleton implements IFirebaseClient {
 
   /**
    * Get the Firebase app instance
-   * @throws {FirebaseInitializationError} If client is not initialized
+   * Auto-initializes from Constants/environment if not already initialized
+   * Returns null if config is not available (offline mode)
+   * @returns Firebase app instance or null if not initialized
    */
-  getApp(): FirebaseApp {
-    if (!this.app) {
-      const errorMsg =
-        this.initializationError ||
-        'Firebase client not initialized. Call initialize() first with configuration.';
-      throw new FirebaseInitializationError(errorMsg);
+  getApp(): FirebaseApp | null {
+    // Auto-initialize if not already initialized
+    if (!this.app && !this.initializationError) {
+      const autoConfig = loadFirebaseConfig();
+      if (autoConfig) {
+        this.initialize(autoConfig);
+      }
     }
-    return this.app;
-  }
 
-  /**
-   * Get the Firebase Auth instance
-   * @throws {FirebaseInitializationError} If client is not initialized
-   */
-  getAuth(): Auth {
-    if (!this.auth) {
-      const errorMsg =
-        this.initializationError ||
-        'Firebase client not initialized. Call initialize() first with configuration.';
-      throw new FirebaseInitializationError(errorMsg);
-    }
-    return this.auth;
+    // Return null if not initialized (offline mode - no error)
+    return this.app || null;
   }
 
-  /**
-   * Get the Firestore instance
-   * @throws {FirebaseInitializationError} If client is not initialized
-   */
-  getFirestore(): Firestore {
-    if (!this.db) {
-      const errorMsg =
-        this.initializationError ||
-        'Firebase client not initialized. Call initialize() first with configuration.';
-      throw new FirebaseInitializationError(errorMsg);
-    }
-    return this.db;
-  }
 
   /**
    * Check if client is initialized
@@ -152,8 +119,6 @@ class FirebaseClientSingleton implements IFirebaseClient {
    */
   reset(): void {
     this.app = null;
-    this.auth = null;
-    this.db = null;
     this.initializationError = null;
   }
 }
@@ -191,26 +156,115 @@ export function initializeFirebase(
 
 /**
  * Get Firebase app instance
- * @throws {FirebaseInitializationError} If client is not initialized
+ * Auto-initializes from Constants/environment if not already initialized
+ * Returns null if config is not available (offline mode - no error)
+ * @returns Firebase app instance or null if not initialized
  */
-export function getFirebaseApp(): FirebaseApp {
+export function getFirebaseApp(): FirebaseApp | null {
   return firebaseClient.getApp();
 }
 
 /**
- * Get Firebase Auth instance
- * @throws {FirebaseInitializationError} If client is not initialized
+ * Auto-initialize Firebase from Constants/environment
+ * Called automatically when getFirebaseApp() is first accessed
+ * Can be called manually to initialize early
+ * @returns Firebase app instance or null if initialization fails
  */
-export function getFirebaseAuth(): Auth {
-  return firebaseClient.getAuth();
+export function autoInitializeFirebase(): FirebaseApp | null {
+  const config = loadFirebaseConfig();
+  if (config) {
+    return initializeFirebase(config);
+  }
+  return null;
 }
 
 /**
- * Get Firestore instance
- * @throws {FirebaseInitializationError} If client is not initialized
+ * Initialize all Firebase services (App, Auth, Analytics, Crashlytics)
+ * This is the main entry point for applications - call this once at app startup
+ * All services will be initialized automatically if Firebase App is available
+ * 
+ * @param config - Optional Firebase configuration (if not provided, will auto-load from Constants/env)
+ * @returns Object with initialization results for each service
+ * 
+ * @example
+ * ```typescript
+ * import { initializeAllFirebaseServices } from '@umituz/react-native-firebase';
+ * 
+ * // Auto-initialize from Constants/env
+ * const result = await initializeAllFirebaseServices();
+ * 
+ * // Or provide config explicitly
+ * const result = await initializeAllFirebaseServices({
+ *   apiKey: 'your-api-key',
+ *   projectId: 'your-project-id',
+ *   // ...
+ * });
+ * ```
  */
-export function getFirestore(): Firestore {
-  return firebaseClient.getFirestore();
+export async function initializeAllFirebaseServices(
+  config?: FirebaseConfig
+): Promise<{
+  app: FirebaseApp | null;
+  auth: any | null;
+  analytics: any | null;
+  crashlytics: any | null;
+}> {
+  // 1. Initialize Firebase App
+  let app: FirebaseApp | null = null;
+  if (config) {
+    app = initializeFirebase(config);
+  } else {
+    app = autoInitializeFirebase();
+  }
+
+  if (!app) {
+    // Firebase App not available - return null for all services
+    return {
+      app: null,
+      auth: null,
+      analytics: null,
+      crashlytics: null,
+    };
+  }
+
+  // 2. Initialize Firebase Auth (if package is available)
+  let auth: any | null = null;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { initializeFirebaseAuth } = require('@umituz/react-native-firebase-auth');
+    auth = initializeFirebaseAuth();
+  } catch {
+    // @umituz/react-native-firebase-auth not available
+  }
+
+  // 3. Initialize Firebase Analytics (if package is available)
+  let analytics: any | null = null;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { firebaseAnalyticsService } = require('@umituz/react-native-firebase-analytics');
+    await firebaseAnalyticsService.init();
+    analytics = firebaseAnalyticsService;
+  } catch {
+    // @umituz/react-native-firebase-analytics not available
+  }
+
+  // 4. Initialize Firebase Crashlytics (if package is available)
+  let crashlytics: any | null = null;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { firebaseCrashlyticsService } = require('@umituz/react-native-firebase-crashlytics');
+    await firebaseCrashlyticsService.init();
+    crashlytics = firebaseCrashlyticsService;
+  } catch {
+    // @umituz/react-native-firebase-crashlytics not available
+  }
+
+  return {
+    app,
+    auth,
+    analytics,
+    crashlytics,
+  };
 }
 
 /**
@@ -237,6 +291,4 @@ export function resetFirebaseClient(): void {
 
 // Export types
 export type { FirebaseApp } from 'firebase/app';
-export type { Auth } from 'firebase/auth';
-export type { Firestore } from 'firebase/firestore';
 export type { FirebaseConfig } from '../../domain/value-objects/FirebaseConfig';

package/src/infrastructure/config/FirebaseConfigLoader.ts

@@ -0,0 +1,76 @@
+/**
+ * Firebase Config Loader
+ *
+ * Automatically loads Firebase configuration from:
+ * 1. expo-constants (Constants.expoConfig?.extra)
+ * 2. Environment variables (process.env)
+ *
+ * This allows zero-configuration Firebase initialization.
+ */
+
+import type { FirebaseConfig } from '../../domain/value-objects/FirebaseConfig';
+
+/**
+ * Load Firebase configuration from Constants and environment variables
+ * Returns null if no valid configuration is found
+ */
+export function loadFirebaseConfig(): FirebaseConfig | null {
+  let Constants: any;
+  
+  // Try to load expo-constants (optional dependency)
+  try {
+    Constants = require('expo-constants');
+  } catch {
+    // expo-constants not available, skip
+  }
+
+  // Try both Constants.expoConfig and Constants.default.expoConfig
+  const expoConfig = Constants?.expoConfig || Constants?.default?.expoConfig;
+  const extra = expoConfig?.extra;
+
+  const config: Partial<FirebaseConfig> = {
+    apiKey:
+      extra?.firebaseApiKey ||
+      process.env.EXPO_PUBLIC_FIREBASE_API_KEY ||
+      process.env.FIREBASE_API_KEY ||
+      '',
+    authDomain:
+      extra?.firebaseAuthDomain ||
+      process.env.EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN ||
+      process.env.FIREBASE_AUTH_DOMAIN ||
+      '',
+    projectId:
+      extra?.firebaseProjectId ||
+      process.env.EXPO_PUBLIC_FIREBASE_PROJECT_ID ||
+      process.env.FIREBASE_PROJECT_ID ||
+      '',
+    storageBucket:
+      extra?.firebaseStorageBucket ||
+      process.env.EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET ||
+      process.env.FIREBASE_STORAGE_BUCKET ||
+      '',
+    messagingSenderId:
+      extra?.firebaseMessagingSenderId ||
+      process.env.EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID ||
+      process.env.FIREBASE_MESSAGING_SENDER_ID ||
+      '',
+    appId:
+      extra?.firebaseAppId ||
+      process.env.EXPO_PUBLIC_FIREBASE_APP_ID ||
+      process.env.FIREBASE_APP_ID ||
+      '',
+  };
+
+  // Only return config if required fields are present and not empty
+  if (
+    config.apiKey &&
+    config.projectId &&
+    config.apiKey.trim() !== '' &&
+    config.projectId.trim() !== ''
+  ) {
+    return config as FirebaseConfig;
+  }
+
+  return null;
+}
+

package/src/infrastructure/config/initializers/FirebaseAppInitializer.ts

@@ -44,3 +44,14 @@ export class FirebaseAppInitializer {
   }
 }
 
+
+
+
+
+
+
+
+
+
+
+