@umituz/react-native-auth 4.3.77 → 4.3.79

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-auth",
-  "version": "4.3.77",
+  "version": "4.3.79",
   "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/src/exports/domain.ts

@@ -0,0 +1,32 @@
+/**
+ * Domain Layer Exports
+ */
+
+export type { AuthUser, AuthProviderType } from '../domain/entities/AuthUser';
+export type { UserProfile, UpdateProfileParams } from '../domain/entities/UserProfile';
+export {
+  AuthError,
+  AuthInitializationError,
+  AuthConfigurationError,
+  AuthValidationError,
+  AuthNetworkError,
+  AuthUserNotFoundError,
+  AuthWrongPasswordError,
+  AuthEmailAlreadyInUseError,
+  AuthWeakPasswordError,
+  AuthInvalidEmailError,
+} from '../domain/errors/AuthError';
+export type {
+  AuthConfig,
+  PasswordConfig,
+  SocialAuthConfig,
+  SocialProviderConfig,
+  GoogleAuthConfig,
+  AppleAuthConfig,
+  SocialAuthProvider,
+} from '../domain/value-objects/AuthConfig';
+export {
+  DEFAULT_AUTH_CONFIG,
+  DEFAULT_PASSWORD_CONFIG,
+  DEFAULT_SOCIAL_CONFIG,
+} from '../domain/value-objects/AuthConfig';

package/src/exports/infrastructure.ts

@@ -0,0 +1,80 @@
+/**
+ * Infrastructure Layer Exports
+ */
+
+export type { AuthCredentials, SignUpCredentials } from '../infrastructure/repositories/AuthRepository';
+
+// Services
+export {
+  AuthService,
+  initializeAuthService,
+  getAuthService,
+  resetAuthService,
+} from '../infrastructure/services/AuthService';
+export {
+  initializeAuth,
+  isAuthInitialized,
+  resetAuthInitialization,
+} from '../infrastructure/services/initializeAuth';
+export type { InitializeAuthOptions } from '../infrastructure/services/initializeAuth';
+
+// Storage
+export type { IStorageProvider } from '../infrastructure/types/Storage.types';
+export {
+  createStorageProvider,
+  StorageProviderAdapter,
+} from '../infrastructure/adapters/StorageProviderAdapter';
+
+// Validation
+export {
+  validateEmail,
+  validatePasswordForLogin,
+  validatePasswordForRegister,
+  validatePasswordConfirmation,
+  validateDisplayName,
+} from '../infrastructure/utils/AuthValidation';
+export type {
+  ValidationResult,
+  PasswordStrengthResult,
+  PasswordRequirements,
+} from '../infrastructure/utils/AuthValidation';
+export type {
+  FormValidationError,
+  FormValidationResult,
+} from '../infrastructure/utils/validation/types';
+export {
+  SECURITY_LIMITS,
+  sanitizeEmail,
+  sanitizePassword,
+  sanitizeName,
+} from '../infrastructure/utils/validation/sanitization';
+export type { SecurityLimitKey } from '../infrastructure/utils/validation/sanitization';
+export {
+  isEmpty,
+  isEmptyEmail,
+  isEmptyPassword,
+  isEmptyName,
+  isNotEmpty,
+  hasContent,
+} from '../infrastructure/utils/validation/validationHelpers';
+export { safeCallback, safeCallbackSync } from '../infrastructure/utils/safeCallback';
+
+// Calculators
+export {
+  calculateUserId,
+  calculateHasFirebaseUser,
+  calculateIsAnonymous,
+  calculateIsAuthenticated,
+  calculateUserType,
+  calculateIsAuthReady,
+  calculateDerivedAuthState,
+  collectFieldErrors,
+  extractFieldError,
+  hasFieldErrors,
+  getFirstErrorMessage,
+  calculateUserProfileDisplay,
+  calculatePasswordRequirements,
+  calculatePasswordsMatch,
+  calculatePasswordValidation,
+  calculatePasswordStrength,
+} from '../infrastructure/utils/calculators';

