@umituz/react-native-firebase 1.14.4 → 2.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "1.14.4",
+  "version": "2.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/account-deletion/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Account Deletion Domain
+ * Handles Firebase account deletion with reauthentication
+ */
+
+export {
+  deleteCurrentUser,
+  deleteUserAccount,
+} from './infrastructure/services/account-deletion.service';
+
+export type {
+  AccountDeletionResult,
+} from './infrastructure/services/account-deletion.service';
+
+export type {
+  AccountDeletionOptions,
+  ReauthenticationResult,
+  AuthProviderType,
+  ReauthCredentialResult,
+} from './application/ports/reauthentication.types';
+
+export {
+  getUserAuthProvider,
+  reauthenticateWithPassword,
+  reauthenticateWithGoogle,
+  reauthenticateWithApple,
+  getAppleReauthCredential,
+} from './infrastructure/services/reauthentication.service';

package/src/{auth → domains/account-deletion}/infrastructure/services/account-deletion.service.ts

@@ -4,21 +4,21 @@
  */
 
 import { deleteUser, type User } from "firebase/auth";
-import { getFirebaseAuth } from "../config/FirebaseAuthClient";
+import { getFirebaseAuth } from "../../../auth/infrastructure/config/FirebaseAuthClient";
 import {
   getUserAuthProvider,
   reauthenticateWithApple,
   reauthenticateWithPassword,
   reauthenticateWithGoogle,
 } from "./reauthentication.service";
-import { successResult, type Result } from "../../../domain/utils";
-import type { AccountDeletionOptions } from "./reauthentication.types";
+import { successResult, type Result } from "../../../../shared/domain/utils";
+import type { AccountDeletionOptions } from "../../application/ports/reauthentication.types";
 
 export interface AccountDeletionResult extends Result<void> {
   requiresReauth?: boolean;
 }
 
