@umituz/react-native-auth 4.3.51 → 4.3.52

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-auth",
-  "version": "4.3.51",
+  "version": "4.3.52",
   "description": "Authentication service for React Native apps - Secure, type-safe, and production-ready. Provider-agnostic design with dependency injection, configurable validation, and comprehensive error handling.",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/README.md

@@ -1,425 +0,0 @@
-# @umituz/react-native-auth
-
-Authentication service for React Native applications with secure, type-safe, and production-ready implementation.
-
----
-
-## Strategy
-
-**Purpose**: Provides comprehensive authentication solution for React Native apps with Domain-Driven Design architecture, supporting multiple authentication methods and providers.
-
-**When to Use**:
-- Building React Native apps requiring authentication
-- Need multiple auth methods (email, social, anonymous)
-- Want type-safe auth implementation
-- Prefer DDD architecture
-- Need production-ready auth solution
-
-**Package Location**: `/src`
-
-**Documentation**: See `/src/[layer]/README.md` for detailed documentation
-
----
-
-## Core Features
-
-### Authentication Methods
-
-**SUPPORTED METHODS**:
-- Email/Password authentication
-- Google OAuth integration
-- Apple Sign-In (iOS)
-- Anonymous user sessions
-- Account upgrade (anonymous → registered)
-
-### Architecture
-
-**DOMAIN-DRIVEN DESIGN LAYERS**:
-- **Domain**: Core business logic and entities
-- **Application**: Use cases and interfaces
-- **Infrastructure**: External integrations
-- **Presentation**: UI components and hooks
-
----
-
-## Installation
-
-### Package Installation
-
-**NPM**:
-```bash
-npm install @umituz/react-native-auth
-```
-
-**Yarn**:
-```bash
-yarn add @umituz/react-native-auth
-```
-
-### Peer Dependencies
-
-**REQUIRED PACKAGES**:
-- `firebase`: >= 11.0.0
-- `react`: >= 18.2.0
-- `react-native`: >= 0.74.0
-- `@tanstack/react-query`: >= 5.0.0
-- `zustand`: >= 4.0.0
-
-**EXTERNAL DEPENDENCIES**:
-- `@umituz/react-native-firebase` - Firebase integration
-- `@umituz/react-native-design-system` - UI components
-
----
-
-## Configuration
-
-### Firebase Setup
-
-**Rules**:
-- MUST create Firebase project
-- MUST enable Authentication
-- MUST enable Firestore (for user documents)
-- MUST configure OAuth providers
-
-**MUST NOT**:
-- Skip Firebase console setup
-- Use production keys in development
-- Forget to enable required providers
-
-**Steps**:
-1. Create Firebase project at console.firebase.google.com
-2. Enable Authentication
-3. Enable Google Sign-In
-4. Enable Apple Sign-In (for iOS)
-5. Enable Firestore
-6. Download config files
-
----
-
-## Layer Overview
-
-### Domain Layer
-
-**Location**: `src/domain/`
-
-**Purpose**: Core business logic and entities
-
-**CONTAINS**:
-- `AuthUser` entity
-- `UserProfile` entity
-- `AuthConfig` value object
-- `AuthError` hierarchy
-
-**Documentation**: `src/domain/README.md`
-
----
-
-### Application Layer
-
-**Location**: `src/application/`
-
-**Purpose**: Use cases and interfaces
-
-**CONTAINS**:
-- Authentication ports
-- User profile ports
-- Account management ports
-
-**Documentation**: `src/application/README.md`
-
----
-
-### Infrastructure Layer
-
-**Location**: `src/infrastructure/`
-
-**Purpose**: External integrations and implementations
-
-**CONTAINS**:
-- Firebase Auth service
-- Firestore repositories
-- Validation utilities
-- Provider implementations
-
-**Documentation**:
-- `src/infrastructure/README.md`
-- `src/infrastructure/services/README.md`
-
----
-
-### Presentation Layer
-
-**Location**: `src/presentation/`
-
-**Purpose**: UI components and hooks
-
-**CONTAINS**:
-- React hooks for auth
-- Pre-built components
-- Screen components
-- State management (Zustand)
-
-**Documentation**:
-- `src/presentation/README.md`
-- `src/presentation/hooks/README.md`
-- `src/presentation/components/README.md`
-- `src/presentation/screens/README.md`
-
----
-
-## Usage Guidelines
-
-### Authentication Hooks
-
-**PRIMARY HOOK**: `useAuth`
-**Location**: `src/presentation/hooks/useAuth.ts`
-
-**When to Use**:
-- Need authentication state
-- Require user information
-- Performing auth operations
-- Checking auth status
-
-**Import Path**:
-```typescript
-import { useAuth } from '@umituz/react-native-auth';
-```
-
-**Rules**:
-- MUST initialize AuthProvider before use
-- MUST handle loading state
-- MUST check auth readiness
-- MUST handle errors appropriately
-
----
-
-### Components
-
-**AVAILABLE COMPONENTS**:
-- `LoginForm` - Email/password login
-- `RegisterForm` - User registration
-- `SocialLoginButtons` - Google/Apple buttons
-- `ProfileSection` - Profile display
-- `AccountActions` - Account management
-
-**Import Path**:
-```typescript
-import {
-  LoginForm,
-  RegisterForm,
-  SocialLoginButtons
-} from '@umituz/react-native-auth';
-```
-
-**Rules**:
-- MUST follow component documentation
-- MUST provide required props
-- MUST handle events appropriately
-- MUST NOT override internal logic
-
----
-
-## Platform Support
-
-### Supported Platforms
-
-**iOS**: ✅ Full support
-- All authentication methods
-- Apple Sign-In available
-- Google Sign-In available
-
-**Android**: ✅ Full support
-- All authentication methods (except Apple)
-- Google Sign-In available
-
-**Web**: ✅ Full support
-- All authentication methods (except Apple)
-- Google Sign-In available
-
----
-
-## Security Requirements
-
-### Rules
-
-**MUST**:
-- Validate all inputs
-- Use HTTPS for all operations
-- Implement proper error handling
-- Follow Firebase security best practices
-- Use secure token storage
-- Validate tokens server-side
-
-**MUST NOT**:
-- Store tokens in AsyncStorage
-- Log passwords or tokens
-- Expose sensitive data in errors
-- Skip validation
-- Use HTTP for auth operations
-
----
-
-## Architecture Principles
-
-### Domain-Driven Design
-
-**PRINCIPLES**:
-- Business logic in domain layer
-- Infrastructure concerns isolated
-- Presentation layer UI-focused
-- Application layer orchestrates
-
-**BENEFITS**:
-- Testable business logic
-- Swappable providers
-- Clear separation of concerns
-- Maintainable codebase
-
----
-
-## Error Handling
-
-### Strategy
-
-**Purpose**: Comprehensive error handling throughout application.
-
-**Rules**:
-- MUST handle auth errors gracefully
-- MUST show user-friendly messages
-- MUST allow retry after failures
-- MUST log errors for debugging
-- MUST not expose sensitive data
-
-**Error Hierarchy**:
-- `AuthError` - Base error class
-- `ValidationError` - Input validation errors
-- `AuthenticationError` - Auth operation errors
-- `NetworkError` - Network issues
-
----
-
-## Validation Strategy
-
-### Purpose
-
-**Purpose**: Ensure data integrity and security.
-
-**Rules**:
-- MUST validate email format
-- MUST validate password complexity
-- MUST validate required fields
-- MUST provide clear error messages
-- MUST prevent invalid submissions
-
-**Validation Location**: `src/infrastructure/utils/AuthValidation.ts`
-
----
-
-## Migration Guide
-
-### From Previous Versions
-
-**Breaking Changes**:
-- See changelog for details
-- Follow migration steps
-- Update component props
-- Update hook usage
-
-**Rules**:
-- MUST read migration guide
-- MUST test thoroughly after upgrade
-- MUST update dependencies
-- MUST check deprecated features
-
----
-
-## Performance Considerations
-
-### Optimization
-
-**Rules**:
-- MUST memoize expensive computations
-- MUST minimize re-renders
-- MUST optimize state updates
-- MUST use efficient selectors
-
-**Constraints**:
-- Auth state single source of truth
-- Minimal network requests
-- Efficient validation checks
-- Optimized component rendering
-
----
-
-## Testing Strategy
-
-### Unit Testing
-
-**WHAT TO TEST**:
-- Domain logic and entities
-- Validation utilities
-- Hook behavior
-- Component rendering
-
-**RULES**:
-- MUST test auth operations
-- MUST test validation
-- MUST test error handling
-- MUST mock Firebase dependencies
-
----
-
-## Contributing
-
-### Development Setup
-
-**RULES**:
-- MUST follow DDD principles
-- MUST maintain type safety
-- MUST update documentation
-- MUST add tests for new features
-- MUST follow existing patterns
-
-**MUST NOT**:
-- Break DDD layer boundaries
-- Skip documentation
-- Add code without tests
-- Introduce breaking changes without major version bump
-
----
-
-## License
-
-MIT License - See LICENSE file for details
-
----
-
-## Support and Documentation
-
-### Documentation Structure
-
-**MAIN README**: This file
-
-**LAYER DOCUMENTATION**:
-- `src/domain/README.md` - Domain layer details
-- `src/application/README.md` - Application layer details
-- `src/infrastructure/README.md` - Infrastructure details
-- `src/presentation/README.md` - Presentation layer details
-
-**COMPONENT/HOOK DOCUMENTATION**:
-- Each component has dedicated .md file
-- Each hook has dedicated .md file
-- Follows Strategy/Rules/Constraints format
-
-### Getting Help
-
-- Read documentation first
-- Check existing issues
-- Review examples in docs
-- Follow AI agent guidelines
-
----
-
-## Changelog
-
-See CHANGELOG.md for version history and changes.