package/src/exports/presentation.ts

@@ -0,0 +1,115 @@
+/**
+ * Presentation Layer Exports
+ */
+
+// Hooks
+export { useAuth } from '../presentation/hooks/useAuth';
+export type { UseAuthResult } from '../presentation/hooks/useAuth';
+export { useLoginForm } from '../presentation/hooks/useLoginForm';
+export type { UseLoginFormConfig, UseLoginFormResult } from '../presentation/hooks/useLoginForm';
+export { useRegisterForm } from '../presentation/hooks/useRegisterForm';
+export type {
+  UseRegisterFormConfig,
+  UseRegisterFormResult,
+} from '../presentation/hooks/useRegisterForm';
+export { useAuthRequired } from '../presentation/hooks/useAuthRequired';
+export { useRequireAuth, useUserId } from '../presentation/hooks/useRequireAuth';
+export { useUserProfile } from '../presentation/hooks/useUserProfile';
+export type {
+  UserProfileData,
+  UseUserProfileParams,
+} from '../presentation/hooks/useUserProfile';
+export { useAccountManagement } from '../presentation/hooks/useAccountManagement';
+export type {
+  UseAccountManagementReturn,
+  UseAccountManagementOptions,
+} from '../presentation/hooks/useAccountManagement';
+export { useAppleAuth } from '../presentation/hooks/useAppleAuth';
+export type { UseAppleAuthResult } from '../presentation/hooks/useAppleAuth';
+export { useAuthBottomSheet } from '../presentation/hooks/useAuthBottomSheet';
+export type {
+  SocialAuthConfiguration,
+} from '../presentation/hooks/useAuthBottomSheet';
+export { useAuthHandlers } from '../presentation/hooks/useAuthHandlers';
+export type {
+  AuthHandlersAppInfo,
+  AuthHandlersTranslations,
+} from '../presentation/hooks/useAuthHandlers';
+export { usePasswordPromptNavigation } from '../presentation/hooks/usePasswordPromptNavigation';
+export type {
+  UsePasswordPromptNavigationOptions,
+  UsePasswordPromptNavigationReturn,
+} from '../presentation/hooks/usePasswordPromptNavigation';
+export { useAuthErrorHandler } from '../presentation/hooks/useAuthErrorHandler';
+export type {
+  UseAuthErrorHandlerConfig,
+  UseAuthErrorHandlerResult,
+} from '../presentation/hooks/useAuthErrorHandler';
+export { useLocalError } from '../presentation/hooks/useLocalError';
+export type { UseLocalErrorResult } from '../presentation/hooks/useLocalError';
+
+// Components
+export { AuthProvider } from '../presentation/providers/AuthProvider';
+export type { ErrorFallbackProps } from '../presentation/providers/AuthProvider';
+export { LoginScreen } from '../presentation/screens/LoginScreen';
+export type { LoginScreenProps } from '../presentation/screens/LoginScreen';
+export { RegisterScreen } from '../presentation/screens/RegisterScreen';
+export type { RegisterScreenProps } from '../presentation/screens/RegisterScreen';
+export { AccountScreen } from '../presentation/screens/AccountScreen';
+export type {
+  AccountScreenProps,
+  AccountScreenConfig,
+} from '../presentation/screens/AccountScreen';
+export { EditProfileScreen } from '../presentation/screens/EditProfileScreen';
+export type {
+  EditProfileScreenProps,
+} from '../presentation/screens/EditProfileScreen';
+export { PasswordPromptScreen } from '../presentation/screens/PasswordPromptScreen';
+export type {
+  PasswordPromptScreenProps,
+} from '../presentation/screens/PasswordPromptScreen';
+export { AuthNavigator } from '../presentation/navigation/AuthNavigator';
+export type { AuthStackParamList } from '../presentation/navigation/AuthNavigator';
+export { AuthBottomSheet } from '../presentation/components/AuthBottomSheet';
+export type {
+  AuthBottomSheetProps,
+  AuthBottomSheetTranslations,
+} from '../presentation/components/AuthBottomSheet';
+export { ProfileSection } from '../presentation/components/ProfileSection';
+export type {
+  ProfileSectionProps,
+  ProfileSectionConfig,
+} from '../presentation/components/ProfileSection';
+
+// Stores
+export { useAuthStore } from '../presentation/stores/authStore';
+export { useAuthModalStore } from '../presentation/stores/authModalStore';
+export {
+  initializeAuthListener,
+  resetAuthListener,
+  isAuthListenerInitialized,
+} from '../presentation/stores/initializeAuthListener';
+export type {
+  AuthState,
+  AuthActions,
+  UserType,
+  AuthListenerOptions,
+} from '../types/auth-store.types';
+export type { AuthModalMode } from '../presentation/stores/auth.selectors';
+export {
+  selectUser,
+  selectLoading,
+  selectError,
+  selectSetLoading,
+  selectSetError,
+  selectSetIsAnonymous,
+  selectShowAuthModal,
+  selectUserId,
+  selectIsAuthenticated,
+  selectHasFirebaseUser,
+  selectIsAnonymous,
+  selectUserType,
+  selectIsAuthReady,
+  selectFirebaseUserId,
+  selectAuthState,
+} from '../presentation/stores/auth.selectors';

