@umituz/react-native-auth 3.1.9 → 3.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-auth",
-  "version": "3.1.9",
+  "version": "3.1.10",
   "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/index.ts

@@ -105,6 +105,12 @@ export type {
   PasswordRequirements,
 } from './infrastructure/utils/AuthValidation';
 
+// =============================================================================
+// PRESENTATION LAYER - Provider
+// =============================================================================
+
+export { AuthProvider } from './presentation/providers/AuthProvider';
+
 // =============================================================================
 // PRESENTATION LAYER - Hooks
 // =============================================================================
@@ -112,6 +118,11 @@ export type {
 export { useAuth } from './presentation/hooks/useAuth';
 export type { UseAuthResult } from './presentation/hooks/useAuth';
 
+export { useAuthRequired } from './presentation/hooks/useAuthRequired';
+export type { UseAuthRequiredResult } 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';
 

package/src/presentation/hooks/useAuthRequired.ts

@@ -0,0 +1,69 @@
+/**
+ * useAuthRequired Hook
+ * Check if user meets auth requirements for a feature
+ *
+ * Usage:
+ * ```tsx
+ * const { isAllowed, requireAuth } = useAuthRequired();
+ *
+ * const handleAction = () => {
+ *   if (!isAllowed) {
+ *     requireAuth(); // Opens auth modal
+ *     return;
+ *   }
+ *   // Proceed with action
+ * };
+ * ```
+ */
+
+import { useCallback } from "react";
+import { useAuthStore, selectIsAuthenticated } from "../stores/authStore";
+import { useAuthModalStore } from "../stores/authModalStore";
+
+export interface UseAuthRequiredResult {
+  /** Whether user is authenticated (not guest, not anonymous) */
+  isAllowed: boolean;
+  /** Whether auth is still loading */
+  isLoading: boolean;
+  /** Current user ID (null if not authenticated) */
+  userId: string | null;
+  /** Show auth modal to require authentication */
+  requireAuth: () => void;
+  /** Check and require auth - returns true if allowed, false if modal shown */
+  checkAndRequireAuth: () => boolean;
+}
+
+/**
+ * Hook to check auth requirements and show modal if needed
+ */
+export function useAuthRequired(): UseAuthRequiredResult {
+  const isAllowed = useAuthStore(selectIsAuthenticated);
+  const isLoading = useAuthStore((state) => state.loading);
+  const userId = useAuthStore((state) => state.firebaseUser?.uid ?? null);
+  const openAuthModal = useAuthModalStore((state) => state.open);
+
+  const requireAuth = useCallback(() => {
+    openAuthModal("login");
+  }, [openAuthModal]);
+
+  const checkAndRequireAuth = useCallback((): boolean => {
+    if (isLoading) {
+      return false;
+    }
+
+    if (!isAllowed) {
+      openAuthModal("login");
+      return false;
+    }
+
+    return true;
+  }, [isAllowed, isLoading, openAuthModal]);
+
+  return {
+    isAllowed,
+    isLoading,
+    userId,
+    requireAuth,
+    checkAndRequireAuth,
+  };
+}

package/src/presentation/hooks/useRequireAuth.ts

@@ -0,0 +1,35 @@
+/**
+ * useRequireAuth Hook
+ * Returns userId, throws if not authenticated
+ *
+ * Usage:
+ * ```tsx
+ * // In a component that MUST have authenticated user
+ * const userId = useRequireAuth();
+ * // userId is guaranteed to be string, not null
+ * ```
+ */
+
+import { useAuthStore, selectIsAuthenticated } from "../stores/authStore";
+
+/**
+ * Get userId or throw if not authenticated
+ * Use this in components that REQUIRE authentication
+ */
+export function useRequireAuth(): string {
+  const isAuthenticated = useAuthStore(selectIsAuthenticated);
+  const userId = useAuthStore((state) => state.firebaseUser?.uid ?? null);
+
+  if (!isAuthenticated || !userId) {
+    throw new Error("User not authenticated. This component requires auth.");
+  }
+
+  return userId;
+}
+
+/**
+ * Get userId safely (returns null if not authenticated)
+ */
+export function useUserId(): string | null {
+  return useAuthStore((state) => state.firebaseUser?.uid ?? null);
+}

package/src/presentation/providers/AuthProvider.tsx

@@ -0,0 +1,32 @@
+/**
+ * AuthProvider
+ * Wraps app and handles auth initialization
+ *
+ * Usage:
+ * ```tsx
+ * <AuthProvider>
+ *   <App />
+ * </AuthProvider>
+ * ```
+ */
+
+import React, { useEffect, type ReactNode } from "react";
+import { initializeAuthListener } from "../stores/authStore";
+
+interface AuthProviderProps {
+  children: ReactNode;
+}
+
+/**
+ * AuthProvider component
+ * Initializes Firebase auth listener on mount
+ * Must wrap the app root
+ */
+export function AuthProvider({ children }: AuthProviderProps): JSX.Element {
+  useEffect(() => {
+    const unsubscribe = initializeAuthListener();
+    return unsubscribe;
+  }, []);
+
+  return <>{children}</>;
+}