@umituz/web-dashboard 5.0.1 → 6.0.0

package/src/domains/auth/hooks/useAuth.ts

@@ -1,230 +0,0 @@
-/**
- * useAuth Hook
- *
- * Core authentication hook for managing auth state and actions.
- * Centralizes the try/catch+loading+error pattern via a single helper
- * to keep individual actions focused on their unique logic.
- */
-
-import { useState, useCallback } from "react";
-import type {
-  AuthState,
-  User,
-  AuthActions,
-  LoginCredentials,
-  RegisterData,
-  ForgotPasswordData,
-  ResetPasswordData,
-} from "../types/auth";
-import {
-  validateLogin,
-  validateRegister,
-  validateForgotPassword,
-  validateResetPassword,
-} from "../utils/auth";
-
-/**
- * Auth provider contract — single source of truth for backend integration.
- */
-export interface AuthProvider {
-  login: (credentials: LoginCredentials) => Promise<User>;
-  register: (data: RegisterData) => Promise<User>;
-  logout: () => Promise<void>;
-  forgotPassword: (data: ForgotPasswordData) => Promise<void>;
-  resetPassword: (data: ResetPasswordData) => Promise<void>;
-  refreshAuth: () => Promise<User | null>;
-}
-
-interface UseAuthOptions {
-  /** Auth implementation (connects to your backend) */
-  authProvider?: AuthProvider;
-}
-
-/**
- * Wrap a side-effectful async function with the standard
- * isLoading + error + throw contract.
- *
- * Important: the wrapped function is the SINGLE point of truth for
- * setting isLoading=false, ensuring errors are surfaced (not swallowed),
- * and re-throwing for callers that need to react.
- */
-const executeAuthAction = async <T>(
-  updateState: (updates: Partial<AuthState>) => void,
-  fallbackErrorMessage: string,
-  action: () => Promise<T>,
-): Promise<T> => {
-  updateState({ isLoading: true, error: null });
-  try {
-    return await action();
-  } catch (error) {
-    const errorMessage =
-      error instanceof Error && error.message ? error.message : fallbackErrorMessage;
-    updateState({ isLoading: false, error: errorMessage });
-    throw error instanceof Error ? error : new Error(errorMessage);
-  }
-};
-
-/**
- * useAuth hook
- *
- * Manages authentication state and provides auth actions.
- * Each action surfaces errors to the caller AND to the auth state.
- */
-export function useAuth(options: UseAuthOptions = {}) {
-  const { authProvider } = options;
-
-  const [authState, setAuthState] = useState<AuthState>({
-    isAuthenticated: false,
-    user: null,
-    isLoading: false,
-    error: null,
-  });
-
-  const updateState = useCallback((updates: Partial<AuthState>) => {
-    setAuthState((prev) => ({ ...prev, ...updates }));
-  }, []);
-
-  const requireProvider = useCallback((): AuthProvider => {
-    if (!authProvider) {
-      throw new Error("Auth provider not configured");
-    }
-    return authProvider;
-  }, [authProvider]);
-
-  const login = useCallback(
-    async (credentials: LoginCredentials): Promise<User> => {
-      const validation = validateLogin(credentials);
-      if (!validation.valid) {
-        const message = validation.error ?? "Login validation failed";
-        updateState({ error: message });
-        throw new Error(message);
-      }
-
-      return executeAuthAction(updateState, "Login failed", async () => {
-        const provider = requireProvider();
-        const user = await provider.login(credentials);
-        updateState({ isAuthenticated: true, user, isLoading: false, error: null });
-        return user;
-      });
-    },
-    [requireProvider, updateState],
-  );
-
-  const register = useCallback(
-    async (data: RegisterData): Promise<User> => {
-      const validation = validateRegister(data, false);
-      if (!validation.valid) {
-        const message = validation.error ?? "Registration validation failed";
-        updateState({ error: message });
-        throw new Error(message);
-      }
-
-      return executeAuthAction(updateState, "Registration failed", async () => {
-        const provider = requireProvider();
-        const user = await provider.register(data);
-        updateState({ isAuthenticated: true, user, isLoading: false, error: null });
-        return user;
-      });
-    },
-    [requireProvider, updateState],
-  );
-
-  const logout = useCallback(async (): Promise<void> => {
-    await executeAuthAction(updateState, "Logout failed", async () => {
-      const provider = requireProvider();
-      await provider.logout();
-      updateState({ isAuthenticated: false, user: null, isLoading: false, error: null });
-    });
-  }, [requireProvider, updateState]);
-
-  const forgotPassword = useCallback(
-    async (data: ForgotPasswordData): Promise<void> => {
-      const validation = validateForgotPassword(data);
-      if (!validation.valid) {
-        const message = validation.error ?? "Forgot password validation failed";
-        updateState({ error: message });
-        throw new Error(message);
-      }
-
-      await executeAuthAction(updateState, "Failed to send reset email", async () => {
-        const provider = requireProvider();
-        await provider.forgotPassword(data);
-        updateState({ isLoading: false });
-      });
-    },
-    [requireProvider, updateState],
-  );
-
-  const resetPassword = useCallback(
-    async (data: ResetPasswordData): Promise<void> => {
-      const validation = validateResetPassword(data);
-      if (!validation.valid) {
-        const message = validation.error ?? "Reset password validation failed";
-        updateState({ error: message });
-        throw new Error(message);
-      }
-
-      await executeAuthAction(updateState, "Failed to reset password", async () => {
-        const provider = requireProvider();
-        await provider.resetPassword(data);
-        updateState({ isLoading: false });
-      });
-    },
-    [requireProvider, updateState],
-  );
-
-  const updateProfile = useCallback(
-    async (data: Partial<User>): Promise<User> => {
-      const currentUser = authState.user;
-      if (!currentUser) {
-        const message = "No user to update";
-        updateState({ error: message });
-        throw new Error(message);
-      }
-
-      return executeAuthAction(updateState, "Failed to update profile", async () => {
-        // Pure derivation of the new user, no side effects in setState callback.
-        // Required fields come from the existing user; data overrides only the rest.
-        const { id: _ignoredId, ...rest } = data;
-        const updatedUser: User = {
-          ...currentUser,
-          ...rest,
-          id: currentUser.id,
-          email: data.email ?? currentUser.email,
-        };
-        updateState({ user: updatedUser, isLoading: false, error: null });
-        return updatedUser;
-      });
-    },
-    [authState.user, updateState],
-  );
-
-  const refresh = useCallback(async (): Promise<User | null> => {
-    return executeAuthAction(updateState, "Failed to refresh authentication", async () => {
-      const provider = requireProvider();
-      const user = await provider.refreshAuth();
-      updateState({ isAuthenticated: Boolean(user), user, isLoading: false, error: null });
-      return user;
-    });
-  }, [requireProvider, updateState]);
-
-  const clearError = useCallback(() => {
-    updateState({ error: null });
-  }, [updateState]);
-
-  const authActions: AuthActions = {
-    login,
-    register,
-    logout,
-    forgotPassword,
-    resetPassword,
-    updateProfile,
-    refresh,
-  };
-
-  return {
-    ...authState,
-    ...authActions,
-    clearError,
-  };
-}