package/src/exports/shared.ts

@@ -0,0 +1,93 @@
+/**
+ * Shared Layer Exports
+ * New modular utilities
+ */
+
+// Validation
+export {
+  EmailValidator,
+  PasswordValidator,
+  NameValidator,
+} from '../shared/validation/validators';
+export type { PasswordConfig } from '../shared/validation/validators';
+export {
+  EmailSanitizer,
+  PasswordSanitizer,
+  NameSanitizer,
+} from '../shared/validation/sanitizers';
+export {
+  BaseValidationRule,
+  RequiredRule,
+  RegexRule,
+  MinLengthRule,
+} from '../shared/validation/rules';
+export type {
+  ValidationResult,
+  PasswordRequirements,
+  PasswordStrengthResult,
+  ValidationRule,
+  ValidatorConfig,
+} from '../shared/validation/types';
+
+// Error Handling
+export {
+  ErrorMapper,
+  DEFAULT_AUTH_ERROR_MAPPINGS,
+  FieldErrorMapper,
+} from '../shared/error-handling/mappers';
+export { ErrorHandler, FormErrorHandler } from '../shared/error-handling/handlers';
+export type {
+  FieldError,
+  FormFieldErrors,
+  ErrorMap,
+  ErrorMappingConfig,
+  FormErrorHandlerConfig,
+} from '../shared/error-handling/types';
+
+// Form
+export { useField, useForm } from '../shared/form/builders';
+export type {
+  UseFieldOptions,
+  UseFieldResult,
+  UseFormOptions,
+  UseFormResult,
+} from '../shared/form/builders';
+export {
+  isFormValid,
+  isFormDirty,
+  isFormTouched,
+  getFormErrors,
+  getFirstFormError,
+  countFormErrors,
+  getFieldError,
+  fieldHasError,
+  isFieldTouched,
+  resetFormState,
+} from '../shared/form/state';
+export {
+  sanitizeFormValues,
+  extractFields,
+  areRequiredFieldsFilled,
+  getEmptyRequiredFields,
+  createFieldOptions,
+  mergeFormErrors,
+  clearFieldErrors,
+} from '../shared/form/utils/formUtils';
+export {
+  createFieldChangeHandler,
+  createFieldBlurHandler,
+  debounceFieldChange,
+  isFieldValueEmpty,
+  sanitizeFieldValue,
+  formatFieldValue,
+  validateFieldValue,
+  getFieldDisplayValue,
+  truncateFieldValue,
+} from '../shared/form/utils/fieldUtils';
+export type {
+  FieldState,
+  FormState,
+  FieldChangeHandler,
+  FormFieldConfig,
+  FormConfig,
+} from '../shared/form/types';

