@umituz/react-native-firebase 2.6.7 → 3.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "2.6.7",
+  "version": "3.0.1",
   "description": "Unified Firebase package for React Native apps - Auth and Firestore services using Firebase JS SDK (no native modules).",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/domains/firestore/index.ts

@@ -1,6 +1,11 @@
 /**
  * React Native Firestore Module
  * Domain-Driven Design (DDD) Architecture
+ *
+ * IMPORTANT: This package does NOT import from 'firebase/firestore' or 'firebase/auth'.
+ * Import those directly in your app using the firebase SDK if you need types.
+ *
+ * This package provides utilities and repositories ONLY.
  */
 
 // =============================================================================
@@ -101,7 +106,3 @@ export { useFirestoreSnapshot } from './presentation/hooks/useFirestoreSnapshot'
 export type { UseFirestoreQueryOptions } from './presentation/hooks/useFirestoreQuery';
 export type { UseFirestoreMutationOptions } from './presentation/hooks/useFirestoreMutation';
 export type { UseFirestoreSnapshotOptions } from './presentation/hooks/useFirestoreSnapshot';
-
-// Export Firestore types directly from firebase package
-// Import them in your app: import { Timestamp } from 'firebase/firestore';
-

package/src/domains/firestore/infrastructure/config/FirestoreClient.ts

@@ -1,79 +1,76 @@
 /**
- * Firestore Client - Infrastructure Layer
+ * Firestore Configuration Client
  *
- * Domain-Driven Design: Infrastructure implementation of Firestore client
- * Singleton pattern for managing Firestore instance
- */
-
-import type { Firestore } from 'firebase/firestore';
-import { getFirestore as getFirestoreFromFirebase } from 'firebase/firestore';
-import { getFirebaseApp } from '../../../../shared/infrastructure/config/services/FirebaseInitializationService';
-import { ServiceClientSingleton } from '../../../../shared/infrastructure/config/base/ServiceClientSingleton';
-
-/**
- * Firestore Client Singleton
- * Manages Firestore initialization
+ * IMPORTANT: This package does NOT import from firebase/firestore to avoid
+ * IndexedDB dependencies that break React Native bundling.
+ *
+ * Instead, you should:
+ * 1. Install firebase SDK in your app: npm install firebase
+ * 2. Import and use getFirestore() from 'firebase/firestore' directly
+ * 3. Use the utilities from this package for repositories and helpers
  */