package/src/domains/auth/index.ts

@@ -1,62 +0,0 @@
-/**
- * Auth Domain
- *
- * Main entry point for authentication domain
- */
-
-// Components
-export {
-  AuthLayout,
-  LoginForm,
-  RegisterForm,
-  ForgotPasswordForm,
-  ResetPasswordForm,
-} from "./components";
-
-// Hooks
-export { useAuth, type AuthProvider } from "./hooks";
-
-// Utils
-export {
-  isValidEmail,
-  isValidPassword,
-  validateLogin,
-  validateRegister,
-  validateForgotPassword,
-  validateResetPassword,
-  getUserDisplayName,
-  getUserInitials,
-  isEmailVerified,
-  formatUserCreatedAt,
-  maskEmail,
-  generateResetToken,
-  calculatePasswordStrength,
-  getPasswordStrengthBand,
-  sanitizeInput,
-  AUTH_KEYS,
-  AUTH_VALIDATION_KEYS,
-  type ValidationResult,
-  type PasswordStrengthBand,
-  type AuthValidationKey,
-} from "./utils";
-
-// Types
-export type {
-  LoginCredentials,
-  RegisterData,
-  ForgotPasswordData,
-  ResetPasswordData,
-  AuthState,
-  User,
-  AuthActions,
-  AuthComponentProps,
-  AuthStep,
-  AuthConfig,
-  SocialProvider,
-  AuthLayoutProps,
-  LoginFormProps,
-  RegisterFormProps,
-  ForgotPasswordFormProps,
-  ResetPasswordFormProps,
-  Translate,
-} from "./types";

package/src/domains/auth/types/auth.ts