package/src/__tests__/services/AnonymousModeService.test.ts

@@ -1,53 +0,0 @@
-import { AnonymousModeService } from '../../infrastructure/services/AnonymousModeService';
-import type { IStorageProvider } from '../../infrastructure/services/AuthPackage';
-
-describe('AnonymousModeService', () => {
-  let anonymousModeService: AnonymousModeService;
-  let mockStorageProvider: jest.Mocked<IStorageProvider>;
-
-  beforeEach(() => {
-    mockStorageProvider = { get: jest.fn(), set: jest.fn(), remove: jest.fn() };
-    anonymousModeService = new AnonymousModeService('@test_anonymous_mode');
-  });
-
-  describe('configuration', () => {
-    it('should use storage keys correctly', () => {
-      const service = new AnonymousModeService('@custom');
-      expect(service.getIsAnonymousMode()).toBe(false);
-    });
-  });
-
-  describe('persistence', () => {
-    it('should load state from storage', async () => {
-      mockStorageProvider.get.mockResolvedValue('true');
-      const result = await anonymousModeService.load(mockStorageProvider);
-      expect(result).toBe(true);
-      expect(anonymousModeService.getIsAnonymousMode()).toBe(true);
-    });
-
-    it('should handle missing storage state', async () => {
-      mockStorageProvider.get.mockResolvedValue(null);
-      expect(await anonymousModeService.load(mockStorageProvider)).toBe(false);
-    });
-
-    it('should save state to storage', async () => {
-      anonymousModeService.setAnonymousMode(true);
-      await anonymousModeService.save(mockStorageProvider);
-      expect(mockStorageProvider.set).toHaveBeenCalledWith('@test_anonymous_mode', 'true');
-    });
-
-    it('should clear state from storage', async () => {
-      await anonymousModeService.clear(mockStorageProvider);
-      expect(anonymousModeService.getIsAnonymousMode()).toBe(false);
-      expect(mockStorageProvider.remove).toHaveBeenCalledWith('@test_anonymous_mode');
-    });
-  });
-
-  describe('auth integration', () => {
-    it('should enable anonymous mode', async () => {
-      mockStorageProvider.set.mockResolvedValue(undefined);
-      await anonymousModeService.enable(mockStorageProvider);
-      expect(anonymousModeService.getIsAnonymousMode()).toBe(true);
-    });
-  });
-});