package/src/exports/utils.ts

@@ -0,0 +1,10 @@
+/**
+ * Utilities & Init Exports
+ */
+
+export {
+  getAuthErrorLocalizationKey,
+  resolveErrorMessage,
+} from '../presentation/utils/getAuthErrorMessage';
+export { createAuthInitModule } from '../init/createAuthInitModule';
+export type { AuthInitModuleConfig } from '../init/createAuthInitModule';

package/src/index.ts

@@ -8,149 +8,24 @@
 // =============================================================================
 // DOMAIN LAYER
 // =============================================================================
-
-export type { AuthUser, AuthProviderType } from './domain/entities/AuthUser';
-export type { UserProfile, UpdateProfileParams } from './domain/entities/UserProfile';
-export { AuthError, AuthInitializationError, AuthConfigurationError, AuthValidationError, AuthNetworkError, AuthUserNotFoundError, AuthWrongPasswordError, AuthEmailAlreadyInUseError, AuthWeakPasswordError, AuthInvalidEmailError } from './domain/errors/AuthError';
-export type { AuthConfig, PasswordConfig, SocialAuthConfig, SocialProviderConfig, GoogleAuthConfig, AppleAuthConfig, SocialAuthProvider } from './domain/value-objects/AuthConfig';
-export { DEFAULT_AUTH_CONFIG, DEFAULT_PASSWORD_CONFIG, DEFAULT_SOCIAL_CONFIG } from './domain/value-objects/AuthConfig';
-
-// =============================================================================
-// APPLICATION LAYER
-// =============================================================================
-
-export type { AuthCredentials, SignUpCredentials } from './infrastructure/repositories/AuthRepository';
+export * from './exports/domain';
 
 // =============================================================================
 // INFRASTRUCTURE LAYER
 // =============================================================================