-class FirestoreClientSingleton extends ServiceClientSingleton<Firestore> {
-  private constructor() {
-    super();
-  }
-
-  initialize(): Firestore {
-    try {
-      const app = getFirebaseApp();
-      if (!app) {
-        this.setError('Firebase App is not initialized');
-        throw new Error('Firebase App is not initialized');
-      }
 
-      const firestore = getFirestoreFromFirebase(app);
-      this.instance = firestore;
-      return firestore;
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'Firestore initialization failed';
-      this.setError(errorMessage);
-      throw error;
-    }
-  }
+import { FirebaseInitializationError } from "../../../../shared/domain/errors/FirebaseError";
 
-  getFirestore(): Firestore {
-    if (!this.isInitialized()) {
-      return this.initialize();
-    }
-    return this.getInstance();
-  }
+// Firestore type from firebase/firestore SDK
+// Import in your app: import type { Firestore } from 'firebase/firestore'
+export type Firestore = unknown;
 
-  private static instance: FirestoreClientSingleton | null = null;
+let firestoreInstance: Firestore | null = null;
+let initializationError: Error | null = null;
 
-  static getInstance(): FirestoreClientSingleton {
-    if (!this.instance) {
-      this.instance = new FirestoreClientSingleton();
-    }
-    return this.instance;
-  }
+/**
+ * Initialize Firestore
+ *
+ * DEPRECATED: This function is deprecated and will be removed in future versions.
+ *
+ * Instead, initialize Firestore directly in your app:
+ * ```typescript
+ * import { initializeFirestore } from 'firebase/firestore';
+ * import { getReactNativePersistence } from 'firebase/firestore/react-native';
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ *
+ * const firestore = initializeFirestore(firebaseApp, {
+ *   localCache: getReactNativePersistence(AsyncStorage)
+ * });
+ * ```
+ */
+export async function initializeFirestore(
+  firebaseApp: unknown // FirebaseApp from firebase/app
+): Promise<Firestore> {
+  throw new FirebaseInitializationError(
+    "Firestore initialization has moved. " +
+    "Please use initializeFirestore() from 'firebase/firestore' directly in your app. " +
+    "See package README for migration guide."
+  );
 }
 
-const firestoreClientSingleton = FirestoreClientSingleton.getInstance();
-
-export const initializeFirestore = (): Firestore => {
-  return firestoreClientSingleton.initialize();
-};
-
-export const getFirestore = (): Firestore => {
-  return firestoreClientSingleton.getFirestore();
-};
-
-export const isFirestoreInitialized = (): boolean => {
-  return firestoreClientSingleton.isInitialized();
-};
+/**
+ * Get Firestore instance
+ * Returns null if not initialized
+ */
+export function getFirestore(): Firestore | null {
+  return firestoreInstance;
+}
 
-export const getFirestoreInitializationError = (): Error | null => {
-  return firestoreClientSingleton.getInitializationError();
-};
+/**
+ * Check if Firestore is initialized
+ */
+export function isFirestoreInitialized(): boolean {
+  return firestoreInstance !== null;
+}
 
-export const resetFirestoreClient = (): void => {
-  firestoreClientSingleton.reset();
-};
+/**
+ * Get Firestore initialization error
+ */
+export function getFirestoreInitializationError(): Error | null {
+  return initializationError;
+}
 
-export type { Firestore } from 'firebase/firestore';
+/**
+ * Reset Firestore client state
+ */
+export function resetFirestoreClient(): void {
+  firestoreInstance = null;
+  initializationError = null;
+}

package/src/index.ts

@@ -2,6 +2,11 @@
  * React Native Firebase - Unified Package
  *
  * Domain-Driven Design (DDD) Architecture
+ *
+ * IMPORTANT: This package does NOT import from 'firebase/app' or other firebase packages.
+ * Import firebase SDK directly in your app if you need those types.
+ *
+ * This package provides utilities and abstractions ONLY for React Native.
  */
 
 // Core Errors

package/src/shared/types/firebase.types.ts

@@ -0,0 +1,276 @@
+/**
+ * Firebase Type Definitions
+ *
+ * These types mirror Firebase SDK types but don't import from the firebase package.
+ * This prevents the 'idb' dependency that causes bundling errors in React Native.
+ */
+
+// =============================================================================
+// Firebase App Types
+// =============================================================================
+
+export interface FirebaseApp {
+  name: string;
+  options?: FirebaseAppOptions;
+}
+
+export interface FirebaseAppOptions {
+  apiKey?: string;
+  authDomain?: string;
+  databaseURL?: string;
+  projectId?: string;
+  storageBucket?: string;
+  messagingSenderId?: string;
+  appId?: string;
+  measurementId?: string;
+}
+
+// =============================================================================
+// Firestore Types
+// =============================================================================
+
+// IMPORTANT: Import Firestore from 'firebase/firestore' in your app
+// Do NOT use this type - it's only for internal package compatibility
+export interface Firestore {
+  readonly __brand: 'Firestore';
+}
+
+export interface DocumentSnapshot<T = unknown> {
+  id: string;
+  ref: DocumentReference<T>;
+  data: T | null;
+  metadata: SnapshotMetadata;
+  exists(): boolean;
+}
+
+export interface SnapshotMetadata {
+  hasPendingWrites: boolean;
+  fromCache: boolean;
+}
+
+export interface QuerySnapshot<T = unknown> {
+  docs: QueryDocumentSnapshot<T>[];
+  metadata: SnapshotMetadata;
+  size: number;
+  empty: boolean;
+  docChanges: DocumentChange<T>[];
+}
+
+export interface QueryDocumentSnapshot<T = unknown> extends DocumentSnapshot<T> {}
+
+export interface DocumentReference<T = unknown> {
+  id: string;
+  firestore: Firestore;
+  path: string;
+  parent: CollectionReference<T> | null;
+  get(): Promise<DocumentSnapshot<T>>;
+}
+
+export interface CollectionReference<T = unknown> {
+  id: string;
+  firestore: Firestore;
+  path: string;
+  parent: CollectionReference<unknown> | DocumentReference<unknown> | null;
+  doc(documentPath?: string): DocumentReference<T>;
+}
+
+export interface Query<T = unknown> {
+  firestore: Firestore;
+}
+
+// =============================================================================
+// Firestore Types - Field Values
+// =============================================================================
+
+export type FieldPath = string | readonly string[];
+
+export interface FieldValue {
+  isEqual(other: unknown): boolean;
+}
+
+export interface Bytes {
+  toUint8Array(): Uint8Array;
+  toBase64(): string;
+  toString(format?: 'base64' | 'base64url'): string;
+}
+
+// =============================================================================
+// Firestore Types - Timestamp
+// =============================================================================
+
+export class Timestamp {
+  readonly seconds: number;
+  readonly nanoseconds: number;
+
+  constructor(seconds: number, nanoseconds: number);
+
+  static now(): Timestamp;
+  static fromDate(date: Date): Timestamp;
+  static fromMillis(milliseconds: number): Timestamp;
+
+  toDate(): Date;
+  toMillis(): number;
+  toString(): string;
+  isEqual(other: Timestamp): boolean;
+
+  valueOf(): number {
+    return this.toMillis();
+  }
+}
+
+// =============================================================================
+// Firestore Types - GeoPoint
+// =============================================================================
+
+export class GeoPoint {
+  readonly latitude: number;
+  readonly longitude: number;
+
+  constructor(latitude: number, longitude: number);
+
+  toString(): string;
+  isEqual(other: GeoPoint): boolean;
+}
+
+// =============================================================================
+// Firestore Types - Transaction
+// =============================================================================
+
+export interface Transaction {
+  get(documentRef: DocumentReference): Promise<DocumentSnapshot>;
+  set(documentRef: DocumentReference, data: unknown): Promise<void>;
+  update(documentRef: DocumentReference, data: Partial<unknown>): Promise<void>;
+  delete(documentRef: DocumentReference): Promise<void>;
+}
+
+// =============================================================================
+// Firestore Types - Query
+// =============================================================================
+
+export type WhereFilterOp =
+  | '<'
+  | '<='
+  | '=='
+  | '!='
+  | '>='
+  | '>'
+  | 'array-contains'
+  | 'in'
+  | 'array-contains-any'
+  | 'not-in';
+
+export type OrderByDirection = 'asc' | 'desc';
+
+export type QueryConstraint = QueryFilterConstraint | QueryOrderByConstraint | QueryLimitConstraint | QueryStartAtConstraint | QueryEndAtConstraint;
+
+export interface QueryFilterConstraint {
+  type: 'where';
+  fieldPath: FieldPath;
+  op: WhereFilterOp;
+  value: unknown;
+}
+
+export interface QueryOrderByConstraint {
+  type: 'orderBy';
+  fieldPath: FieldPath;
+  direction?: OrderByDirection;
+}
+
+export interface QueryLimitConstraint {
+  type: 'limit';
+  limit: number;
+}
+
+export interface QueryStartAtConstraint {
+  type: 'startAt';
+  cursor: unknown;
+}
+
+export interface QueryEndAtConstraint {
+  type: 'endAt';
+  cursor: unknown;
+}
+
+// =============================================================================
+// Auth Types
+// =============================================================================
+
+export interface Auth {
+  app: FirebaseApp;
+  currentUser: User | null;
+}
+
+export interface User {
+  uid: string;
+  email: string | null;
+  emailVerified: boolean;
+  displayName: string | null;
+  photoURL: string | null;
+  phoneNumber: string | null;
+  tenantId: string | null;
+  providerId: string;
+  metadata: UserMetadata;
+  isAnonymous: boolean;
+}
+
+export interface UserMetadata {
+  creationTime?: string;
+  lastSignInTime?: string | null;
+}
+
+export interface UserCredential {
+  user: User;
+  providerId: string | null;
+  operationType?: string;
+}
+
+export interface AuthCredential {
+  providerId: string;
+  signInMethod: string;
+}
+
+// =============================================================================
+// Error Types
+// =============================================================================
+
+export interface FirestoreError {
+  code: string;
+  message: string;
+  name: string;
+}
+
+export interface AuthError {
+  code: string;
+  message: string;
+  name: string;
+}
+
+export interface FirebaseError extends Error {
+  code: string;
+  name: string;
+}
+
+// =============================================================================
+// Change Type
+// =============================================================================
+
+export type DocumentChangeType = 'added' | 'removed' | 'modified';
+
+export interface DocumentChange<T = unknown> {
+  type: DocumentChangeType;
+  doc: QueryDocumentSnapshot<T>;
+  oldIndex?: number;
+  newIndex?: number;
+}
+
+// =============================================================================
+// Blob Types
+// =============================================================================
+
+export interface Blob {
+  bytes: Uint8Array;
+}
+
+export function blob(bytes: Uint8Array): Blob {
+  return { bytes };
+}