package/src/__tests__/services/AuthCoreInitialization.test.ts

@@ -1,45 +0,0 @@
-import { AuthCoreService } from '../../../src/infrastructure/services/AuthCoreService';
-import { DEFAULT_AUTH_CONFIG } from '../../../src/domain/value-objects/AuthConfig';
-import type { IAuthProvider } from '../../../src/application/ports/IAuthProvider';
-
-describe('AuthCoreInitialization', () => {
-  let authCoreService: AuthCoreService;
-  let mockProvider: jest.Mocked<IAuthProvider>;
-
-  beforeEach(() => {
-    mockProvider = {
-      initialize: jest.fn(),
-      isInitialized: jest.fn().mockReturnValue(true),
-      signIn: jest.fn(),
-      signUp: jest.fn(),
-      signOut: jest.fn(),
-      getCurrentUser: jest.fn(),
-      onAuthStateChange: jest.fn().mockReturnValue(jest.fn()),
-    };
-    authCoreService = new AuthCoreService(DEFAULT_AUTH_CONFIG);
-  });
-
-  it('should initialize with provided config', () => {
-    const customConfig = { ...DEFAULT_AUTH_CONFIG, password: { ...DEFAULT_AUTH_CONFIG.password, minLength: 12 } };
-    const service = new AuthCoreService(customConfig);
-    expect(service.getConfig()).toEqual(customConfig);
-  });
-
-  it('should initialize with IAuthProvider', async () => {
-    await authCoreService.initialize(mockProvider);
-    expect(mockProvider.initialize).toHaveBeenCalled();
-  });
-
-  it('should throw error when no provider provided', async () => {
-    await expect(authCoreService.initialize(null as any)).rejects.toThrow();
-  });
-
-  it('should return false when not initialized', () => {
-    expect(authCoreService.isInitialized()).toBe(false);
-  });
-
-  it('should return true when initialized', async () => {
-    await authCoreService.initialize(mockProvider);
-    expect(authCoreService.isInitialized()).toBe(true);
-  });
-});

