@umituz/react-native-firebase 2.4.24 → 2.4.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "2.4.24",
+  "version": "2.4.25",
   "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/account-deletion/infrastructure/services/reauthentication.service.ts

@@ -14,7 +14,7 @@ import * as AppleAuthentication from "expo-apple-authentication";
 import { Platform } from "react-native";
 import { generateNonce, hashNonce } from "../../../auth/infrastructure/services/crypto.util";
 import { executeOperation, failureResultFrom, toErrorInfo, ERROR_MESSAGES } from "../../../../shared/domain/utils";
-import { isCancelledError } from "../../../../shared/domain/utils/error-handler.util";
+import { isCancelledError } from "../../../../shared/domain/utils/error-handlers/error-checkers";
 import type {
   ReauthenticationResult,
   AuthProviderType,

package/src/domains/auth/infrastructure/config/FirebaseAuthClient.ts

@@ -5,7 +5,7 @@
  */
 
 import type { Auth } from 'firebase/auth';
-import { getFirebaseApp } from '../../../../shared/infrastructure/config/FirebaseClient';
+import { getFirebaseApp } from '../../../../shared/infrastructure/config/services/FirebaseInitializationService';
 import { FirebaseAuthInitializer } from './initializers/FirebaseAuthInitializer';
 import type { FirebaseAuthConfig } from '../../domain/value-objects/FirebaseAuthConfig';
 import { ServiceClientSingleton } from '../../../../shared/infrastructure/config/base/ServiceClientSingleton';

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

@@ -5,7 +5,7 @@
 
 import type { User, Auth } from 'firebase/auth';
 import { getFirebaseAuth } from '../config/FirebaseAuthClient';
-import { isValidString } from '../../../../shared/domain/utils/validation.util';
+import { isValidString } from '../../../../shared/domain/utils/validators/string.validator';
 
 export interface AuthCheckResult {
   isAuthenticated: boolean;

package/src/domains/firestore/index.ts

@@ -57,12 +57,6 @@ export type {
 } from './types/pagination.types';
 export { EMPTY_PAGINATED_RESULT } from './types/pagination.types';
 
-// Document Mapper
-export {
-  DocumentMapperHelper,
-  createDocumentMapper,
-} from './utils/document-mapper.helper';
-
 // Domain Constants
 export {
   FREE_TIER_LIMITS,
@@ -91,8 +85,10 @@ export { QuotaCalculator } from './domain/services/QuotaCalculator';
 export {
   isQuotaError,
   isRetryableError,
+} from '../../shared/domain/utils/error-handlers/error-checkers';
+export {
   getQuotaErrorMessage,
-} from './utils/quota-error-detector.util';
+} from '../../shared/domain/utils/error-handlers/error-messages';
 
 // Middleware
 export {

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

@@ -9,7 +9,7 @@
  */
 
 import type { Firestore } from 'firebase/firestore';
-import { getFirebaseApp } from '../../../../shared/infrastructure/config/FirebaseClient';
+import { getFirebaseApp } from '../../../../shared/infrastructure/config/services/FirebaseInitializationService';
 import { FirebaseFirestoreInitializer } from './initializers/FirebaseFirestoreInitializer';
 import { ServiceClientSingleton } from '../../../../shared/infrastructure/config/base/ServiceClientSingleton';
 

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

@@ -10,7 +10,7 @@
 
 import type { Firestore, CollectionReference, DocumentReference, DocumentData } from 'firebase/firestore';
 import { getFirestore, collection, doc } from 'firebase/firestore';
-import { isQuotaError as checkQuotaError } from '../../utils/quota-error-detector.util';
+import { isQuotaError as checkQuotaError } from '../../../../shared/domain/utils/error-handlers/error-checkers';
 import { ERROR_MESSAGES } from '../../../../shared/domain/utils/error-handlers/error-messages';
 import { quotaTrackingMiddleware } from '../middleware/QuotaTrackingMiddleware';
 

package/src/index.ts

@@ -2,12 +2,6 @@
  * React Native Firebase - Unified Package
  *
  * Domain-Driven Design (DDD) Architecture
- *
- * Core exports - App initialization and shared utilities
- *
- * Module-specific exports available via:
- * - @umituz/react-native-firebase/auth
- * - @umituz/react-native-firebase/firestore
  */
 
 // Core Errors
@@ -30,15 +24,18 @@ export {
   isFirebaseInitialized,
   getFirebaseInitializationError,
   resetFirebaseClient,
-  firebaseClient,
-} from "./shared/infrastructure/config/FirebaseClient";
+} from "./shared/infrastructure/config/services/FirebaseInitializationService";
 
 export type {
-  FirebaseApp,
   AuthInitializer,
   ServiceInitializationOptions,
   ServiceInitializationResult,
-} from "./shared/infrastructure/config/FirebaseClient";
+} from "./shared/infrastructure/config/services/FirebaseInitializationService";
+
+export type { FirebaseApp } from "./shared/infrastructure/config/initializers/FirebaseAppInitializer";
+
+import { FirebaseClientSingleton } from "./shared/infrastructure/config/clients/FirebaseClientSingleton";
+export const firebaseClient = FirebaseClientSingleton.getInstance();
 
 // Type Guards
 export {
@@ -56,40 +53,16 @@ export {
 export * from "./domains/auth";
 export * from "./domains/account-deletion";
 
-
-
 // Firestore Module Exports
-export {
-  BaseRepository,
-  BaseQueryRepository,
-  BasePaginatedRepository,
-} from "./domains/firestore";
 export * from "./domains/firestore";
-export { Timestamp } from "firebase/firestore";
 export type {
   Transaction,
   DocumentReference,
-  CollectionReference,
   WriteBatch,
   DocumentSnapshot,
   QuerySnapshot,
-  QueryDocumentSnapshot,
-  DocumentData,
-  Firestore,
 } from "firebase/firestore";
 
-// Firestore Helper Utilities
-export {
-  withFirestore,
-  withFirestoreVoid,
-  withFirestoreBool,
-  createErrorResult,
-  createSuccessResult,
-  runTransaction,
-  serverTimestamp,
-} from "./domains/firestore/utils/firestore-helper";
-export type { NoDbResult } from "./domains/firestore/utils/firestore-helper";
-
 // Init Module Factory
 export {
   createFirebaseInitModule,

package/src/init/createFirebaseInitModule.ts

@@ -4,7 +4,7 @@
  */
 
 import type { InitModule } from '@umituz/react-native-design-system';
-import { initializeAllFirebaseServices } from '../shared/infrastructure/config/FirebaseClient';
+import { initializeAllFirebaseServices } from '../shared/infrastructure/config/services/FirebaseInitializationService';
 
 export interface FirebaseInitModuleConfig {
   /**

package/src/shared/domain/utils/executors/advanced-executors.util.ts

@@ -3,8 +3,8 @@
  * Retry and timeout support for async operations
  */
 
-import type { Result } from '../result.util';
-import { failureResultFromError, successResult } from '../result.util';
+import type { Result } from '../result/result-types';
+import { failureResultFromError, successResult } from '../result/result-creators';
 import { executeOperation } from './basic-executors.util';
 
 /**

package/src/shared/domain/utils/executors/basic-executors.util.ts

@@ -3,8 +3,8 @@
  * Core async operation execution with error handling
  */
 
-import type { Result } from '../result.util';
-import { successResult } from '../result.util';
+import type { Result } from '../result/result-types';
+import { successResult } from '../result/result-creators';
 import { toErrorInfo } from '../error-handlers/error-converters';
 
 /**

package/src/shared/domain/utils/executors/batch-executors.util.ts

@@ -1,5 +1,6 @@
-import type { Result } from '../result.util';
-import { failureResultFromError, successResult, isSuccess, isFailure } from '../result.util';
+import type { Result } from '../result/result-types';
+import { failureResultFromError, successResult } from '../result/result-creators';
+import { isSuccess, isFailure } from '../result/result-helpers';
 
 export async function executeAll<T>(
   ...operations: (() => Promise<Result<T>>)[]

package/src/shared/domain/utils/index.ts

@@ -3,22 +3,28 @@
  * Centralized utilities for domain operations
  */
 
-// Result types
+// Result types and helpers
+export type {
+  Result,
+  SuccessResult,
+  FailureResult,
+  ErrorInfo,
+} from './result/result-types';
+
 export {
   successResult,
   failureResult,
   failureResultFrom,
   failureResultFromError,
+} from './result/result-creators';
+
+export {
   isSuccess,
   isFailure,
   getDataOrDefault,
   mapResult,
   chainResults,
-  type Result,
-  type SuccessResult,
-  type FailureResult,
-  type ErrorInfo,
-} from './result.util';
+} from './result/result-helpers';
 
 // Async operation execution
 export {
@@ -52,8 +58,9 @@ export {
 } from './credential.util';
 
 // Error handling
+export { toErrorInfo } from './error-handlers/error-converters';
+
 export {
-  toErrorInfo,
   hasErrorCode,
   isCancelledError,
   isQuotaErrorInfo,
@@ -61,14 +68,12 @@ export {
   isAuthError,
   isQuotaError,
   isRetryableError,
-  getQuotaErrorMessage,
-  getRetryableErrorMessage,
-  type ErrorInfo as ErrorHandlerErrorInfo,
-} from './error-handler.util';
+} from './error-handlers/error-checkers';
 
-// Error messages
 export {
   ERROR_MESSAGES,
+  getQuotaErrorMessage,
+  getRetryableErrorMessage,
 } from './error-handlers/error-messages';
 
 // Type guards
@@ -82,18 +87,28 @@ export {
 export {
   isValidString,
   isEmptyString,
+  isDefined,
+} from './validators/string.validator';
+
+export {
   isValidFirebaseApiKey,
   isValidFirebaseAuthDomain,
   isValidFirebaseProjectId,
+} from './validators/firebase.validator';
+
+export {
   isValidUrl,
   isValidHttpsUrl,
-  isValidEmail,
-  isDefined,
+} from './validators/url.validator';
+
+export { isValidEmail } from './validators/user-input.validator';
+
+export {
   isNonEmptyArray,
   isInRange,
   isPositive,
   isNonNegative,
-} from './validation.util';
+} from './validators/generic.validator';
 
 // ID generation
 export {

package/src/shared/infrastructure/config/FirebaseConfigLoader.ts

@@ -7,11 +7,8 @@
  */
 
 import type { FirebaseConfig } from '../../domain/value-objects/FirebaseConfig';
-import {
-  isValidString,
-  isValidFirebaseApiKey,
-  isValidFirebaseAuthDomain,
-} from '../../domain/utils/validation.util';
+import { isValidString } from '../../domain/utils/validators/string.validator';
+import { isValidFirebaseApiKey, isValidFirebaseAuthDomain } from '../../domain/utils/validators/firebase.validator';
 
 type ConfigKey = 'apiKey' | 'authDomain' | 'projectId' | 'storageBucket' | 'messagingSenderId' | 'appId';
 

package/src/shared/infrastructure/config/validators/FirebaseConfigValidator.ts

@@ -7,7 +7,8 @@
 
 import type { FirebaseConfig } from '../../../domain/value-objects/FirebaseConfig';
 import { FirebaseConfigurationError } from '../../../domain/errors/FirebaseError';
-import { isValidString, isValidFirebaseApiKey, isValidFirebaseProjectId, isValidFirebaseAuthDomain } from '../../../domain/utils/validation.util';
+import { isValidString } from '../../../domain/utils/validators/string.validator';
+import { isValidFirebaseApiKey, isValidFirebaseProjectId, isValidFirebaseAuthDomain } from '../../../domain/utils/validators/firebase.validator';
 
 /**
  * Validation rule interface

package/src/domains/firestore/utils/document-mapper.helper.ts

@@ -1,153 +0,0 @@
-/**
- * Document Mapper Helper
- *
- * Utilities for batch document processing with enrichment.
- * Handles document extraction, validation, and enrichment with related data.
- *
- * App-agnostic: Works with any document type and any enrichment logic.
- *
- * @example
- * ```typescript
- * import { DocumentMapperHelper } from '@umituz/react-native-firestore';
- *
- * const mapper = new DocumentMapperHelper<Post, User, EnrichedPost>();
- * const enriched = await mapper.mapWithEnrichment(
- *   postDocs,
- *   post => extractPost(post),
- *   post => post.userId,
- *   userId => userRepo.getById(userId),
- *   (post, user) => ({ ...post, user })
- * );
- * ```
- */
-
-import type { QueryDocumentSnapshot, DocumentData } from 'firebase/firestore';
-import { mapDocuments } from './mapper/base-mapper.util';
-import { mapWithEnrichment, mapWithBatchEnrichment } from './mapper/enrichment-mapper.util';
-import { mapWithMultipleEnrichments } from './mapper/multi-enrichment-mapper.util';
-
-export class DocumentMapperHelper<TSource, TEnrichment, TResult> {
-  /**
-   * Map documents with enrichment from related data
-   *
-   * Process flow:
-   * 1. Extract source data from document
-   * 2. Skip if extraction fails or source is invalid
-   * 3. Get enrichment key from source
-   * 4. Fetch enrichment data using the key
-   * 5. Skip if enrichment data not found
-   * 6. Combine source and enrichment into result
-   *
-   * @param docs - Firestore document snapshots
-   * @param extractSource - Extract source data from document
-   * @param getEnrichmentKey - Get enrichment key from source
-   * @param fetchEnrichment - Fetch enrichment data by key
-   * @param combineData - Combine source and enrichment into result
-   * @returns Array of enriched results
-   */
-  async mapWithEnrichment(
-    docs: QueryDocumentSnapshot<DocumentData>[],
-    extractSource: (doc: QueryDocumentSnapshot<DocumentData>) => TSource | null,
-    getEnrichmentKey: (source: TSource) => string,
-    fetchEnrichment: (key: string) => Promise<TEnrichment | null>,
-    combineData: (source: TSource, enrichment: TEnrichment) => TResult,
-  ): Promise<TResult[]> {
-    return mapWithEnrichment(
-      docs,
-      extractSource,
-      getEnrichmentKey,
-      fetchEnrichment,
-      combineData,
-    );
-  }
-
-  /**
-   * Map documents with batch enrichment (fetch all enrichments at once)
-   *
-   * More efficient than mapWithEnrichment when dealing with multiple documents.
-   *
-   * @param docs - Firestore document snapshots
-   * @param extractSource - Extract source data from document
-   * @param getEnrichmentKey - Get enrichment key from source
-   * @param fetchBatchEnrichments - Fetch all enrichments by keys in batch
-   * @param combineData - Combine source and enrichment into result
-   * @returns Array of enriched results
-   */
-  async mapWithBatchEnrichment(
-    docs: QueryDocumentSnapshot<DocumentData>[],
-    extractSource: (doc: QueryDocumentSnapshot<DocumentData>) => TSource | null,
-    getEnrichmentKey: (source: TSource) => string,
-    fetchBatchEnrichments: (keys: string[]) => Promise<Map<string, TEnrichment>>,
-    combineData: (source: TSource, enrichment: TEnrichment) => TResult,
-  ): Promise<TResult[]> {
-    return mapWithBatchEnrichment(
-      docs,
-      extractSource,
-      getEnrichmentKey,
-      fetchBatchEnrichments,
-      combineData,
-    );
-  }
-
-  /**
-   * Map documents with multiple enrichments
-   *
-   * Similar to mapWithEnrichment but supports multiple enrichment sources.
-   * Useful when result needs data from multiple related collections.
-   *
-   * @param docs - Firestore document snapshots
-   * @param extractSource - Extract source data from document
-   * @param getEnrichmentKeys - Get all enrichment keys from source
-   * @param fetchEnrichments - Fetch all enrichment data by keys
-   * @param combineData - Combine source and enrichments into result
-   * @returns Array of enriched results
-   */
-  async mapWithMultipleEnrichments<TEnrichments extends Record<string, unknown>>(
-    docs: QueryDocumentSnapshot<DocumentData>[],
-    extractSource: (doc: QueryDocumentSnapshot<DocumentData>) => TSource | null,
-    getEnrichmentKeys: (source: TSource) => Record<string, string>,
-    fetchEnrichments: (keys: Record<string, string>) => Promise<TEnrichments | null>,
-    combineData: (source: TSource, enrichments: TEnrichments) => TResult,
-  ): Promise<TResult[]> {
-    return mapWithMultipleEnrichments(
-      docs,
-      extractSource,
-      getEnrichmentKeys,
-      fetchEnrichments,
-      combineData,
-    );
-  }
-
-  /**
-   * Simple document mapping without enrichment
-   *
-   * @param docs - Firestore document snapshots
-   * @param extractData - Extract data from document
-   * @returns Array of extracted data (nulls filtered out)
-   */
-  map(
-    docs: QueryDocumentSnapshot<DocumentData>[],
-    extractData: (doc: QueryDocumentSnapshot<DocumentData>) => TResult | null,
-  ): TResult[] {
-    return mapDocuments(docs, extractData);
-  }
-}
-
-/**
- * Create document mapper helper
- *
- * @returns DocumentMapperHelper instance
- *
- * @example
- * ```typescript
- * const mapper = createDocumentMapper<Post, User, EnrichedPost>();
- * const enriched = await mapper.mapWithEnrichment(...);
- * ```
- */
-export function createDocumentMapper<
-  TSource,
-  TEnrichment,
-  TResult,
->(): DocumentMapperHelper<TSource, TEnrichment, TResult> {
-  return new DocumentMapperHelper<TSource, TEnrichment, TResult>();
-}

package/src/domains/firestore/utils/mapper/base-mapper.util.ts

@@ -1,42 +0,0 @@
-/**
- * Base Mapper Utility
- * Core document mapping functionality
- */
-
-import type { QueryDocumentSnapshot, DocumentData } from 'firebase/firestore';
-
-/**
- * Simple document mapping without enrichment
- */
-export function mapDocuments<T>(
-  docs: QueryDocumentSnapshot<DocumentData>[],
-  extractData: (doc: QueryDocumentSnapshot<DocumentData>) => T | null,
-): T[] {
-  const results: T[] = [];
-
-  for (const doc of docs) {
-    const data = extractData(doc);
-    if (data != null) {
-      results.push(data);
-    }
-  }
-
-  return results;
-}
-
-/**
- * Filter out null values from array
- */
-export function filterNull<T>(items: (T | null)[]): T[] {
-  return items.filter((item): item is T => item != null);
-}
-
-/**
- * Safe document extraction with null check
- */
-export function extractDocumentData<T>(
-  doc: QueryDocumentSnapshot<DocumentData>,
-  extractor: (doc: QueryDocumentSnapshot<DocumentData>) => T | null
-): T | null {
-  return extractor(doc);
-}

package/src/domains/firestore/utils/mapper/multi-enrichment-mapper.util.ts

@@ -1,39 +0,0 @@
-/**
- * Multiple Enrichment Mapper Utility
- * Document mapping with multiple enrichment sources
- */
-
-import type { QueryDocumentSnapshot, DocumentData } from 'firebase/firestore';
-
-/**
- * Map documents with multiple enrichments
- *
- * Similar to mapWithEnrichment but supports multiple enrichment sources.
- * Useful when result needs data from multiple related collections.
- */
-export async function mapWithMultipleEnrichments<
-  TSource,
-  TEnrichments extends Record<string, unknown>,
-  TResult
->(
-  docs: QueryDocumentSnapshot<DocumentData>[],
-  extractSource: (doc: QueryDocumentSnapshot<DocumentData>) => TSource | null,
-  getEnrichmentKeys: (source: TSource) => Record<string, string>,
-  fetchEnrichments: (keys: Record<string, string>) => Promise<TEnrichments | null>,
-  combineData: (source: TSource, enrichments: TEnrichments) => TResult,
-): Promise<TResult[]> {
-  const results: TResult[] = [];
-
-  for (const doc of docs) {
-    const source = extractSource(doc);
-    if (!source) continue;
-
-    const enrichmentKeys = getEnrichmentKeys(source);
-    const enrichments = await fetchEnrichments(enrichmentKeys);
-    if (!enrichments) continue;
-
-    results.push(combineData(source, enrichments));
-  }
-
-  return results;
-}

package/src/domains/firestore/utils/quota-error-detector.util.ts

@@ -1,13 +0,0 @@
-/**
- * Quota Error Detection Utilities
- *
- * Re-exports centralized quota error detection from error-handler.util.ts
- * This maintains backwards compatibility while using a single source of truth.
- */
-
-export {
-  isQuotaError,
-  isRetryableError,
-  getQuotaErrorMessage,
-  getRetryableErrorMessage,
-} from '../../../shared/domain/utils/error-handler.util';

package/src/shared/infrastructure/config/FirebaseClient.ts

@@ -1,28 +0,0 @@
-/**
- * FirebaseClient - Barrel re-export
- * Aggregates exports from refactored sub-modules for backward compatibility
- */
-
-// Functions
-export {
-  initializeFirebase,
-  getFirebaseApp,
-  autoInitializeFirebase,
-  initializeAllFirebaseServices,
-  isFirebaseInitialized,
-  getFirebaseInitializationError,
-  resetFirebaseClient,
-} from './services/FirebaseInitializationService';
-
-// Types
-export type {
-  AuthInitializer,
-  ServiceInitializationOptions,
-  ServiceInitializationResult,
-} from './services/FirebaseInitializationService';
-
-export type { FirebaseApp } from './initializers/FirebaseAppInitializer';
-
-// Singleton instance
-import { FirebaseClientSingleton } from './clients/FirebaseClientSingleton';
-export const firebaseClient = FirebaseClientSingleton.getInstance();