@umituz/react-native-firebase 1.13.105 → 1.13.107

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "1.13.105",
+  "version": "1.13.107",
   "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/auth/infrastructure/config/FirebaseAuthClient.ts

@@ -7,8 +7,6 @@ import { getFirebaseApp } from '../../../infrastructure/config/FirebaseClient';
 import { FirebaseAuthInitializer } from './initializers/FirebaseAuthInitializer';
 import type { FirebaseAuthConfig } from '../../domain/value-objects/FirebaseAuthConfig';
 
-declare const __DEV__: boolean;
-
 class FirebaseAuthClientSingleton {
   private static instance: FirebaseAuthClientSingleton | null = null;
   private auth: Auth | null = null;
@@ -28,9 +26,10 @@ class FirebaseAuthClientSingleton {
       if (!app) return null;
       this.auth = FirebaseAuthInitializer.initialize(app, config);
       return this.auth;
-    } catch (error: any) {
-      if (__DEV__) console.error('[FirebaseAuth] Init error:', error.message);
-      this.initializationError = error.message;
+    } catch (error: unknown) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      if (__DEV__) console.error('[FirebaseAuth] Init error:', message);
+      this.initializationError = message;
       return null;
     }
   }
@@ -40,14 +39,21 @@ class FirebaseAuthClientSingleton {
     return this.auth;
   }
 
-  reset(): void { this.auth = null; this.initializationError = null; }
+  getInitializationError(): string | null {
+    return this.initializationError;
+  }
+
+  reset(): void {
+    this.auth = null;
+    this.initializationError = null;
+  }
 }
 
 export const firebaseAuthClient = FirebaseAuthClientSingleton.getInstance();
 export const initializeFirebaseAuth = (c?: FirebaseAuthConfig) => firebaseAuthClient.initialize(c);
 export const getFirebaseAuth = () => firebaseAuthClient.getAuth();
 export const isFirebaseAuthInitialized = () => firebaseAuthClient.getAuth() !== null;
-export const getFirebaseAuthInitializationError = () => firebaseAuthClient.initialize() ? null : "Not initialized"; 
+export const getFirebaseAuthInitializationError = () => firebaseAuthClient.getInitializationError();
 export const resetFirebaseAuthClient = () => firebaseAuthClient.reset();
 
 export type { Auth } from 'firebase/auth';

package/src/auth/infrastructure/config/initializers/FirebaseAuthInitializer.ts

@@ -17,8 +17,6 @@ import AsyncStorage from '@react-native-async-storage/async-storage';
 import type { FirebaseApp } from 'firebase/app';
 import type { FirebaseAuthConfig } from '../../../domain/value-objects/FirebaseAuthConfig';
 