@@ -1,302 +0,0 @@
-/**
- * Auth Types
- *
- * Type definitions for authentication system
- */
-
-import type { ComponentType, ReactElement } from "react";
-
-/**
- * Translation function contract. Auth components stay i18n-agnostic;
- * the consumer plugs in their i18n library of choice.
- * Interpolation params follow the i18next convention (`{{placeholder}}`).
- */
-export type Translate = (key: string, params?: Record<string, unknown>) => string;
-
-/**
- * User credentials for login
- */
-export interface LoginCredentials {
-  /** Email address */
-  email: string;
-  /** Password */
-  password: string;
-}
-
-/**
- * Registration data
- */
-export interface RegisterData {
-  /** Email address */
-  email: string;
-  /** Password */
-  password: string;
-  /** Full name */
-  name?: string;
-  /** Additional user data */
-  metadata?: Record<string, unknown>;
-}
-
-/**
- * Password reset request
- */
-export interface ForgotPasswordData {
-  /** Email address */
-  email: string;
-}
-
-/**
- * Password reset confirmation
- */
-export interface ResetPasswordData {
-  /** Reset token from email */
-  token: string;
-  /** New password */
-  password: string;
-  /** Password confirmation */
-  confirmPassword: string;
-}
-
-/**
- * Auth state
- */
-export interface AuthState {
-  /** Is user authenticated */
-  isAuthenticated: boolean;
-  /** Current user data */
-  user: User | null;
-  /** Is authentication loading */
-  isLoading: boolean;
-  /** Authentication error */
-  error: string | null;
-}
-
-/**
- * User profile
- */
-export interface User {
-  /** Unique user ID */
-  id: string;
-  /** Email address */
-  email: string;
-  /** Display name */
-  name?: string;
-  /** Profile avatar URL */
-  avatar?: string;
-  /** Email verification status */
-  emailVerified?: boolean;
-  /** Additional user data */
-  metadata?: Record<string, unknown>;
-  /** Account creation date */
-  createdAt?: string;
-  /** Last login date */
-  lastLoginAt?: string;
-}
-
-/**
- * Auth actions
- */
-export interface AuthActions {
-  /** Login with email/password */
-  login: (credentials: LoginCredentials) => Promise<User>;
-  /** Register new account */
-  register: (data: RegisterData) => Promise<User>;
-  /** Logout current user */
-  logout: () => Promise<void>;
-  /** Send password reset email */
-  forgotPassword: (data: ForgotPasswordData) => Promise<void>;
-  /** Reset password with token */
-  resetPassword: (data: ResetPasswordData) => Promise<void>;
-  /** Update user profile */
-  updateProfile: (data: Partial<User>) => Promise<User>;
-  /** Refresh authentication session */
-  refresh: () => Promise<User | null>;
-}
-
-/**
- * Auth component props
- */
-export interface AuthComponentProps {
-  /** Current auth state */
-  authState: AuthState;
-  /** Auth actions */
-  authActions: AuthActions;
-  /** Update auth state */
-  setAuthState: (state: Partial<AuthState>) => void;
-}
-
-/**
- * Auth step configuration
- */
-export interface AuthStep {
-  /** Step identifier */
-  id: string;
-  /** Step title */
-  title: string;
-  /** Step description */
-  description?: string;
-  /** Custom component */
-  component?: ComponentType<AuthComponentProps> | ReactElement;
-  /** Validation function */
-  validate?: (data: Record<string, unknown>) => boolean;
-}
-
-/**
- * Auth configuration
- */
-export interface AuthConfig {
-  /** Brand/application name */
-  brandName: string;
-  /** Brand tagline */
-  brandTagline?: string;
-  /** Login route */
-  loginRoute: string;
-  /** Register route */
-  registerRoute: string;
-  /** Forgot password route */
-  forgotPasswordRoute?: string;
-  /** Route after successful login */
-  afterLoginRoute: string;
-  /** Route after logout */
-  afterLogoutRoute: string;
-  /** Show social login options */
-  showSocialLogin?: boolean;
-  /** Available social providers */
-  socialProviders?: SocialProvider[];
-  /** Public home route (header "back" link). Falls back to `afterLoginRoute`. */
-  homeRoute?: string;
-  /** Footer links (rendered only when provided — no defaults that 404) */
-  footerLinks?: Array<{ label: string; href: string }>;
-  /** Enable remember me */
-  enableRememberMe?: boolean;
-  /** Enable email verification */
-  requireEmailVerification?: boolean;
-  /** Auth steps (for multi-step onboarding) */
-  steps?: AuthStep[];
-  /** Additional configuration */
-  metadata?: Record<string, unknown>;
-}
-
-/**
- * Social login provider
- */
-export interface SocialProvider {
-  /** Provider ID */
-  id: string;
-  /** Display name */
-  name: string;
-  /** Icon/emoji */
-  icon: string;
-  /** Color theme */
-  color?: string;
-  /** Scopes to request */
-  scopes?: string[];
-}
-
-/**
- * Auth layout props
- */
-export interface AuthLayoutProps {
-  /** Auth configuration */
-  config: AuthConfig;
-  /** Current auth state */
-  authState?: AuthState;
-  /** Auth actions */
-  authActions?: AuthActions;
-  /** Optional translation function for layout strings (falls back to embedded English) */
-  translate?: Translate;
-  /** Social provider login handler (receives the provider id) */
-  onSocialLogin?: (providerId: string) => void | Promise<void>;
-  /** Children content */
-  children?: React.ReactNode;
-}
-
-/**
- * Login form props
- */
-export interface LoginFormProps {
-  /** Auth configuration */
-  config: AuthConfig;
-  /** Initial credentials */
-  defaultCredentials?: Partial<LoginCredentials>;
-  /** Show remember me checkbox */
-  showRememberMe?: boolean;
-  /** Show forgot password link */
-  showForgotPassword?: boolean;
-  /** Show register link */
-  showRegisterLink?: boolean;
-  /** Show social login buttons */
-  showSocialLogin?: boolean;
-  /**
-   * Allow the built-in mock login (accepts ANY credentials) for demos.
-   * Defaults to false — without `onLoginAttempt` the form reports a
-   * configuration error instead of silently "logging in".
-   */
-  enableMockAuth?: boolean;
-  /** Custom login handler (receives credentials, returns user) */
-  onLoginAttempt?: (credentials: LoginCredentials) => Promise<User>;
-  /** On successful login (called after onLoginAttempt or mock auth succeeds) */
-  onLoginSuccess?: (user: User) => void | Promise<void>;
-  /** On login error */
-  onLoginError?: (error: string) => void;
-  /** Google login handler */
-  onGoogleLogin?: () => void | Promise<void>;
-  /** Apple login handler */
-  onAppleLogin?: () => void | Promise<void>;
-}
-
-/**
- * Register form props
- */
-export interface RegisterFormProps {
-  /** Auth configuration */
-  config: AuthConfig;
-  /** Initial registration data */
-  defaultData?: Partial<RegisterData>;
-  /** Show terms checkbox */
-  showTerms?: boolean;
-  /** Show login link */
-  showLoginLink?: boolean;
-  /** Require password confirmation */
-  requirePasswordConfirm?: boolean;
-  /** Show social login buttons */
-  showSocialLogin?: boolean;
-  /** Custom register handler (receives register data, returns user) - overrides mock auth */
-  onRegisterAttempt?: (data: RegisterData) => Promise<User>;
-  /** On successful registration (called after onRegisterAttempt or mock auth succeeds) */
-  onRegisterSuccess?: (user: User) => void | Promise<void>;
-  /** On registration error */
-  onRegisterError?: (error: string) => void;
-  /** Google login handler */
-  onGoogleLogin?: () => void | Promise<void>;
-  /** Apple login handler */
-  onAppleLogin?: () => void | Promise<void>;
-}
-
-/**
- * Forgot password form props
- */
-export interface ForgotPasswordFormProps {
-  /** Auth configuration */
-  config: AuthConfig;
-  /** Submit handler — receives the entered email and performs the reset request */
-  onSuccess?: (data: { email: string }) => void | Promise<void>;
-  /** On error */
-  onError?: (error: string) => void;
-  /** Show back to login link */
-  showBackLink?: boolean;
-}
-
-/**
- * Reset password form props
- */
-export interface ResetPasswordFormProps {
-  /** Auth configuration */
-  config: AuthConfig;
-  /** Reset token */
-  token: string;
-  /** Submit handler — receives the token and the new password */
-  onSuccess?: (data: { token: string; password: string }) => void | Promise<void>;
-  /** On error */
-  onError?: (error: string) => void;
-}

package/src/domains/auth/types/index.ts

@@ -1,25 +0,0 @@
-/**
- * Auth Types
- *
- * Export all auth-related types
- */
-
-export type {
-  LoginCredentials,
-  RegisterData,
-  ForgotPasswordData,
-  ResetPasswordData,
-  AuthState,
-  User,
-  AuthActions,
-  AuthComponentProps,
-  AuthStep,
-  AuthConfig,
-  SocialProvider,
-  AuthLayoutProps,
-  LoginFormProps,
-  RegisterFormProps,
-  ForgotPasswordFormProps,
-  ResetPasswordFormProps,
-  Translate,
-} from "./auth";