@umituz/react-native-firebase 1.4.0 → 1.5.0

package/lib/application/ports/IFirebaseClient.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Firebase Client Port (Interface)
+ *
+ * Domain-Driven Design: Application layer port for Firebase client
+ * Defines the contract for Firebase client operations
+ */
+export type FirebaseApp = any;
+/**
+ * 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
+     * Returns null if config is not available (offline mode)
+     * @returns Firebase app instance or null if not initialized
+     */
+    getApp(): FirebaseApp | null;
+    /**
+     * Check if client is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get initialization error if any
+     */
+    getInitializationError(): string | null;
+    /**
+     * Reset the client instance
+     * Useful for testing
+     */
+    reset(): void;
+}
+//# sourceMappingURL=IFirebaseClient.d.ts.map

package/lib/application/ports/IFirebaseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFirebaseClient.d.ts","sourceRoot":"","sources":["../../../src/application/ports/IFirebaseClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,IAAI,WAAW,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC;IAEzB;;OAEG;IACH,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAAC;IAExC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/lib/application/ports/IFirebaseClient.js

@@ -0,0 +1,8 @@
+/**
+ * Firebase Client Port (Interface)
+ *
+ * Domain-Driven Design: Application layer port for Firebase client
+ * Defines the contract for Firebase client operations
+ */
+export {};
+//# sourceMappingURL=IFirebaseClient.js.map

package/lib/application/ports/IFirebaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFirebaseClient.js","sourceRoot":"","sources":["../../../src/application/ports/IFirebaseClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/domain/errors/FirebaseError.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Firebase Domain Errors
+ *
+ * Domain-Driven Design: Error types for Firebase operations
+ */
+/**
+ * Base Firebase Error
+ */
+export declare class FirebaseError extends Error {
+    readonly code?: string | undefined;
+    readonly originalError?: unknown | undefined;
+    constructor(message: string, code?: string | undefined, originalError?: unknown | undefined);
+}
+/**
+ * Initialization Error
+ * Thrown when Firebase client fails to initialize
+ */
+export declare class FirebaseInitializationError extends FirebaseError {
+    constructor(message: string, originalError?: unknown);
+}
+/**
+ * Configuration Error
+ * Thrown when required configuration is missing or invalid
+ */
+export declare class FirebaseConfigurationError extends FirebaseError {
+    constructor(message: string, originalError?: unknown);
+}
+//# sourceMappingURL=FirebaseError.d.ts.map

package/lib/domain/errors/FirebaseError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirebaseError.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/FirebaseError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,CAAC,EAAE,MAAM;aACb,aAAa,CAAC,EAAE,OAAO;gBAFvC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,aAAa,CAAC,EAAE,OAAO,YAAA;CAM1C;AAED;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO;CAKrD;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,aAAa;gBAC/C,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO;CAKrD"}

package/lib/domain/errors/FirebaseError.js