package/src/__tests__/services/AuthCoreOperations.test.ts

@@ -1,71 +0,0 @@
-import { AuthCoreService } from '../../../src/infrastructure/services/AuthCoreService';
-import { DEFAULT_AUTH_CONFIG } from '../../../src/domain/value-objects/AuthConfig';
-import type { IAuthProvider } from '../../../src/application/ports/IAuthProvider';
-import type { AuthUser } from '../../../src/domain/entities/AuthUser';
-
-describe('AuthCoreOperations', () => {
-  let authCoreService: AuthCoreService;
-  let mockProvider: jest.Mocked<IAuthProvider>;
-  const mockUser: AuthUser = {
-    uid: 'test-uid',
-    email: 'test@example.com',
-    displayName: 'Test User',
-    isAnonymous: false,
-    emailVerified: false,
-    photoURL: null,
-  };
-
-  beforeEach(async () => {
-    mockProvider = {
-      initialize: jest.fn(),
-      isInitialized: jest.fn().mockReturnValue(true),
-      signIn: jest.fn(),
-      signUp: jest.fn(),
-      signOut: jest.fn(),
-      getCurrentUser: jest.fn(),
-      onAuthStateChange: jest.fn().mockReturnValue(jest.fn()),
-    };
-    authCoreService = new AuthCoreService(DEFAULT_AUTH_CONFIG);
-    await authCoreService.initialize(mockProvider);
-  });
-
-  describe('Auth Flow', () => {
-    it('should sign up successfully', async () => {
-      mockProvider.signUp.mockResolvedValue(mockUser);
-      const result = await authCoreService.signUp({ email: 'test@example.com', password: 'password123' });
-      expect(result).toEqual(mockUser);
-    });
-
-    it('should sign in successfully', async () => {
-      mockProvider.signIn.mockResolvedValue(mockUser);
-      const result = await authCoreService.signIn({ email: 'test@example.com', password: 'password123' });
-      expect(result).toEqual(mockUser);
-    });
-
-    it('should sign out successfully', async () => {
-      await authCoreService.signOut();
-      expect(mockProvider.signOut).toHaveBeenCalled();
-    });
-  });
-
-  describe('User State', () => {
-    it('should return current user', () => {
-      mockProvider.getCurrentUser.mockReturnValue(mockUser);
-      expect(authCoreService.getCurrentUser()).toEqual(mockUser);
-    });
-
-    it('should return null when no user', () => {
-      mockProvider.getCurrentUser.mockReturnValue(null);
-      expect(authCoreService.getCurrentUser()).toBeNull();
-    });
-
-    it('should subscribe to auth state changes', () => {
-      const callback = jest.fn();
-      const mockCleanup = jest.fn();
-      mockProvider.onAuthStateChange.mockReturnValue(mockCleanup);
-      const cleanup = authCoreService.onAuthStateChange(callback);
-      expect(mockProvider.onAuthStateChange).toHaveBeenCalledWith(callback);
-      expect(cleanup).toBe(mockCleanup);
-    });
-  });
-});

package/src/__tests__/utils/AuthDisplayNameValidation.test.ts