-declare const __DEV__: boolean;
-
 /**
  * Initializes Firebase Auth
  * Platform-agnostic: Works on all platforms (Web, iOS, Android)

package/src/auth/infrastructure/services/account-deletion.service.ts

@@ -14,15 +14,23 @@ import type { AccountDeletionResult, AccountDeletionOptions } from "./reauthenti
 
 export type { AccountDeletionResult, AccountDeletionOptions } from "./reauthentication.types";
 
+function toAuthError(error: unknown): { code: string; message: string } {
+  const err = error as { code?: string; message?: string };
+  return {
+    code: err.code || "auth/failed",
+    message: err.message || "Unknown error",
+  };
+}
+
 export async function deleteCurrentUser(
   options: AccountDeletionOptions = { autoReauthenticate: true }
 ): Promise<AccountDeletionResult> {
   const auth = getFirebaseAuth();
   const user = auth?.currentUser;
 
-  if (!auth || !user) return { 
-    success: false, 
-    error: { code: "auth/not-ready", message: "Auth not ready", requiresReauth: false } 
+  if (!auth || !user) return {
+    success: false,
+    error: { code: "auth/not-ready", message: "Auth not ready", requiresReauth: false }
   };
   if (user.isAnonymous) return {
     success: false,
@@ -32,21 +40,22 @@ export async function deleteCurrentUser(
   try {
     await deleteUser(user);
     return { success: true };
-  } catch (error: any) {
-    if (error.code === "auth/requires-recent-login" && (options.autoReauthenticate || options.password || options.googleIdToken)) {
+  } catch (error: unknown) {
+    const authErr = toAuthError(error);
+    if (authErr.code === "auth/requires-recent-login" && (options.autoReauthenticate || options.password || options.googleIdToken)) {
       const reauth = await attemptReauth(user, options);
       if (reauth) return reauth;
     }
     return {
       success: false,
-      error: { code: error.code || "auth/failed", message: error.message, requiresReauth: error.code === "auth/requires-recent-login" }
+      error: { ...authErr, requiresReauth: authErr.code === "auth/requires-recent-login" }
     };
   }
 }
 
 async function attemptReauth(user: User, options: AccountDeletionOptions): Promise<AccountDeletionResult | null> {
   const provider = getUserAuthProvider(user);
-  let res: { success: boolean, error?: any };
+  let res: { success: boolean; error?: { code?: string; message?: string } };
 
   if (provider === "apple.com") res = await reauthenticateWithApple(user);
   else if (provider === "google.com") {
@@ -61,11 +70,12 @@ async function attemptReauth(user: User, options: AccountDeletionOptions): Promi
     try {
       await deleteUser(user);
       return { success: true };
-    } catch (err: any) {
-      return { success: false, error: { code: err.code || "auth/post-reauth-failed", message: err.message, requiresReauth: false } };
+    } catch (err: unknown) {
+      const authErr = toAuthError(err);
+      return { success: false, error: { ...authErr, requiresReauth: false } };
     }
   }
-  return { success: false, error: { code: res.error?.code || "auth/reauth-failed", message: res.error?.message, requiresReauth: true } };
+  return { success: false, error: { code: res.error?.code || "auth/reauth-failed", message: res.error?.message || "Reauth failed", requiresReauth: true } };
 }
 
 export async function deleteUserAccount(user: User): Promise<AccountDeletionResult> {
@@ -73,7 +83,8 @@ export async function deleteUserAccount(user: User): Promise<AccountDeletionResu
   try {
     await deleteUser(user);
     return { success: true };
-  } catch (error: any) {
-    return { success: false, error: { code: error.code || "auth/failed", message: error.message, requiresReauth: error.code === "auth/requires-recent-login" } };
+  } catch (error: unknown) {
+    const authErr = toAuthError(error);
+    return { success: false, error: { ...authErr, requiresReauth: authErr.code === "auth/requires-recent-login" } };
   }
 }

package/src/auth/infrastructure/services/anonymous-auth.service.ts

@@ -22,15 +22,7 @@ export class AnonymousAuthService implements AnonymousAuthServiceInterface {
 
     const currentUser = auth.currentUser;
 
-    if (currentUser && !currentUser.isAnonymous) {
-      return {
-        user: currentUser,
-        anonymousUser: toAnonymousUser(currentUser),
-        wasAlreadySignedIn: true,
-      };
-    }
-
-    if (currentUser && currentUser.isAnonymous) {
+    if (currentUser) {
       return {
         user: currentUser,
         anonymousUser: toAnonymousUser(currentUser),

package/src/auth/infrastructure/services/apple-auth.service.ts

@@ -10,8 +10,8 @@ import {
   type UserCredential,
 } from "firebase/auth";
 import * as AppleAuthentication from "expo-apple-authentication";
-import * as Crypto from "expo-crypto";
 import { Platform } from "react-native";
+import { generateNonce, hashNonce } from "./crypto.util";
 
 export interface AppleAuthResult {
   success: boolean;
@@ -25,7 +25,8 @@ export class AppleAuthService {
     if (Platform.OS !== "ios") return false;
     try {
       return await AppleAuthentication.isAvailableAsync();
-    } catch {
+    } catch (error) {
+      if (__DEV__) console.warn('[AppleAuth] isAvailable check failed:', error);
       return false;
     }
   }
@@ -40,11 +41,8 @@ export class AppleAuthService {
         };
       }
 
-      const nonce = await this.generateNonce();
-      const hashedNonce = await Crypto.digestStringAsync(
-        Crypto.CryptoDigestAlgorithm.SHA256,
-        nonce,
-      );
+      const nonce = await generateNonce();
+      const hashedNonce = await hashNonce(nonce);
 
       const appleCredential = await AppleAuthentication.signInAsync({
         requestedScopes: [
@@ -86,16 +84,6 @@ export class AppleAuthService {
     }
   }
 
-  private async generateNonce(length: number = 32): Promise<string> {
-    const randomBytes = await Crypto.getRandomBytesAsync(length);
-    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-    let result = "";
-    for (let i = 0; i < randomBytes.length; i++) {
-      const byte = randomBytes[i];
-      if (byte !== undefined) result += chars.charAt(byte % chars.length);
-    }
-    return result;
-  }
 }
 
 export const appleAuthService = new AppleAuthService();

package/src/auth/infrastructure/services/auth-guard.service.ts

@@ -52,7 +52,8 @@ export class AuthGuardService {
   async getAuthenticatedUserId(): Promise<string | null> {
     try {
       return await this.requireAuthenticatedUser();
-    } catch {
+    } catch (error) {
+      if (__DEV__) console.warn('[AuthGuard] getAuthenticatedUserId:', error);
       return null;
     }
   }

package/src/auth/infrastructure/services/crypto.util.ts

@@ -0,0 +1,17 @@
+/**
+ * Crypto Utilities
+ * Shared cryptographic helpers for auth services
+ */
+
+import * as Crypto from "expo-crypto";
+
+const NONCE_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+
+export async function generateNonce(length: number = 32): Promise<string> {
+  const bytes = await Crypto.getRandomBytesAsync(length);
+  return Array.from(bytes).map(b => NONCE_CHARS.charAt(b % NONCE_CHARS.length)).join("");
+}
+
+export async function hashNonce(nonce: string): Promise<string> {
+  return Crypto.digestStringAsync(Crypto.CryptoDigestAlgorithm.SHA256, nonce);
+}