-
-export { AuthService, initializeAuthService, getAuthService, resetAuthService } from './infrastructure/services/AuthService';
-export type { IStorageProvider } from './infrastructure/types/Storage.types';
-export { createStorageProvider, StorageProviderAdapter } from './infrastructure/adapters/StorageProviderAdapter';
-export { initializeAuth, isAuthInitialized, resetAuthInitialization } from './infrastructure/services/initializeAuth';
-export type { InitializeAuthOptions } from './infrastructure/services/initializeAuth';
-export { validateEmail, validatePasswordForLogin, validatePasswordForRegister, validatePasswordConfirmation, validateDisplayName } from './infrastructure/utils/AuthValidation';
-export type { ValidationResult, PasswordStrengthResult, PasswordRequirements } from './infrastructure/utils/AuthValidation';
-export type { FormValidationError, FormValidationResult } from './infrastructure/utils/validation/types';
-export { SECURITY_LIMITS, sanitizeEmail, sanitizePassword, sanitizeName } from './infrastructure/utils/validation/sanitization';
-export type { SecurityLimitKey } from './infrastructure/utils/validation/sanitization';
-export { isEmpty, isEmptyEmail, isEmptyPassword, isEmptyName, isNotEmpty, hasContent } from './infrastructure/utils/validation/validationHelpers';
-export { safeCallback, safeCallbackSync } from './infrastructure/utils/safeCallback';
-
-
-// =============================================================================
-// CALCULATOR UTILITIES
-// =============================================================================
-
-export {
-  // Auth State Calculator
-  calculateUserId,
-  calculateHasFirebaseUser,
-  calculateIsAnonymous,
-  calculateIsAuthenticated,
-  calculateUserType,
-  calculateIsAuthReady,
-  calculateDerivedAuthState,
-  // Form Error Collection
-  collectFieldErrors,
-  extractFieldError,
-  hasFieldErrors,
-  getFirstErrorMessage,
-  // User Profile Calculator
-  calculateUserProfileDisplay,
-  // Password Strength Calculator
-  calculatePasswordRequirements,
-  calculatePasswordsMatch,
-  calculatePasswordValidation,
-  calculatePasswordStrength,
-} from './infrastructure/utils/calculators';
-
-
-// =============================================================================
-// PRESENTATION LAYER - Hooks
-// =============================================================================
-
-export { useAuth } from './presentation/hooks/useAuth';
-export type { UseAuthResult } from './presentation/hooks/useAuth';
-export { useLoginForm } from './presentation/hooks/useLoginForm';
-export type { UseLoginFormConfig, UseLoginFormResult } from './presentation/hooks/useLoginForm';
-export { useRegisterForm } from './presentation/hooks/useRegisterForm';
-export type { UseRegisterFormConfig, UseRegisterFormResult } from './presentation/hooks/useRegisterForm';
-export { useAuthRequired } from './presentation/hooks/useAuthRequired';
-export { useRequireAuth, useUserId } from './presentation/hooks/useRequireAuth';
-export { useUserProfile } from './presentation/hooks/useUserProfile';
-export type { UserProfileData, UseUserProfileParams } from './presentation/hooks/useUserProfile';
-export { useAccountManagement } from './presentation/hooks/useAccountManagement';
-export type { UseAccountManagementReturn, UseAccountManagementOptions } from './presentation/hooks/useAccountManagement';
-export { useAppleAuth } from './presentation/hooks/useAppleAuth';
-export type { UseAppleAuthResult } from './presentation/hooks/useAppleAuth';
-export { useAuthBottomSheet } from './presentation/hooks/useAuthBottomSheet';
-export type { SocialAuthConfiguration } from './presentation/hooks/useAuthBottomSheet';
-export { useAuthHandlers } from './presentation/hooks/useAuthHandlers';
-export type { AuthHandlersAppInfo, AuthHandlersTranslations } from './presentation/hooks/useAuthHandlers';
-export { usePasswordPromptNavigation } from './presentation/hooks/usePasswordPromptNavigation';
-export type { UsePasswordPromptNavigationOptions, UsePasswordPromptNavigationReturn } from './presentation/hooks/usePasswordPromptNavigation';
-export { useAuthErrorHandler } from './presentation/hooks/useAuthErrorHandler';
-export type { UseAuthErrorHandlerConfig, UseAuthErrorHandlerResult } from './presentation/hooks/useAuthErrorHandler';
-export { useLocalError } from './presentation/hooks/useLocalError';
-export type { UseLocalErrorResult } from './presentation/hooks/useLocalError';
+export * from './exports/infrastructure';
 
 // =============================================================================
-// PRESENTATION LAYER - Components
+// PRESENTATION LAYER
 // =============================================================================
-
-export { AuthProvider } from './presentation/providers/AuthProvider';
-export type { ErrorFallbackProps } from './presentation/providers/AuthProvider';
-export { LoginScreen } from './presentation/screens/LoginScreen';
-export type { LoginScreenProps } from './presentation/screens/LoginScreen';
-export { RegisterScreen } from './presentation/screens/RegisterScreen';
-export type { RegisterScreenProps } from './presentation/screens/RegisterScreen';
-export { AccountScreen } from './presentation/screens/AccountScreen';
-export type { AccountScreenProps, AccountScreenConfig } from './presentation/screens/AccountScreen';
-export { EditProfileScreen } from './presentation/screens/EditProfileScreen';
-export type { EditProfileScreenProps } from './presentation/screens/EditProfileScreen';
-export { PasswordPromptScreen } from './presentation/screens/PasswordPromptScreen';
-export type { PasswordPromptScreenProps } from './presentation/screens/PasswordPromptScreen';
-export { AuthNavigator } from './presentation/navigation/AuthNavigator';
-export type { AuthStackParamList } from './presentation/navigation/AuthNavigator';
-export { AuthBottomSheet } from './presentation/components/AuthBottomSheet';
-export type { AuthBottomSheetProps, AuthBottomSheetTranslations } from './presentation/components/AuthBottomSheet';
-export { ProfileSection } from './presentation/components/ProfileSection';
-export type { ProfileSectionProps, ProfileSectionConfig } from './presentation/components/ProfileSection';
+export * from './exports/presentation';
 
 // =============================================================================
