@umituz/web-dashboard 5.0.0 → 6.0.0

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";

package/src/domains/auth/utils/auth.test.ts

@@ -1,188 +0,0 @@
-/**
- * Tests for pure auth utility functions.
- */
-
-import { describe, it, expect } from "vitest";
-import {
-  isValidEmail,
-  isValidPassword,
-  validateLogin,
-  validateRegister,
-  validateResetPassword,
-  getUserDisplayName,
-  getUserInitials,
-  calculatePasswordStrength,
-  getPasswordStrengthBand,
-  maskEmail,
-  sanitizeInput,
-} from "./auth";
-import { generateResetToken } from "./secureToken";
-import { AUTH_VALIDATION_KEYS } from "./validationKeys";
-
-describe("isValidEmail", () => {
-  it("accepts plain addresses", () => {
-    expect(isValidEmail("user@example.com")).toBe(true);
-  });
-
-  it("rejects missing local part, domain, or TLD", () => {
-    expect(isValidEmail("@example.com")).toBe(false);
-    expect(isValidEmail("user@")).toBe(false);
-    expect(isValidEmail("user@example")).toBe(false);
-    expect(isValidEmail("user example.com")).toBe(false);
-  });
-});
-
-describe("isValidPassword", () => {
-  it("enforces the minimum length", () => {
-    expect(isValidPassword("short")).toBe(false);
-    expect(isValidPassword("longenough")).toBe(true);
-  });
-
-  it("honors a custom minimum", () => {
-    expect(isValidPassword("12345678", 12)).toBe(false);
-    expect(isValidPassword("123456789012", 12)).toBe(true);
-  });
-});
-
-describe("validateLogin", () => {
-  it("passes valid credentials", () => {
-    expect(validateLogin({ email: "a@b.co", password: "x".repeat(8) })).toEqual({ valid: true });
-  });
-
-  it("requires an email first", () => {
-    expect(validateLogin({ email: "", password: "x" })).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.emailRequired,
-    });
-  });
-
-  it("rejects a malformed email", () => {
-    expect(validateLogin({ email: "nope", password: "x" })).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.emailInvalid,
-    });
-  });
-
-  it("requires a password", () => {
-    expect(validateLogin({ email: "a@b.co", password: "" })).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.passwordRequired,
-    });
-  });
-});
-
-describe("validateRegister", () => {
-  const base = { email: "a@b.co", password: "longenough1" };
-
-  it("passes with minimal data", () => {
-    expect(validateRegister(base)).toEqual({ valid: true });
-  });
-
-  it("requires a name when asked to", () => {
-    expect(validateRegister(base, true)).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.nameRequired,
-    });
-  });
-
-  it("enforces password length", () => {
-    expect(validateRegister({ ...base, password: "short" })).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.passwordTooShort,
-    });
-  });
-
-  it("checks confirmation when required", () => {
-    expect(
-      validateRegister({ ...base, confirmPassword: "different" }, false, true),
-    ).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.passwordsDoNotMatch,
-    });
-  });
-
-  it("accepts matching confirmation when required (the RegisterForm call shape)", () => {
-    expect(
-      validateRegister({ ...base, name: "A", confirmPassword: base.password }, false, true),
-    ).toEqual({ valid: true });
-  });
-});
-
-describe("validateResetPassword", () => {
-  const base = { token: "tok", password: "longenough", confirmPassword: "longenough" };
-
-  it("passes matching valid data", () => {
-    expect(validateResetPassword(base)).toEqual({ valid: true });
-  });
-
-  it("requires a token", () => {
-    expect(validateResetPassword({ ...base, token: "" })).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.invalidResetToken,
-    });
-  });
-
-  it("rejects mismatched confirmation", () => {
-    expect(validateResetPassword({ ...base, confirmPassword: "other" })).toEqual({
-      valid: false,
-      error: AUTH_VALIDATION_KEYS.passwordsDoNotMatch,
-    });
-  });
-});
-
-describe("display helpers", () => {
-  it("getUserDisplayName prefers name, then email, then null", () => {
-    expect(getUserDisplayName({ id: "1", name: "Ada", email: "a@b.co" } as never)).toBe("Ada");
-    expect(getUserDisplayName({ id: "1", email: "a@b.co" } as never)).toBe("a@b.co");
-    expect(getUserDisplayName(null)).toBeNull();
-  });
-
-  it("getUserInitials uses first and last name parts", () => {
-    expect(getUserInitials({ id: "1", name: "Ada Lovelace" } as never)).toBe("AL");
-    expect(getUserInitials({ id: "1", name: "ada" } as never)).toBe("AD");
-    expect(getUserInitials(null)).toBeNull();
-  });
-});
-
-describe("password strength", () => {
-  it("scores a strong password at 100", () => {
-    expect(calculatePasswordStrength("Str0ng!Password")).toBe(100);
-    expect(getPasswordStrengthBand("Str0ng!Password")).toBe("strong");
-  });
-
-  it("scores a weak password low", () => {
-    expect(getPasswordStrengthBand("abc")).toBe("weak");
-  });
-
-  it("never exceeds 100", () => {
-    expect(calculatePasswordStrength("aaaaaaaaaaaaaaaaaaaa!A1")).toBeLessThanOrEqual(100);
-  });
-});
-
-describe("maskEmail", () => {
-  it("masks the local part", () => {
-    expect(maskEmail("umit@example.com")).toBe("u***@example.com");
-  });
-
-  it("returns null for invalid input", () => {
-    expect(maskEmail("not-an-email")).toBeNull();
-  });
-});
-
-describe("sanitizeInput", () => {
-  it("trims and truncates", () => {
-    expect(sanitizeInput("  hello  ")).toBe("hello");
-    expect(sanitizeInput("abcdef", 3)).toBe("abc");
-  });
-});
-
-describe("generateResetToken", () => {
-  it("produces a hex string of 2 * length chars", () => {
-    const token = generateResetToken(16);
-    expect(token).toMatch(/^[0-9a-f]{32}$/);
-  });
-
-  it("produces different tokens on each call", () => {
-    expect(generateResetToken()).not.toBe(generateResetToken());
-  });
-});