@@ -1,44 +0,0 @@
-import { validateDisplayName } from '../../../src/infrastructure/utils/AuthValidation';
-
-describe('AuthDisplayNameValidation', () => {
-  describe('validateDisplayName', () => {
-    it('should reject empty name', () => {
-      const result = validateDisplayName('');
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Name is required');
-    });
-
-    it('should reject whitespace-only name', () => {
-      const result = validateDisplayName('   ');
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Name is required');
-    });
-
-    it('should reject name that is too short', () => {
-      const result = validateDisplayName('A');
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Name must be at least 2 characters');
-    });
-
-    it('should accept name that meets minimum length', () => {
-      const result = validateDisplayName('Al');
-      expect(result.isValid).toBe(true);
-    });
-
-    it('should use custom minimum length', () => {
-      const result = validateDisplayName('Al', 3);
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Name must be at least 3 characters');
-    });
-
-    it('should trim whitespace', () => {
-      const result = validateDisplayName('  John Doe  ');
-      expect(result.isValid).toBe(true);
-    });
-
-    it('should accept name with special characters', () => {
-      const result = validateDisplayName('John-O\'Connor');
-      expect(result.isValid).toBe(true);
-    });
-  });
-});

package/src/__tests__/utils/AuthEmailValidation.test.ts

@@ -1,38 +0,0 @@
-import { validateEmail } from '../../../src/infrastructure/utils/AuthValidation';
-
-describe('AuthEmailValidation', () => {
-  describe('validateEmail', () => {
-    it('should reject empty email', () => {
-      const result = validateEmail('');
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Email is required');
-    });
-
-    it('should reject whitespace-only email', () => {
-      const result = validateEmail('   ');
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Email is required');
-    });
-
-    it('should reject invalid email format', () => {
-      const result = validateEmail('invalid-email');
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Please enter a valid email address');
-    });
-
-    it('should accept valid email format', () => {
-      const result = validateEmail('test@example.com');
-      expect(result.isValid).toBe(true);
-    });
-
-    it('should accept valid email with subdomain', () => {
-      const result = validateEmail('test@mail.example.com');
-      expect(result.isValid).toBe(true);
-    });
-
-    it('should trim whitespace', () => {
-      const result = validateEmail('  test@example.com  ');
-      expect(result.isValid).toBe(true);
-    });
-  });
-});

package/src/__tests__/utils/AuthPasswordValidation.test.ts

@@ -1,59 +0,0 @@
-import {
-  validatePasswordForLogin,
-  validatePasswordForRegister,
-  validatePasswordConfirmation,
-} from '../../../src/infrastructure/utils/AuthValidation';
-import { DEFAULT_PASSWORD_CONFIG } from '../../../src/domain/value-objects/AuthConfig';
-
-describe('AuthPasswordValidation', () => {
-  describe('validatePasswordForLogin', () => {
-    it('should reject empty password', () => {
-      const result = validatePasswordForLogin('');
-      expect(result.isValid).toBe(false);
-      expect(result.error).toBe('Password is required');
-    });
-
-    it('should accept any non-empty password', () => {
-      const result = validatePasswordForLogin('any');
-      expect(result.isValid).toBe(true);
-    });
-  });
-
-  describe('validatePasswordForRegister', () => {
-    const config = DEFAULT_PASSWORD_CONFIG;
-
-    it('should reject empty password', () => {
-      const result = validatePasswordForRegister('', config);
-      expect(result.isValid).toBe(false);
-      expect(result.requirements.hasMinLength).toBe(false);
-    });
-
-    it('should reject password that is too short', () => {
-      const result = validatePasswordForRegister('123', config);
-      expect(result.isValid).toBe(false);
-      expect(result.requirements.hasMinLength).toBe(false);
-    });
-
-    it('should accept password that meets length requirement', () => {
-      const result = validatePasswordForRegister('Password1!', config);
-      expect(result.isValid).toBe(true);
-    });
-  });
-
-  describe('validatePasswordConfirmation', () => {
-    it('should reject empty confirmation', () => {
-      const result = validatePasswordConfirmation('password', '');
-      expect(result.isValid).toBe(false);
-    });
-
-    it('should reject mismatched passwords', () => {
-      const result = validatePasswordConfirmation('password', 'different');
-      expect(result.isValid).toBe(false);
-    });
-
-    it('should accept matching passwords', () => {
-      const result = validatePasswordConfirmation('password', 'password');
-      expect(result.isValid).toBe(true);
-    });
-  });
-});