-// STORES
+// SHARED LAYER (New Modular Utilities)
 // =============================================================================
-
-export { useAuthStore } from './presentation/stores/authStore';
-export { useAuthModalStore } from './presentation/stores/authModalStore';
-export { initializeAuthListener, resetAuthListener, isAuthListenerInitialized } from './presentation/stores/initializeAuthListener';
-export type { AuthState, AuthActions, UserType, AuthListenerOptions } from './types/auth-store.types';
-export type { AuthModalMode } from './presentation/stores/auth.selectors';
-export {
-  selectUser,
-  selectLoading,
-  selectError,
-  selectSetLoading,
-  selectSetError,
-  selectSetIsAnonymous,
-  selectShowAuthModal,
-  selectUserId,
-  selectIsAuthenticated,
-  selectHasFirebaseUser,
-  selectIsAnonymous,
-  selectUserType,
-  selectIsAuthReady,
-  selectFirebaseUserId,
-  selectAuthState,
-} from './presentation/stores/auth.selectors';
+export * from './exports/shared';
 
 // =============================================================================
 // UTILITIES & INIT
 // =============================================================================
-
-export { getAuthErrorLocalizationKey, resolveErrorMessage } from './presentation/utils/getAuthErrorMessage';
-export { createAuthInitModule } from './init/createAuthInitModule';
-export type { AuthInitModuleConfig } from './init/createAuthInitModule';
-
+export * from './exports/utils';

package/src/infrastructure/utils/listener/anonymousSignIn/attemptAnonymousSignIn.ts

@@ -0,0 +1,81 @@
+/**
+ * Anonymous Sign-In Attempt Logic
+ */
+
+import { anonymousAuthService } from '@umituz/react-native-firebase';
+import type { Auth } from 'firebase/auth';
+import type { AnonymousSignInCallbacks, AnonymousSignInOptions } from './types';
+import {
+  MAX_ANONYMOUS_RETRIES,
+  ANONYMOUS_RETRY_DELAY_MS,
+  ANONYMOUS_SIGNIN_TIMEOUT_MS,
+} from './constants';
+
+/**
+ * Perform anonymous sign-in with retry logic
+ */
+async function performAnonymousSignIn(
+  auth: Auth,
+  maxRetries: number,
+  retryDelay: number
+): Promise<void> {
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      await anonymousAuthService.signInAnonymously(auth);
+      return;
+    } catch (error) {
+      // If not last attempt, wait and retry
+      if (attempt < maxRetries - 1) {
+        await new Promise((resolve) => setTimeout(resolve, retryDelay));
+        continue;
+      }
+
+      // All attempts failed
+      throw error;
+    }
+  }
+}
+
+/**
+ * Attempt anonymous sign-in with retry logic and timeout protection
+ */
+export async function attemptAnonymousSignIn(
+  auth: Auth,
+  callbacks: AnonymousSignInCallbacks,
+  options: AnonymousSignInOptions = {}
+): Promise<void> {
+  const {
+    maxRetries = MAX_ANONYMOUS_RETRIES,
+    retryDelay = ANONYMOUS_RETRY_DELAY_MS,
+    timeout = ANONYMOUS_SIGNIN_TIMEOUT_MS,
+  } = options;
+
+  let timeoutId: ReturnType<typeof setTimeout> | undefined;
+
+  try {
+    // Add timeout protection with proper cleanup
+    const timeoutPromise = new Promise<never>((_, reject) => {
+      timeoutId = setTimeout(
+        () => reject(new Error('Anonymous sign-in timeout')),
+        timeout
+      );
+    });
+
+    // Race between sign-in and timeout
+    await Promise.race([
+      performAnonymousSignIn(auth, maxRetries, retryDelay),
+      timeoutPromise,
+    ]);
+
+    callbacks.onSignInSuccess();
+  } catch (error) {
+    const signInError =
+      error instanceof Error ? error : new Error('Unknown sign-in error');
+    callbacks.onSignInFailure(signInError);
+  } finally {
+    // Always clear timeout to prevent timer leaks
+    if (timeoutId !== undefined) {
+      clearTimeout(timeoutId);
+    }
+  }
+}