package/src/auth/infrastructure/services/firestore-utils.service.ts

@@ -6,8 +6,6 @@
 import type { Auth } from "firebase/auth";
 import { checkAuthState, verifyUserId } from "./auth-utils.service";
 
-declare const __DEV__: boolean;
-
 export interface FirestoreQueryOptions {
   readonly skipForGuest?: boolean;
   readonly skipIfNotAuthenticated?: boolean;

package/src/auth/infrastructure/services/password.service.ts

@@ -24,12 +24,13 @@ export async function updateUserPassword(user: User, newPassword: string): Promi
   try {
     await updatePassword(user, newPassword);
     return { success: true };
-  } catch (error: any) {
+  } catch (error: unknown) {
+    const err = error as { code?: string; message?: string };
     return {
       success: false,
       error: {
-        code: error.code || 'auth/password-update-failed',
-        message: error.message || 'Failed to update password',
+        code: err.code || 'auth/password-update-failed',
+        message: err.message || 'Failed to update password',
       },
     };
   }

package/src/auth/infrastructure/services/reauthentication.service.ts

@@ -11,8 +11,8 @@ import {
   type User,
 } from "firebase/auth";
 import * as AppleAuthentication from "expo-apple-authentication";
-import * as Crypto from "expo-crypto";
 import { Platform } from "react-native";
+import { generateNonce, hashNonce } from "./crypto.util";
 import type { 
   ReauthenticationResult, 
   AuthProviderType, 
@@ -25,6 +25,14 @@ export type {
   ReauthCredentialResult 
 } from "./reauthentication.types";
 
+function toAuthError(error: unknown): { code: string; message: string } {
+  const err = error as { code?: string; message?: string };
+  return {
+    code: err.code || "auth/failed",
+    message: err.message || "Unknown error",
+  };
+}
+
 export function getUserAuthProvider(user: User): AuthProviderType {
   if (user.isAnonymous) return "anonymous";
   const data = user.providerData;
@@ -39,8 +47,9 @@ export async function reauthenticateWithGoogle(user: User, idToken: string): Pro
   try {
     await reauthenticateWithCredential(user, GoogleAuthProvider.credential(idToken));
     return { success: true };
-  } catch (error: any) {
-    return { success: false, error: { code: error.code || "auth/failed", message: error.message } };
+  } catch (error: unknown) {
+    const err = toAuthError(error);
+    return { success: false, error: err };
   }
 }
 
@@ -49,17 +58,12 @@ export async function reauthenticateWithPassword(user: User, pass: string): Prom
   try {
     await reauthenticateWithCredential(user, EmailAuthProvider.credential(user.email, pass));
     return { success: true };
-  } catch (error: any) {
-    return { success: false, error: { code: error.code || "auth/failed", message: error.message } };
+  } catch (error: unknown) {
+    const err = toAuthError(error);
+    return { success: false, error: err };
   }
 }
 
-async function generateNonce(len: number = 32): Promise<string> {
-  const bytes = await Crypto.getRandomBytesAsync(len);
-  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-  return Array.from(bytes).map(b => chars.charAt(b % chars.length)).join("");
-}
-
 export async function getAppleReauthCredential(): Promise<ReauthCredentialResult> {
   if (Platform.OS !== "ios") return { success: false, error: { code: "auth/ios-only", message: "iOS only" } };
   try {
@@ -67,7 +71,7 @@ export async function getAppleReauthCredential(): Promise<ReauthCredentialResult
       return { success: false, error: { code: "auth/unavailable", message: "Unavailable" } };
 
     const nonce = await generateNonce();
-    const hashed = await Crypto.digestStringAsync(Crypto.CryptoDigestAlgorithm.SHA256, nonce);
+    const hashed = await hashNonce(nonce);
     const apple = await AppleAuthentication.signInAsync({
       requestedScopes: [AppleAuthentication.AppleAuthenticationScope.FULL_NAME, AppleAuthentication.AppleAuthenticationScope.EMAIL],
       nonce: hashed,
@@ -75,9 +79,10 @@ export async function getAppleReauthCredential(): Promise<ReauthCredentialResult
 
     if (!apple.identityToken) return { success: false, error: { code: "auth/no-token", message: "No token" } };
     return { success: true, credential: new OAuthProvider("apple.com").credential({ idToken: apple.identityToken, rawNonce: nonce }) };
-  } catch (error: any) {
-    const code = error.message?.includes("ERR_CANCELED") ? "auth/cancelled" : "auth/failed";
-    return { success: false, error: { code, message: error.message } };
+  } catch (error: unknown) {
+    const err = toAuthError(error);
+    const code = err.message.includes("ERR_CANCELED") ? "auth/cancelled" : err.code;
+    return { success: false, error: { code, message: err.message } };
   }
 }
 
@@ -87,7 +92,8 @@ export async function reauthenticateWithApple(user: User): Promise<Reauthenticat
   try {
     await reauthenticateWithCredential(user, res.credential);
     return { success: true };
-  } catch (error: any) {
-    return { success: false, error: { code: error.code || "auth/failed", message: error.message } };
+  } catch (error: unknown) {
+    const err = toAuthError(error);
+    return { success: false, error: err };
   }
 }

package/src/auth/infrastructure/stores/auth.store.ts

@@ -10,8 +10,6 @@
 import { createStore, type SetState, type GetState } from "@umituz/react-native-design-system";
 import { onAuthStateChanged, type User, type Auth } from "firebase/auth";
 
-declare const __DEV__: boolean;
-
 interface AuthState {
   user: User | null;
   loading: boolean;
@@ -52,7 +50,7 @@ export const useFirebaseAuthStore = createStore<AuthState, AuthActions>({
 
       try {
         unsubscribe = onAuthStateChanged(auth, (currentUser: User | null) => {
-          if (typeof __DEV__ !== "undefined" && __DEV__) {
+          if (__DEV__) {
             console.log(
               "[FirebaseAuthStore] Auth state changed:",
               currentUser?.uid || "null"
@@ -71,7 +69,7 @@ export const useFirebaseAuthStore = createStore<AuthState, AuthActions>({
         // On error, release the mutex so retry is possible
         setupInProgress = false;
         set({ listenerSetup: false });
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
+        if (__DEV__) {
           console.error("[FirebaseAuthStore] Failed to setup listener:", error);
         }
       }

package/src/auth/presentation/hooks/useAnonymousAuth.ts

@@ -9,8 +9,6 @@ import type { AuthCheckResult } from "../../infrastructure/services/auth-utils.s
 import { anonymousAuthService, type AnonymousAuthResult } from "../../infrastructure/services/anonymous-auth.service";
 import { createAuthStateChangeHandler, userToAuthCheckResult } from "./utils/auth-state-change.handler";
 
-declare const __DEV__: boolean;
-
 export interface UseAnonymousAuthResult extends AuthCheckResult {
   /**
    * Sign in anonymously

package/src/auth/presentation/hooks/useSocialAuth.ts

@@ -79,8 +79,10 @@ export function useSocialAuth(config?: SocialAuthConfig): UseSocialAuthResult {
 
       setGoogleLoading(true);
       try {
+        const auth = getFirebaseAuth();
+        if (!auth) return { success: false, error: "Firebase Auth not initialized" };
         return await signInWrapper(() =>
-          googleAuthService.signInWithIdToken(getFirebaseAuth()!, idToken)
+          googleAuthService.signInWithIdToken(auth, idToken)
         );
       } catch (error) {
         return {
@@ -101,8 +103,10 @@ export function useSocialAuth(config?: SocialAuthConfig): UseSocialAuthResult {
 
     setAppleLoading(true);
     try {
+      const auth = getFirebaseAuth();
+      if (!auth) return { success: false, error: "Firebase Auth not initialized" };
       return await signInWrapper(() =>
-        appleAuthService.signIn(getFirebaseAuth()!)
+        appleAuthService.signIn(auth)
       );
     } catch (error) {
       return {

package/src/auth/presentation/hooks/utils/auth-state-change.handler.ts

@@ -6,8 +6,6 @@
 import type { User } from 'firebase/auth';
 import type { AuthCheckResult } from '../../../infrastructure/services/auth-utils.service';
 
-declare const __DEV__: boolean;
-
 /**
  * Convert Firebase User to AuthCheckResult
  * @param user - Firebase user or null

package/src/domain/errors/FirebaseError.ts

@@ -12,7 +12,7 @@ if (__DEV__) {
  * Base Firebase error class
  */
 export class FirebaseError extends Error {
-    constructor(message: string, public code?: string, public cause?: any) {
+    constructor(message: string, public code?: string, public cause?: unknown) {
         super(message);
         this.name = 'FirebaseError';
         Object.setPrototypeOf(this, FirebaseError.prototype);
@@ -23,7 +23,7 @@ export class FirebaseError extends Error {
  * Initialization specific error
  */
 export class FirebaseInitializationError extends FirebaseError {
-    constructor(message: string, cause?: any) {
+    constructor(message: string, cause?: unknown) {
         super(message, 'INITIALIZATION_ERROR', cause);
         this.name = 'FirebaseInitializationError';
         Object.setPrototypeOf(this, FirebaseInitializationError.prototype);
@@ -34,7 +34,7 @@ export class FirebaseInitializationError extends FirebaseError {
  * Configuration specific error
  */
 export class FirebaseConfigurationError extends FirebaseError {
-    constructor(message: string, cause?: any) {
+    constructor(message: string, cause?: unknown) {
         super(message, 'CONFIGURATION_ERROR', cause);
         this.name = 'FirebaseConfigurationError';
         Object.setPrototypeOf(this, FirebaseConfigurationError.prototype);

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

@@ -8,8 +8,7 @@
  * Use @umituz/react-native-firebase to initialize Firebase App.
  */
 
- 
-if (typeof __DEV__ !== "undefined" && __DEV__) console.log("📍 [LIFECYCLE] FirestoreClient.ts - Module loading");
+if (__DEV__) console.log("📍 [LIFECYCLE] FirestoreClient.ts - Module loading");
 
 import type { Firestore } from 'firebase/firestore';
 import { getFirebaseApp } from '../../../infrastructure/config/FirebaseClient';

package/src/firestore/infrastructure/config/initializers/FirebaseFirestoreInitializer.ts

@@ -33,12 +33,8 @@ export class FirebaseFirestoreInitializer {
       return initializeFirestore(app, {
         localCache: memoryLocalCache(),
       });
-    } catch (error: any) {
+    } catch (error: unknown) {
       // If already initialized, get existing instance
-      if (error.code === 'failed-precondition') {
-        return getFirestore(app);
-      }
-
       return getFirestore(app);
     }
   }

package/src/firestore/infrastructure/middleware/QueryDeduplicationMiddleware.ts

@@ -19,7 +19,7 @@ export class QueryDeduplicationMiddleware {
   private pendingQueries = new Map<string, PendingQuery>();
   private readonly DEDUPLICATION_WINDOW_MS = 1000; // 1 second
   private readonly CLEANUP_INTERVAL_MS = 5000; // 5 seconds
-  private cleanupTimer: any = null;
+  private cleanupTimer: ReturnType<typeof setInterval> | null = null;
 
   constructor() {
     this.startCleanupTimer();

package/src/firestore/infrastructure/middleware/QuotaTrackingMiddleware.ts

@@ -3,8 +3,6 @@
  * Tracks Firestore operations for quota monitoring
  */
 
-declare const __DEV__: boolean;
-
 interface OperationInfo {
     type: 'read' | 'write' | 'delete';
     collection: string;

package/src/firestore/infrastructure/repositories/BasePaginatedRepository.ts

@@ -42,8 +42,8 @@ export abstract class BasePaginatedRepository extends BaseQueryRepository {
       limit(fetchLimit),
     );
 
-    if (helper.hasCursor(params)) {
-      const cursorDoc = await getDoc(doc(db, collectionName, params!.cursor!));
+    if (helper.hasCursor(params) && params?.cursor) {
+      const cursorDoc = await getDoc(doc(db, collectionName, params.cursor));
       if (cursorDoc.exists()) {
         q = query(
           collectionRef,

package/src/firestore/infrastructure/repositories/BaseRepository.ts

@@ -14,8 +14,7 @@
  * It provides a consistent interface for Firestore operations.
  */
 
- 
-if (typeof __DEV__ !== "undefined" && __DEV__) console.log("📍 [LIFECYCLE] BaseRepository.ts - Module loading");
+if (__DEV__) console.log("📍 [LIFECYCLE] BaseRepository.ts - Module loading");
 
 import type { Firestore } from "firebase/firestore";
 import { getFirestore } from "../config/FirestoreClient";
@@ -71,7 +70,8 @@ export class BaseRepository {
     try {
       const db = getFirestore();
       return db !== null;
-    } catch {
+    } catch (error) {
+      if (__DEV__) console.warn('[BaseRepository] isDbInitialized check failed:', error);
       return false;
     }
   }

package/src/firestore/infrastructure/services/RequestLoggerService.ts

@@ -74,8 +74,8 @@ export class RequestLoggerService {
     const failedRequests = this.logs.filter((l) => !l.success).length;
 
     const durations = this.logs
-      .filter((l) => l.duration !== undefined)
-      .map((l) => l.duration!);
+      .map((l) => l.duration)
+      .filter((d): d is number => d !== undefined);
     const averageDuration =
       durations.length > 0
         ? durations.reduce((sum, d) => sum + d, 0) / durations.length

package/src/firestore/utils/dateUtils.ts

@@ -10,7 +10,7 @@ export function isoToTimestamp(isoString: string): Timestamp {
 /**
  * Convert Firestore Timestamp to ISO string
  */
-export function timestampToISO(timestamp: Timestamp): string {
+export function timestampToISO(timestamp: Timestamp | null | undefined): string {
     if (!timestamp) return new Date().toISOString();
     return timestamp.toDate().toISOString();
 }
@@ -18,7 +18,7 @@ export function timestampToISO(timestamp: Timestamp): string {
 /**
  * Convert Firestore Timestamp to Date
  */
-export function timestampToDate(timestamp: Timestamp): Date {
+export function timestampToDate(timestamp: Timestamp | null | undefined): Date {
     if (!timestamp) return new Date();
     return timestamp.toDate();
 }

package/src/firestore/utils/firestore-helper.ts

@@ -2,8 +2,6 @@
  * Firestore Helper - Centralized Firestore access utilities
  * Provides common patterns for Firestore operations with error handling
  */
-declare const __DEV__: boolean;
-
 import { getFirestore } from "../infrastructure/config/FirestoreClient";
 import type { Firestore } from "../infrastructure/config/FirestoreClient";
 

package/src/global.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Global type declarations for React Native environment
+ */
+
+declare const __DEV__: boolean;

package/src/infrastructure/config/FirebaseClient.ts

@@ -16,8 +16,7 @@
  * - Dependency Inversion: Depends on abstractions (interfaces), not concrete implementations
  */
 
- 
-if (typeof __DEV__ !== "undefined" && __DEV__) console.log("📍 [LIFECYCLE] FirebaseClient.ts - Module loading");
+if (__DEV__) console.log("📍 [LIFECYCLE] FirebaseClient.ts - Module loading");
 
 import type { FirebaseConfig } from '../../domain/value-objects/FirebaseConfig';
 import type { IFirebaseClient } from '../../application/ports/IFirebaseClient';
@@ -33,8 +32,6 @@ import { loadFirebaseConfig } from './FirebaseConfigLoader';
 
 export type { FirebaseApp, AuthInitializer, ServiceInitializationOptions };
 
-declare const __DEV__: boolean;
-
 /**
  * Service initialization result interface
  */

package/src/infrastructure/config/FirebaseConfigLoader.ts

@@ -37,11 +37,11 @@ function getEnvValue(key: ConfigKey): string {
  */
 function loadExpoConfig(): Record<string, string> {
   try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
     const Constants = require('expo-constants');
     const expoConfig = Constants?.expoConfig || Constants?.default?.expoConfig;
     return expoConfig?.extra || {};
-  } catch {
+  } catch (error) {
+    if (__DEV__) console.warn('[FirebaseConfigLoader] expo-constants not available:', error);
     return {};
   }
 }

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

@@ -21,7 +21,7 @@ class FirebaseConfigMapper {
   /**
    * Map domain config to Firebase SDK config
    */
-  static toFirebaseConfig(config: FirebaseConfig): Record<string, any> {
+  static toFirebaseConfig(config: FirebaseConfig): Record<string, string | undefined> {
     return {
       apiKey: config.apiKey,
       authDomain: config.authDomain,
@@ -44,7 +44,8 @@ class FirebaseAppManager {
     try {
       const existingApps = getApps();
       return existingApps.length > 0;
-    } catch {
+    } catch (error) {
+      if (__DEV__) console.warn('[FirebaseAppManager] isInitialized check failed:', error);
       return false;
     }
   }
@@ -56,7 +57,8 @@ class FirebaseAppManager {
     try {
       const existingApps = getApps();
       return existingApps.length > 0 ? existingApps[0] ?? null : null;
-    } catch {
+    } catch (error) {
+      if (__DEV__) console.warn('[FirebaseAppManager] getExistingApp failed:', error);
       return null;
     }
   }

package/src/infrastructure/config/orchestrators/FirebaseInitializationOrchestrator.ts

@@ -12,8 +12,6 @@ import { FirebaseAppInitializer } from '../initializers/FirebaseAppInitializer';
 import { loadFirebaseConfig } from '../FirebaseConfigLoader';
 import type { FirebaseClientState } from '../state/FirebaseClientState';
 
-declare const __DEV__: boolean;
-
 export class FirebaseInitializationOrchestrator {
   static initialize(
     config: FirebaseConfig,

package/src/infrastructure/config/services/FirebaseServiceInitializer.ts

@@ -8,8 +8,6 @@
  * Single Responsibility: Only initializes Firebase Auth service
  */
 
-declare const __DEV__: boolean;
-
 export type AuthInitializer = () => unknown;
 
 export interface ServiceInitializationOptions {

package/src/init/createFirebaseInitModule.ts

@@ -7,8 +7,6 @@ import type { InitModule } from '@umituz/react-native-design-system';
 import { initializeAllFirebaseServices } from '../infrastructure/config/FirebaseClient';
 import { initializeFirebaseAuth } from '../auth/infrastructure/config/FirebaseAuthClient';
 
-declare const __DEV__: boolean;
-
 export interface FirebaseInitModuleConfig {
   /**
    * Custom auth initializer function
@@ -53,13 +51,13 @@ export function createFirebaseInitModule(
           authInitializer: authInitializer ?? (() => initializeFirebaseAuth()),
         });
 
-        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        if (__DEV__) {
           console.log('[createFirebaseInitModule] Firebase initialized');
         }
 
         return true;
       } catch (error) {
-        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        if (__DEV__) {
           console.error('[createFirebaseInitModule] Error:', error);
         }
         // Return false to indicate failure, let the app initializer handle it

package/src/storage/deleter.ts

@@ -3,12 +3,10 @@
  * Handles single and batch deletion from Firebase Storage
  */
 
-import { getStorage, ref, deleteObject } from "firebase/storage";
-import { getFirebaseApp } from "../infrastructure/config/FirebaseClient";
+import { ref, deleteObject } from "firebase/storage";
+import { getStorageInstance } from "./storage-instance";
 import type { DeleteResult } from "./types";
 
-declare const __DEV__: boolean;
-
 /**
  * Batch delete result interface
  */
@@ -34,16 +32,12 @@ function extractStoragePath(downloadUrl: string): string | null {
         }
 
         return decodeURIComponent(pathMatch[1]);
-    } catch {
+    } catch (error) {
+        if (__DEV__) console.warn('[StorageDeleter] Failed to parse URL:', error);
         return null;
     }
 }
 
-function getStorageInstance() {
-    const app = getFirebaseApp();
-    return app ? getStorage(app) : null;
-}
-
 /**
  * Delete image from Firebase Storage
  * Accepts either a download URL or storage path
@@ -130,9 +124,10 @@ export async function deleteStorageFiles(
             successful.push(result.value.storagePath);
         } else {
             const errorMessage = result.status === "rejected"
-                ? String((result.reason as any)?.message ?? "Unknown error")
+                ? String(result.reason instanceof Error ? result.reason.message : "Unknown error")
                 : "Delete operation failed";
-            failed.push({ path: urlsOrPaths[index]!, error: errorMessage });
+            const path = urlsOrPaths[index] ?? "unknown";
+            failed.push({ path, error: errorMessage });
         }
     });
 

package/src/storage/storage-instance.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared Firebase Storage instance getter
+ */
+
+import { getStorage } from "firebase/storage";
+import { getFirebaseApp } from "../infrastructure/config/FirebaseClient";
+
+export function getStorageInstance() {
+    const app = getFirebaseApp();
+    return app ? getStorage(app) : null;
+}

package/src/storage/uploader.ts

@@ -4,17 +4,14 @@
  */
 
 import {
-    getStorage,
     ref,
     uploadBytes,
     getDownloadURL,
     type UploadMetadata,
 } from "firebase/storage";
-import { getFirebaseApp } from "../infrastructure/config/FirebaseClient";
+import { getStorageInstance } from "./storage-instance";
 import type { UploadResult, UploadOptions } from "./types";
 
-declare const __DEV__: boolean;
-
 /**
  * Extract MIME type from base64 data URL or return default
  */
@@ -35,11 +32,6 @@ function ensureDataUrl(base64: string, mimeType: string): string {
     return `data:${mimeType};base64,${base64}`;
 }
 
-function getStorageInstance() {
-    const app = getFirebaseApp();
-    return app ? getStorage(app) : null;
-}
-
 /**
  * Upload base64 image to Firebase Storage
  */