-export type { AccountDeletionOptions } from "./reauthentication.types";
+export type { AccountDeletionOptions } from "../../application/ports/reauthentication.types";
 
 export async function deleteCurrentUser(
   options: AccountDeletionOptions = { autoReauthenticate: true }

package/src/{auth → domains/account-deletion}/infrastructure/services/reauthentication.service.ts

@@ -12,20 +12,20 @@ import {
 } from "firebase/auth";
 import * as AppleAuthentication from "expo-apple-authentication";
 import { Platform } from "react-native";
-import { generateNonce, hashNonce } from "./crypto.util";
-import { executeOperation, failureResultFrom } from "../../../domain/utils";
-import { isCancelledError } from "../../../domain/utils/error-handler.util";
+import { generateNonce, hashNonce } from "../../../auth/infrastructure/services/crypto.util";
+import { executeOperation, failureResultFrom } from "../../../../shared/domain/utils";
+import { isCancelledError } from "../../../../shared/domain/utils/error-handler.util";
 import type {
   ReauthenticationResult,
   AuthProviderType,
   ReauthCredentialResult
-} from "./reauthentication.types";
+} from "../../application/ports/reauthentication.types";
 
 export type {
   ReauthenticationResult,
   AuthProviderType,
   ReauthCredentialResult
-} from "./reauthentication.types";
+} from "../../application/ports/reauthentication.types";
 
 export function getUserAuthProvider(user: User): AuthProviderType {
   if (user.isAnonymous) return "anonymous";

package/src/{auth → domains/auth}/index.ts

@@ -74,27 +74,6 @@ export type {
   FirestoreQuerySkipReason,
 } from './infrastructure/services/firestore-utils.service';
 
-// Account Deletion
-export {
-  deleteCurrentUser,
-  deleteUserAccount,
-} from './infrastructure/services/account-deletion.service';
-
-export type { AccountDeletionResult, AccountDeletionOptions } from './infrastructure/services/account-deletion.service';
-
-// Reauthentication Service
-export {
-  getUserAuthProvider,
-  reauthenticateWithGoogle,
-  reauthenticateWithApple,
-  reauthenticateWithPassword,
-  getAppleReauthCredential,
-} from './infrastructure/services/reauthentication.service';
-
-export type {
-  ReauthenticationResult,
-  AuthProviderType,
-} from './infrastructure/services/reauthentication.service';
 
 // =============================================================================
 // INFRASTRUCTURE LAYER - Social Auth Services

package/src/{auth → domains/auth}/infrastructure/config/FirebaseAuthClient.ts

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

package/src/{auth → domains/auth}/infrastructure/services/apple-auth.service.ts

@@ -15,7 +15,7 @@ import type { AppleAuthResult } from "./apple-auth.types";
 import {
   isCancellationError,
 } from "./base/base-auth.service";
-import { executeAuthOperation, type Result } from "../../../domain/utils";
+import { executeAuthOperation, type Result } from "../../../../shared/domain/utils";
 
 // Conditional import - expo-apple-authentication is optional
 let AppleAuthentication: any = null;

package/src/{auth → domains/auth}/infrastructure/services/auth-listener.service.ts

@@ -5,8 +5,8 @@
 
 import { onIdTokenChanged, type User } from "firebase/auth";
 import { getFirebaseAuth } from "../config/FirebaseAuthClient";
-import type { Result } from "../../../domain/utils";
-import { failureResultFrom } from "../../../domain/utils";
+import type { Result } from "../../../../shared/domain/utils";
+import { failureResultFrom } from "../../../../shared/domain/utils";
 
 export interface AuthListenerConfig {
   /**

package/src/{auth → 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 '../../../domain/utils/validation.util';
+import { isValidString } from '../../../../shared/domain/utils/validation.util';
 
 export interface AuthCheckResult {
   isAuthenticated: boolean;

package/src/{auth → domains/auth}/infrastructure/services/base/base-auth.service.ts

@@ -6,7 +6,7 @@
  */
 
 import type { UserCredential } from 'firebase/auth';
-import { authErrorConverter, type Result } from '../../../../domain/utils';
+import { authErrorConverter, type Result } from '../../../../../shared/domain/utils';
 
 /**
  * Authentication result with user credential

package/src/{auth → domains/auth}/infrastructure/services/email-auth.service.ts

@@ -13,7 +13,7 @@ import {
   type User,
 } from "firebase/auth";
 import { getFirebaseAuth } from "../config/FirebaseAuthClient";
-import { executeOperation, failureResultFrom, successResult, type Result } from "../../../domain/utils";
+import { executeOperation, failureResultFrom, successResult, type Result } from "../../../../shared/domain/utils";
 
 export interface EmailCredentials {
   email: string;

package/src/{auth → domains/auth}/infrastructure/services/google-auth.service.ts

@@ -9,8 +9,8 @@ import {
   type Auth,
 } from "firebase/auth";
 import type { GoogleAuthConfig, GoogleAuthResult } from "./google-auth.types";
-import { executeAuthOperation, type Result } from "../../../domain/utils";
-import { ConfigurableService } from "../../../domain/utils/service-config.util";
+import { executeAuthOperation, type Result } from "../../../../shared/domain/utils";
+import { ConfigurableService } from "../../../../shared/domain/utils/service-config.util";
 
 /**
  * Google Auth Service

package/src/{auth → domains/auth}/infrastructure/services/password.service.ts

@@ -4,7 +4,7 @@
  */
 
 import { updatePassword, type User } from 'firebase/auth';
-import { executeAuthOperation, type Result } from '../../../domain/utils';
+import { executeAuthOperation, type Result } from '../../../../shared/domain/utils';
 
 /**
  * Result of a password update operation

package/src/{firestore → domains/firestore}/domain/errors/FirebaseFirestoreError.ts

@@ -4,7 +4,7 @@
  * Domain-Driven Design: Error types for Firestore operations
  */
 
-import { FirebaseError } from '../../../domain/errors/FirebaseError';
+import { FirebaseError } from '../../../../shared/domain/errors/FirebaseError';
 
 /**
  * Firestore Error

package/src/{firestore → domains/firestore}/infrastructure/config/FirestoreClient.ts

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

package/src/{firestore → domains/firestore}/infrastructure/services/RequestLoggerService.ts

@@ -4,7 +4,7 @@
  */
 
 import type { RequestLog, RequestStats, RequestType } from '../../domain/entities/RequestLog';
-import { generateUniqueId } from '../../../domain/utils/id-generator.util';
+import { generateUniqueId } from '../../../../shared/domain/utils/id-generator.util';
 
 export class RequestLoggerService {
   private logs: RequestLog[] = [];

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

@@ -10,4 +10,4 @@ export {
   isRetryableError,
   getQuotaErrorMessage,
   getRetryableErrorMessage,
-} from '../../domain/utils/error-handler.util';
+} from '../../../shared/domain/utils/error-handler.util';

package/src/{firestore → domains/firestore}/utils/transaction/transaction.util.ts

@@ -9,7 +9,7 @@ import {
   type Transaction,
 } from "firebase/firestore";
 import { getFirestore } from "../../infrastructure/config/FirestoreClient";
-import { hasCodeProperty } from "../../../domain/utils/type-guards.util";
+import { hasCodeProperty } from "../../../../shared/domain/utils/type-guards.util";
 
 /**
  * Execute a transaction with automatic DB instance check.

package/src/index.ts

@@ -15,10 +15,10 @@ export {
   FirebaseError,
   FirebaseInitializationError,
   FirebaseConfigurationError,
-} from "./domain/errors/FirebaseError";
+} from "./shared/domain/errors/FirebaseError";
 
 // Core Types
-export type { FirebaseConfig } from "./domain/value-objects/FirebaseConfig";
+export type { FirebaseConfig } from "./shared/domain/value-objects/FirebaseConfig";
 export type { IFirebaseClient } from "./application/ports/IFirebaseClient";
 
 // Core Client
@@ -31,14 +31,14 @@ export {
   getFirebaseInitializationError,
   resetFirebaseClient,
   firebaseClient,
-} from "./infrastructure/config/FirebaseClient";
+} from "./shared/infrastructure/config/FirebaseClient";
 
 export type {
   FirebaseApp,
   AuthInitializer,
   ServiceInitializationOptions,
   ServiceInitializationResult,
-} from "./infrastructure/config/FirebaseClient";
+} from "./shared/infrastructure/config/FirebaseClient";
 
 // Type Guards
 export {
@@ -50,10 +50,11 @@ export {
   isQuotaExceededError,
   getSafeErrorMessage,
   getSafeErrorCode,
-} from "./domain/guards/firebase-error.guard";
+} from "./shared/domain/guards/firebase-error.guard";
 
-// Auth Module Exports
-export * from "./auth";
+// Domain Exports
+export * from "./domains/auth";
+export * from "./domains/account-deletion";
 
 
 
@@ -62,8 +63,8 @@ export {
   BaseRepository,
   BaseQueryRepository,
   BasePaginatedRepository,
-} from "./firestore";
-export * from "./firestore";
+} from "./domains/firestore";
+export * from "./domains/firestore";
 export { Timestamp } from "firebase/firestore";
 export type {
   Transaction,
@@ -86,8 +87,8 @@ export {
   createSuccessResult,
   runTransaction,
   serverTimestamp,
-} from "./firestore/utils/firestore-helper";
-export type { FirestoreResult, NoDbResult } from "./firestore/utils/firestore-helper";
+} from "./domains/firestore/utils/firestore-helper";
+export type { FirestoreResult, NoDbResult } from "./domains/firestore/utils/firestore-helper";
 
 // Init Module Factory
 export {

package/src/init/createFirebaseInitModule.ts

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

package/src/{domain → shared/domain}/utils/credential.util.ts

@@ -11,7 +11,7 @@ import {
 } from 'firebase/auth';
 import * as AppleAuthentication from 'expo-apple-authentication';
 import { Platform } from 'react-native';
-import { generateNonce, hashNonce } from '../../auth/infrastructure/services/crypto.util';
+import { generateNonce, hashNonce } from '../../../domains/auth/infrastructure/services/crypto.util';
 
 /**
  * Generate Google credential from ID token

package/src/{infrastructure → shared/infrastructure}/config/clients/FirebaseClientSingleton.ts

@@ -4,7 +4,7 @@
  */
 
 import type { FirebaseConfig } from '../../../domain/value-objects/FirebaseConfig';
-import type { IFirebaseClient } from '../../../application/ports/IFirebaseClient';
+import type { IFirebaseClient } from '../../../../application/ports/IFirebaseClient';
 import type { FirebaseApp } from '../initializers/FirebaseAppInitializer';
 import { FirebaseClientState } from '../state/FirebaseClientState';
 import { FirebaseInitializationOrchestrator } from '../orchestrators/FirebaseInitializationOrchestrator';

package/src/auth/domain/errors/README.md

@@ -1,291 +0,0 @@
-# Auth Errors
-
-Firebase Authentication error types and error handling utilities.
-
-## Purpose
-
-Provides custom error classes for Firebase Authentication operations with structured error handling, type safety, and user-friendly error messages.
-
-## For AI Agents
-
-### Before Using Auth Errors
-
-1. **USE** custom error classes (not raw Firebase errors)
-2. **CHECK** error types with instanceof
-3. **PROVIDE** user-friendly error messages
-4. **HANDLE** retryable errors appropriately
-5. **LOG** errors for debugging
-
-### Required Practices
-
-1. **Use custom error classes** - Import from auth module
-2. **Check error types** - Use instanceof for type checking
-3. **Map error codes** - Convert to user-friendly messages
-4. **Handle retryable errors** - Implement retry logic
-5. **Log errors** - Include context for debugging
-
-### Forbidden Practices
-
-## ❌ NEVER
-
-- Throw primitive values (always Error instances)
-- Show technical error messages to users
-- Ignore error codes
-- Assume all errors are fatal
-- Catch and suppress errors silently
-
-## ⚠️ Avoid
-
-- Generic error handling
-- Not checking error types
-- Not providing user feedback
-- Missing error context
-- Not logging auth errors
-
-## Error Classes
-
-### FirebaseAuthError
-
-**Import From:** `@umituz/react-native-firebase/auth` or `src/auth/domain/errors`
-
-**Purpose:** Base error class for all Firebase Auth errors
-
-**Properties:**
-- `code: string` - Error code for programmatic handling
-- `message: string` - Human-readable error message
-
-**Usage:**
-- Base class for all auth errors
-- Type checking with instanceof
-- Error code for conditional logic
-
-**When to Use:**
-- Throwing custom auth errors
-- Catching and handling auth errors
-- Type-safe error handling
-
-### FirebaseAuthInitializationError
-
-**Import From:** `@umituz/react-native-firebase/auth` or `src/auth/domain/errors`
-
-**Purpose:** Error thrown when Firebase Auth fails to initialize
-
-**Extends:** FirebaseAuthError
-
-**Usage:**
-- Initialization failures
-- Configuration errors
-- Firebase setup issues
-
-**When to Use:**
-- Auth not initialized
-- Invalid Firebase config
-- Initialization timeout
-
-## Error Handling Strategies
-
-### For Auth Operation Errors
-
-**Strategy:** Catch and handle auth errors with user-friendly messages.
-
-**Import From:** `@umituz/react-native-firebase/auth` or `src/auth/domain/errors`
-
-**When to Use:**
-- Sign-in failures
-- Sign-up failures
-- Password reset failures
-- Email verification failures
-
-**Handling Strategy:**
-1. Wrap auth operation in try-catch
-2. Check error type with instanceof
-3. Map error code to user message
-4. Display error to user
-5. Provide retry option if appropriate
-6. Log technical error for debugging
-
-### For Initialization Errors
-
-**Strategy:** Handle Firebase Auth initialization failures.
-
-**Import From:** `@umituz/react-native-firebase/auth` or `src/auth/domain/errors`
-
-**When to Use:**
-- App startup
-- Auth service initialization
-- Configuration loading
-
-**Handling Strategy:**
-1. Catch initialization error
-2. Check if FirebaseAuthInitializationError
-3. Show setup error message
-4. Provide setup instructions
-5. Offer retry option
-
-### For Network Errors
-
-**Strategy:** Retry transient network failures.
-
-**Import From:** `@umituz/react-native-firebase/auth` or `src/auth/domain/errors`
-
-**When to Use:**
-- Network connection failed
-- Request timeout
-- Service unavailable
-
-**Handling Strategy:**
-1. Check error code for network issues
-2. Show network error message
-3. Provide retry button
-4. Implement retry with delay
-5. Limit retry attempts
-
-### For User-Facing Messages
-
-**Strategy:** Map error codes to user-friendly messages.
-
-**Import From:** Use error.code to map messages
-
-**Common Error Messages:**
-- `INVALID_CREDENTIALS` → "Invalid email or password"
-- `USER_NOT_FOUND` → "Account not found"
-- `WEAK_PASSWORD` → "Password is too weak"
-- `EMAIL_ALREADY_IN_USE` → "Email already registered"
-- `NETWORK_ERROR` → "Network error. Please check your connection"
-- `TOO_MANY_REQUESTS` → "Too many attempts. Please try again later"
-
-**Implementation:**
-1. Create error message mapper
-2. Map error codes to messages
-3. Display message to user
-4. Provide action buttons
-5. Handle retry scenarios
-
-## Error Codes Reference
-
-### Common Error Codes
-
-**Import From:** Error.code property
-
-| Error Code | Description | Retryable | User Message |
-|------------|-------------|-----------|--------------|
-| `INVALID_CREDENTIALS` | Invalid email or password | No | Invalid email or password |
-| `USER_NOT_FOUND` | User account not found | No | Account not found |
-| `WEAK_PASSWORD` | Password too weak | No | Password is too weak |
-| `EMAIL_ALREADY_IN_USE` | Email already registered | No | Email already registered |
-| `NETWORK_ERROR` | Network connection failed | Yes | Network error. Check connection |
-| `TIMEOUT` | Request timeout | Yes | Request timeout. Try again |
-| `TOO_MANY_REQUESTS` | Rate limit exceeded | Yes | Too many attempts. Wait |
-| `USER_DISABLED` | User account disabled | No | Account disabled |
-| `INVALID_EMAIL` | Invalid email format | No | Invalid email format |
-| `EMAIL_NOT_VERIFIED` | Email not verified | No | Please verify your email |
-
-## Common Mistakes to Avoid
-
-1. ❌ Not checking error types
-   - ✅ Use instanceof for type checking
-
-2. ❌ Showing technical messages to users
-   - ✅ Map error codes to user-friendly messages
-
-3. ❌ Not providing retry options
-   - ✅ Offer retry for retryable errors
-
-4. ❌ Not logging errors
-   - ✅ Log errors with context
-
-5. ❌ Generic error handling
-   - ✅ Handle specific error types
-
-## AI Agent Instructions
-
-### When Handling Auth Errors
-
-1. Wrap auth operations in try-catch
-2. Check error type with instanceof
-3. Map error code to user message
-4. Display user-friendly message
-5. Provide retry option if appropriate
-6. Log technical error for debugging
-
-### When Creating Error Messages
-
-1. Map error codes to messages
-2. Use clear, non-technical language
-3. Provide actionable next steps
-4. Keep messages concise
-5. Localize if needed
-
-### When Implementing Retry Logic
-
-1. Check if error is retryable
-2. Show retry button to user
-3. Implement retry with delay
-4. Limit retry attempts
-5. Show countdown if rate limited
-
-## Code Quality Standards
-
-### Error Handling
-
-- Always use custom error classes
-- Check error types before handling
-- Provide user-friendly messages
-- Log errors with context
-- Handle specific error types
-
-### Type Safety
-
-- Use instanceof for type checking
-- Never use `any` for errors
-- Type all error parameters
-- Export error classes
-- Use discriminated unions
-
-### User Experience
-
-- Show clear error messages
-- Provide actionable next steps
-- Offer retry when appropriate
-- Don't show technical details
-- Test error flows
-
-## Performance Considerations
-
-### Error Logging
-
-- Log errors asynchronously
-- Don't block on logging
-- Include context (operation, userId)
-- Sanitize sensitive data
-- Use error tracking service
-
-### Retry Logic
-
-- Limit retry attempts
-- Use exponential backoff
-- Show retry progress
-- Don't retry non-retryable errors
-- Consider rate limiting
-
-## Related Documentation
-
-- [Auth Module README](../../README.md)
-- [Auth Services README](../infrastructure/services/README.md)
-- [Auth Stores README](../infrastructure/stores/README.md)
-
-## API Reference
-
-### Error Classes
-
-**Import Path:** `@umituz/react-native-firebase/auth` or `src/auth/domain/errors`
-
-| Class | Constructor Parameters | Description |
-|-------|----------------------|-------------|
-| `FirebaseAuthError` | `(message: string, code: string)` | Base auth error |
-| `FirebaseAuthInitializationError` | `(message: string)` | Init error |
-
----
-
-**Last Updated:** 2025-01-08
-**Maintainer:** Auth Module Team