package/src/infrastructure/utils/listener/anonymousSignIn/constants.ts

@@ -0,0 +1,7 @@
+/**
+ * Anonymous Sign-In Constants
+ */
+
+export const MAX_ANONYMOUS_RETRIES = 2;
+export const ANONYMOUS_RETRY_DELAY_MS = 1000;
+export const ANONYMOUS_SIGNIN_TIMEOUT_MS = 10000;

package/src/infrastructure/utils/listener/anonymousSignIn/createAnonymousSignInHandler.ts

@@ -0,0 +1,59 @@
+/**
+ * Create Anonymous Sign-In Handler
+ * Factory function for creating anonymous sign-in handlers
+ */
+
+import type { Auth } from 'firebase/auth';
+import type { User } from 'firebase/auth';
+import type { AnonymousStore } from './types';
+import { attemptAnonymousSignIn } from './attemptAnonymousSignIn';
+import {
+  MAX_ANONYMOUS_RETRIES,
+  ANONYMOUS_RETRY_DELAY_MS,
+  ANONYMOUS_SIGNIN_TIMEOUT_MS,
+} from './constants';
+
+/**
+ * Create anonymous sign-in handler for auth listener
+ * Returns a function that can be called when no user is detected
+ */
+export function createAnonymousSignInHandler(
+  auth: Auth | null,
+  store: AnonymousStore
+): () => Promise<void> {
+  return async () => {
+    if (!auth) {
+      store.setFirebaseUser(null);
+      store.setLoading(false);
+      store.setInitialized(true);
+      return;
+    }
+
+    store.setLoading(true);
+
+    await attemptAnonymousSignIn(
+      auth,
+      {
+        onSignInSuccess: () => {
+          // Listener will be triggered again with the new user
+        },
+        onSignInFailure: (error: Error) => {
+          if (__DEV__) {
+            console.error('[AnonymousSignIn] Failed:', error.message);
+          }
+          store.setFirebaseUser(null);
+          store.setLoading(false);
+          store.setInitialized(true);
+          store.setError(
+            'Failed to sign in anonymously. Please check your connection.'
+          );
+        },
+      },
+      {
+        maxRetries: MAX_ANONYMOUS_RETRIES,
+        retryDelay: ANONYMOUS_RETRY_DELAY_MS,
+        timeout: ANONYMOUS_SIGNIN_TIMEOUT_MS,
+      }
+    );
+  };
+}

package/src/infrastructure/utils/listener/anonymousSignIn/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Anonymous Sign-In Module Exports
+ */
+
+export { createAnonymousSignInHandler } from './createAnonymousSignInHandler';
+export { attemptAnonymousSignIn } from './attemptAnonymousSignIn';
+export {
+  MAX_ANONYMOUS_RETRIES,
+  ANONYMOUS_RETRY_DELAY_MS,
+  ANONYMOUS_SIGNIN_TIMEOUT_MS,
+} from './constants';
+export type {
+  AnonymousSignInCallbacks,
+  AnonymousSignInOptions,
+  AnonymousStore,
+} from './types';