@@ -0,0 +1,46 @@
+/**
+ * Firebase Domain Errors
+ *
+ * Domain-Driven Design: Error types for Firebase operations
+ */
+/**
+ * Base Firebase Error
+ */
+export class FirebaseError extends Error {
+    constructor(message, code, originalError) {
+        super(message);
+        this.code = code;
+        this.originalError = originalError;
+        this.name = 'FirebaseError';
+        Object.setPrototypeOf(this, FirebaseError.prototype);
+    }
+}
+/**
+ * Initialization Error
+ * Thrown when Firebase client fails to initialize
+ */
+export class FirebaseInitializationError extends FirebaseError {
+    constructor(message, originalError) {
+        super(message, 'INITIALIZATION_ERROR', originalError);
+        this.name = 'FirebaseInitializationError';
+        Object.setPrototypeOf(this, FirebaseInitializationError.prototype);
+    }
+}
+/**
+ * Configuration Error
+ * Thrown when required configuration is missing or invalid
+ */
+export class FirebaseConfigurationError extends FirebaseError {
+    constructor(message, originalError) {
+        super(message, 'CONFIGURATION_ERROR', originalError);
+        this.name = 'FirebaseConfigurationError';
+        Object.setPrototypeOf(this, FirebaseConfigurationError.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
+//# sourceMappingURL=FirebaseError.js.map

package/lib/domain/errors/FirebaseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirebaseError.js","sourceRoot":"","sources":["../../../src/domain/errors/FirebaseError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YACE,OAAe,EACC,IAAa,EACb,aAAuB;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAS;QACb,kBAAa,GAAb,aAAa,CAAU;QAGvC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,2BAA4B,SAAQ,aAAa;IAC5D,YAAY,OAAe,EAAE,aAAuB;QAClD,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAY,OAAe,EAAE,aAAuB;QAClD,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AAED,wGAAwG;AACxG,gDAAgD;AAChD,4CAA4C;AAC5C,8CAA8C;AAC9C,uCAAuC;AACvC,mCAAmC"}

package/lib/domain/value-objects/FirebaseConfig.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Firebase Configuration Value Object
+ *
+ * Domain-Driven Design: Value object for Firebase configuration
+ */
+/**
+ * Firebase Configuration
+ * Required configuration for initializing Firebase client
+ */
+export interface FirebaseConfig {
+    /**
+     * Firebase API Key
+     */
+    apiKey: string;
+    /**
+     * Firebase Auth Domain
+     */
+    authDomain: string;
+    /**
+     * Firebase Project ID
+     */
+    projectId: string;
+    /**
+     * Firebase Storage Bucket
+     */
+    storageBucket?: string;
+    /**
+     * Firebase Messaging Sender ID
+     */
+    messagingSenderId?: string;
+    /**
+     * Firebase App ID
+     */
+    appId?: string;
+}
+//# sourceMappingURL=FirebaseConfig.d.ts.map

package/lib/domain/value-objects/FirebaseConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirebaseConfig.d.ts","sourceRoot":"","sources":["../../../src/domain/value-objects/FirebaseConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/lib/domain/value-objects/FirebaseConfig.js

@@ -0,0 +1,8 @@
+/**
+ * Firebase Configuration Value Object
+ *
+ * Domain-Driven Design: Value object for Firebase configuration
+ */
+export {};
+// Validation moved to FirebaseConfigValidator class (SOLID: Single Responsibility)
+//# sourceMappingURL=FirebaseConfig.js.map

package/lib/domain/value-objects/FirebaseConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirebaseConfig.js","sourceRoot":"","sources":["../../../src/domain/value-objects/FirebaseConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;AAsCH,mFAAmF"}

package/lib/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * React Native Firebase - Minimal Core Package
+ *
+ * Domain-Driven Design (DDD) Architecture
+ *
+ * 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
+ *
+ * Usage:
+ *   import { initializeFirebase, getFirebaseApp } from '@umituz/react-native-firebase';
+ */
+export { FirebaseError, FirebaseInitializationError, FirebaseConfigurationError, } from './domain/errors/FirebaseError';
+export type { FirebaseConfig } from './domain/value-objects/FirebaseConfig';
+export type { IFirebaseClient } from './application/ports/IFirebaseClient';
+export { initializeFirebase, getFirebaseApp, autoInitializeFirebase, initializeAllFirebaseServices, isFirebaseInitialized, getFirebaseInitializationError, resetFirebaseClient, firebaseClient, } from './infrastructure/config/FirebaseClient';
+export type { FirebaseApp, } from './infrastructure/config/FirebaseClient';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAM5E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAM3E,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,cAAc,GACf,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EACV,WAAW,GACZ,MAAM,wCAAwC,CAAC"}

package/lib/index.js

@@ -0,0 +1,29 @@
+/**
+ * React Native Firebase - Minimal Core Package
+ *
+ * Domain-Driven Design (DDD) Architecture
+ *
+ * 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
+ *
+ * Usage:
+ *   import { initializeFirebase, getFirebaseApp } from '@umituz/react-native-firebase';
+ */
+// =============================================================================
+// DOMAIN LAYER - Business Logic
+// =============================================================================
+export { FirebaseError, FirebaseInitializationError, FirebaseConfigurationError, } from './domain/errors/FirebaseError';
+// =============================================================================
+// INFRASTRUCTURE LAYER - Implementation
+// =============================================================================
+export { initializeFirebase, getFirebaseApp, autoInitializeFirebase, initializeAllFirebaseServices, isFirebaseInitialized, getFirebaseInitializationError, resetFirebaseClient, firebaseClient, } from './infrastructure/config/FirebaseClient';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,+BAA+B,CAAC;AAUvC,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,8BAA8B,EAC9B,mBAAmB,EACnB,cAAc,GACf,MAAM,wCAAwC,CAAC"}

package/lib/infrastructure/config/FirebaseClient.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Firebase Client - Infrastructure Layer
+ *
+ * Domain-Driven Design: Infrastructure implementation of Firebase client
+ * Singleton pattern for managing Firebase client instance
+ *
+ * IMPORTANT: This package does NOT read from .env files.
+ * Configuration must be provided by the application.
+ *
+ * SOLID Principles:
+ * - Single Responsibility: Only orchestrates initialization, delegates to specialized classes
+ * - Open/Closed: Extensible through configuration, closed for modification
+ * - Dependency Inversion: Depends on abstractions (interfaces), not concrete implementations
+ */
+import type { FirebaseConfig } from '../../domain/value-objects/FirebaseConfig';
+import type { IFirebaseClient } from '../../application/ports/IFirebaseClient';
+export type FirebaseApp = any;
+/**
+ * Firebase Client Singleton
+ * Orchestrates Firebase initialization using specialized initializers
+ */
+declare class FirebaseClientSingleton implements IFirebaseClient {
+    private static instance;
+    private state;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): FirebaseClientSingleton;
+    /**
+     * Initialize Firebase client with configuration
+     * Configuration must be provided by the application (not from .env)
+     *
+     * @param config - Firebase configuration
+     * @returns Firebase app instance or null if initialization fails
+     */
+    initialize(config: FirebaseConfig): FirebaseApp | null;
+    /**
+     * Get the Firebase app instance
+     * 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
+     */
+    getApp(): FirebaseApp | null;
+    /**
+     * Check if client is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get initialization error if any
+     */
+    getInitializationError(): string | null;
+    /**
+     * Reset the client instance
+     * Useful for testing
+     */
+    reset(): void;
+}
+/**
+ * Singleton instance
+ */
+export declare const firebaseClient: FirebaseClientSingleton;
+/**
+ * Initialize Firebase client
+ * This is the main entry point for applications
+ *
+ * @param config - Firebase configuration (must be provided by app, not from .env)
+ * @returns Firebase app instance or null if initialization fails
+ *
+ * @example
+ * ```typescript
+ * import { initializeFirebase } from '@umituz/react-native-firebase';
+ *
+ * const config = {
+ *   apiKey: 'your-api-key',
+ *   authDomain: 'your-project.firebaseapp.com',
+ *   projectId: 'your-project-id',
+ * };
+ *
+ * const app = initializeFirebase(config);
+ * ```
+ */
+export declare function initializeFirebase(config: FirebaseConfig): FirebaseApp | null;
+/**
+ * Get Firebase app instance
+ * 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 declare function getFirebaseApp(): FirebaseApp | null;
+/**
+ * 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 declare function autoInitializeFirebase(): FirebaseApp | null;
+/**
+ * Service initialization result interface
+ */
+interface ServiceInitializationResult {
+    app: FirebaseApp | null;
+    auth: any | null;
+    analytics: any | null;
+    crashlytics: any | null;
+}
+/**
+ * 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 declare function initializeAllFirebaseServices(config?: FirebaseConfig): Promise<ServiceInitializationResult>;
+/**
+ * Check if Firebase client is initialized
+ */
+export declare function isFirebaseInitialized(): boolean;
+/**
+ * Get initialization error if any
+ */
+export declare function getFirebaseInitializationError(): string | null;
+/**
+ * Reset Firebase client instance
+ * Useful for testing
+ */
+export declare function resetFirebaseClient(): void;
+export {};
+//# sourceMappingURL=FirebaseClient.d.ts.map

package/lib/infrastructure/config/FirebaseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirebaseClient.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/config/FirebaseClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAK/E,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC;AA6I9B;;;GAGG;AACH,cAAM,uBAAwB,YAAW,eAAe;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAwC;IAC/D,OAAO,CAAC,KAAK,CAAsB;IAEnC,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,uBAAuB;IAO7C;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,GAAG,IAAI;IAItD;;;;;OAKG;IACH,MAAM,IAAI,WAAW,GAAG,IAAI;IAI5B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,sBAAsB,IAAI,MAAM,GAAG,IAAI;IAIvC;;;OAGG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,yBAAwC,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,GACrB,WAAW,GAAG,IAAI,CAEpB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,GAAG,IAAI,CAM3D;AAED;;GAEG;AACH,UAAU,2BAA2B;IACnC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IACjB,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,GAAG,GAAG,IAAI,CAAC;CACzB;AAiED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,2BAA2B,CAAC,CAoBtC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,GAAG,IAAI,CAE9D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}