analytica-frontend-lib 1.0.91 → 1.0.93

package/dist/Auth/index.d.mts

@@ -0,0 +1,312 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, ComponentType } from 'react';
+
+/**
+ * Interface for basic authentication tokens
+ *
+ * @interface AuthTokens
+ * @property {string} token - Main authentication token
+ * @property {string} refreshToken - Token used to refresh the main token
+ * @property {unknown} [key] - Additional properties that can be included
+ */
+interface AuthTokens {
+    token: string;
+    refreshToken: string;
+    [key: string]: unknown;
+}
+/**
+ * Interface for basic user information
+ *
+ * @interface AuthUser
+ * @property {string} id - Unique user identifier
+ * @property {string} [name] - Optional user name
+ * @property {string} [email] - Optional user email
+ * @property {unknown} [key] - Additional user properties
+ */
+interface AuthUser {
+    id: string;
+    name?: string;
+    email?: string;
+    [key: string]: unknown;
+}
+/**
+ * Interface for basic session information
+ *
+ * @interface SessionInfo
+ * @property {string} [institutionId] - Optional institution identifier
+ * @property {string} [profileId] - Optional profile identifier
+ * @property {string} [schoolId] - Optional school identifier
+ * @property {string} [schoolYearId] - Optional school year identifier
+ * @property {string} [classId] - Optional class identifier
+ * @property {unknown} [key] - Additional session properties
+ */
+interface SessionInfo {
+    institutionId?: string;
+    profileId?: string;
+    schoolId?: string;
+    schoolYearId?: string;
+    classId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Interface for authentication state
+ *
+ * @interface AuthState
+ * @property {boolean} isAuthenticated - Whether the user is authenticated
+ * @property {boolean} isLoading - Whether authentication is being checked
+ * @property {AuthUser | null} [user] - Current user information
+ * @property {SessionInfo | null} [sessionInfo] - Current session information
+ * @property {AuthTokens | null} [tokens] - Current authentication tokens
+ */
+interface AuthState {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user?: AuthUser | null;
+    sessionInfo?: SessionInfo | null;
+    tokens?: AuthTokens | null;
+}
+/**
+ * Interface for authentication context functions and state
+ *
+ * @interface AuthContextType
+ * @extends {AuthState}
+ * @property {() => Promise<boolean>} checkAuth - Function to check authentication status
+ * @property {() => void} signOut - Function to sign out the user
+ */
+interface AuthContextType extends AuthState {
+    checkAuth: () => Promise<boolean>;
+    signOut: () => void;
+}
+/**
+ * Props for the AuthProvider component
+ *
+ * @interface AuthProviderProps
+ * @property {ReactNode} children - Child components
+ * @property {() => Promise<boolean> | boolean} [checkAuthFn] - Function to check if user is authenticated
+ * @property {() => void} [signOutFn] - Function to handle logout
+ * @property {Partial<AuthState>} [initialAuthState] - Initial authentication state
+ * @property {() => AuthUser | null | undefined} [getUserFn] - Function to get user data
+ * @property {() => SessionInfo | null | undefined} [getSessionFn] - Function to get session info
+ * @property {() => AuthTokens | null | undefined} [getTokensFn] - Function to get tokens
+ */
+interface AuthProviderProps {
+    children: ReactNode;
+    /**
+     * Função para verificar se o usuário está autenticado
+     * Deve retornar uma Promise<boolean>
+     */
+    checkAuthFn?: () => Promise<boolean> | boolean;
+    /**
+     * Função para fazer logout
+     */
+    signOutFn?: () => void;
+    /**
+     * Estado de autenticação inicial
+     */
+    initialAuthState?: Partial<AuthState>;
+    /**
+     * Função para obter dados do usuário (opcional)
+     */
+    getUserFn?: () => AuthUser | null | undefined;
+    /**
+     * Função para obter informações da sessão (opcional)
+     */
+    getSessionFn?: () => SessionInfo | null | undefined;
+    /**
+     * Função para obter tokens (opcional)
+     */
+    getTokensFn?: () => AuthTokens | null | undefined;
+}
+/**
+ * Authentication provider that manages global auth state
+ * Compatible with any store (Zustand, Redux, Context, etc.)
+ *
+ * @param {AuthProviderProps} props - The provider props
+ * @returns {JSX.Element} The provider component
+ *
+ * @example
+ * ```tsx
+ * <AuthProvider
+ *   checkAuthFn={checkAuthFunction}
+ *   signOutFn={signOutFunction}
+ *   getUserFn={getUserFunction}
+ * >
+ *   <App />
+ * </AuthProvider>
+ * ```
+ */
+declare const AuthProvider: ({ children, checkAuthFn, signOutFn, initialAuthState, getUserFn, getSessionFn, getTokensFn, }: AuthProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Hook to use the authentication context
+ *
+ * @throws {Error} When used outside of AuthProvider
+ * @returns {AuthContextType} The authentication context
+ *
+ * @example
+ * ```tsx
+ * const { isAuthenticated, user, signOut } = useAuth();
+ * ```
+ */
+declare const useAuth: () => AuthContextType;
+/**
+ * Props for the ProtectedRoute component
+ *
+ * @interface ProtectedRouteProps
+ * @property {ReactNode} children - Components to render when authenticated
+ * @property {string} [redirectTo] - Path to redirect when not authenticated (default: '/')
+ * @property {ReactNode} [loadingComponent] - Custom loading component
+ * @property {(authState: AuthState) => boolean} [additionalCheck] - Additional authentication check
+ */
+interface ProtectedRouteProps {
+    children: ReactNode;
+    /**
+     * Path para redirecionamento quando não autenticado
+     */
+    redirectTo?: string;
+    /**
+     * Componente de loading personalizado
+     */
+    loadingComponent?: ReactNode;
+    /**
+     * Função adicional de verificação (ex: verificar permissões específicas)
+     */
+    additionalCheck?: (authState: AuthState) => boolean;
+}
+/**
+ * Componente para proteger rotas que requerem autenticação
+ *
+ * @example
+ * ```tsx
+ * <ProtectedRoute redirectTo="/login">
+ *   <PainelPage />
+ * </ProtectedRoute>
+ * ```
+ */
+declare const ProtectedRoute: ({ children, redirectTo, loadingComponent, additionalCheck, }: ProtectedRouteProps) => react_jsx_runtime.JSX.Element | null;
+/**
+ * Props for the PublicRoute component
+ *
+ * @interface PublicRouteProps
+ * @property {ReactNode} children - Components to render
+ * @property {string} [redirectTo] - Path to redirect to (default: '/painel')
+ * @property {boolean} [redirectIfAuthenticated] - Whether to redirect if authenticated
+ * @property {boolean} [checkAuthBeforeRender] - Whether to check auth before rendering
+ */
+interface PublicRouteProps {
+    children: ReactNode;
+    /**
+     * Path para redirecionamento
+     */
+    redirectTo?: string;
+    /**
+     * Se deve redirecionar quando usuário estiver autenticado
+     */
+    redirectIfAuthenticated?: boolean;
+    /**
+     * Se deve verificar autenticação antes de renderizar
+     */
+    checkAuthBeforeRender?: boolean;
+}
+/**
+ * Componente para rotas públicas (login, recuperação de senha, etc.)
+ * Opcionalmente redireciona se o usuário já estiver autenticado
+ *
+ * @example
+ * ```tsx
+ * <PublicRoute redirectTo="/painel" redirectIfAuthenticated={true}>
+ *   <LoginPage />
+ * </PublicRoute>
+ * ```
+ */
+declare const PublicRoute: ({ children, redirectTo, redirectIfAuthenticated, checkAuthBeforeRender, }: PublicRouteProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Higher-Order Component to protect components with authentication
+ *
+ * @template P - Component props type
+ * @param {ComponentType<P>} Component - Component to wrap with authentication
+ * @param {Omit<ProtectedRouteProps, 'children'>} [options] - Protection options
+ * @returns {(props: P) => JSX.Element} Wrapped component
+ *
+ * @example
+ * ```tsx
+ * const ProtectedComponent = withAuth(MyComponent, {
+ *   redirectTo: "/login",
+ *   loadingComponent: <CustomSpinner />
+ * });
+ * ```
+ */
+declare const withAuth: <P extends object>(Component: ComponentType<P>, options?: Omit<ProtectedRouteProps, "children">) => (props: P) => react_jsx_runtime.JSX.Element;
+/**
+ * Hook for authentication guard with custom checks
+ *
+ * @param {object} [options] - Guard options
+ * @param {boolean} [options.requireAuth=true] - Whether authentication is required
+ * @param {(authState: AuthState) => boolean} [options.customCheck] - Custom check function
+ * @returns {object} Guard result with canAccess, isLoading, and authState
+ *
+ * @example
+ * ```tsx
+ * const { canAccess, isLoading } = useAuthGuard({
+ *   requireAuth: true,
+ *   customCheck: (authState) => authState.user?.role === 'admin'
+ * });
+ * ```
+ */
+declare const useAuthGuard: (options?: {
+    requireAuth?: boolean;
+    customCheck?: (authState: AuthState) => boolean;
+}) => {
+    canAccess: boolean;
+    isLoading: boolean;
+    authState: AuthContextType;
+};
+/**
+ * Hook to check authentication on specific routes
+ * Useful for conditional checks within components
+ *
+ * @param {string} [fallbackPath='/'] - Path to redirect when not authenticated
+ * @returns {object} Object with isAuthenticated, isLoading, and redirectToLogin function
+ *
+ * @example
+ * ```tsx
+ * const { isAuthenticated, redirectToLogin } = useRouteAuth();
+ *
+ * if (!isAuthenticated) {
+ *   return redirectToLogin();
+ * }
+ * ```
+ */
+declare const useRouteAuth: (fallbackPath?: string) => {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    redirectToLogin: () => react_jsx_runtime.JSX.Element;
+};
+/**
+ * Get the root domain from the current window location
+ * Handles localhost and subdomain cases
+ *
+ * @returns {string} The root domain URL
+ */
+declare const getRootDomain: () => string;
+declare const _default: {
+    AuthProvider: ({ children, checkAuthFn, signOutFn, initialAuthState, getUserFn, getSessionFn, getTokensFn, }: AuthProviderProps) => react_jsx_runtime.JSX.Element;
+    ProtectedRoute: ({ children, redirectTo, loadingComponent, additionalCheck, }: ProtectedRouteProps) => react_jsx_runtime.JSX.Element | null;
+    PublicRoute: ({ children, redirectTo, redirectIfAuthenticated, checkAuthBeforeRender, }: PublicRouteProps) => react_jsx_runtime.JSX.Element;
+    withAuth: <P extends object>(Component: ComponentType<P>, options?: Omit<ProtectedRouteProps, "children">) => (props: P) => react_jsx_runtime.JSX.Element;
+    useAuth: () => AuthContextType;
+    useAuthGuard: (options?: {
+        requireAuth?: boolean;
+        customCheck?: (authState: AuthState) => boolean;
+    }) => {
+        canAccess: boolean;
+        isLoading: boolean;
+        authState: AuthContextType;
+    };
+    useRouteAuth: (fallbackPath?: string) => {
+        isAuthenticated: boolean;
+        isLoading: boolean;
+        redirectToLogin: () => react_jsx_runtime.JSX.Element;
+    };
+};
+
+export { type AuthContextType, AuthProvider, type AuthProviderProps, type AuthState, type AuthTokens, type AuthUser, ProtectedRoute, type ProtectedRouteProps, PublicRoute, type PublicRouteProps, type SessionInfo, _default as default, getRootDomain, useAuth, useAuthGuard, useRouteAuth, withAuth };

package/dist/Auth/index.d.ts

@@ -1 +1,312 @@
-export * from '../index';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, ComponentType } from 'react';
+
+/**
+ * Interface for basic authentication tokens
+ *
+ * @interface AuthTokens
+ * @property {string} token - Main authentication token
+ * @property {string} refreshToken - Token used to refresh the main token
+ * @property {unknown} [key] - Additional properties that can be included
+ */
+interface AuthTokens {
+    token: string;
+    refreshToken: string;
+    [key: string]: unknown;
+}
+/**
+ * Interface for basic user information
+ *
+ * @interface AuthUser
+ * @property {string} id - Unique user identifier
+ * @property {string} [name] - Optional user name
+ * @property {string} [email] - Optional user email
+ * @property {unknown} [key] - Additional user properties
+ */
+interface AuthUser {
+    id: string;
+    name?: string;
+    email?: string;
+    [key: string]: unknown;
+}
+/**
+ * Interface for basic session information
+ *
+ * @interface SessionInfo
+ * @property {string} [institutionId] - Optional institution identifier
+ * @property {string} [profileId] - Optional profile identifier
+ * @property {string} [schoolId] - Optional school identifier
+ * @property {string} [schoolYearId] - Optional school year identifier
+ * @property {string} [classId] - Optional class identifier
+ * @property {unknown} [key] - Additional session properties
+ */
+interface SessionInfo {
+    institutionId?: string;
+    profileId?: string;
+    schoolId?: string;
+    schoolYearId?: string;
+    classId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Interface for authentication state
+ *
+ * @interface AuthState
+ * @property {boolean} isAuthenticated - Whether the user is authenticated
+ * @property {boolean} isLoading - Whether authentication is being checked
+ * @property {AuthUser | null} [user] - Current user information
+ * @property {SessionInfo | null} [sessionInfo] - Current session information
+ * @property {AuthTokens | null} [tokens] - Current authentication tokens
+ */
+interface AuthState {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    user?: AuthUser | null;
+    sessionInfo?: SessionInfo | null;
+    tokens?: AuthTokens | null;
+}
+/**
+ * Interface for authentication context functions and state
+ *
+ * @interface AuthContextType
+ * @extends {AuthState}
+ * @property {() => Promise<boolean>} checkAuth - Function to check authentication status
+ * @property {() => void} signOut - Function to sign out the user
+ */
+interface AuthContextType extends AuthState {
+    checkAuth: () => Promise<boolean>;
+    signOut: () => void;
+}
+/**
+ * Props for the AuthProvider component
+ *
+ * @interface AuthProviderProps
+ * @property {ReactNode} children - Child components
+ * @property {() => Promise<boolean> | boolean} [checkAuthFn] - Function to check if user is authenticated
+ * @property {() => void} [signOutFn] - Function to handle logout
+ * @property {Partial<AuthState>} [initialAuthState] - Initial authentication state
+ * @property {() => AuthUser | null | undefined} [getUserFn] - Function to get user data
+ * @property {() => SessionInfo | null | undefined} [getSessionFn] - Function to get session info
+ * @property {() => AuthTokens | null | undefined} [getTokensFn] - Function to get tokens
+ */
+interface AuthProviderProps {
+    children: ReactNode;
+    /**
+     * Função para verificar se o usuário está autenticado
+     * Deve retornar uma Promise<boolean>
+     */
+    checkAuthFn?: () => Promise<boolean> | boolean;
+    /**
+     * Função para fazer logout
+     */
+    signOutFn?: () => void;
+    /**
+     * Estado de autenticação inicial
+     */
+    initialAuthState?: Partial<AuthState>;
+    /**
+     * Função para obter dados do usuário (opcional)
+     */
+    getUserFn?: () => AuthUser | null | undefined;
+    /**
+     * Função para obter informações da sessão (opcional)
+     */
+    getSessionFn?: () => SessionInfo | null | undefined;
+    /**
+     * Função para obter tokens (opcional)
+     */
+    getTokensFn?: () => AuthTokens | null | undefined;
+}
+/**
+ * Authentication provider that manages global auth state
+ * Compatible with any store (Zustand, Redux, Context, etc.)
+ *
+ * @param {AuthProviderProps} props - The provider props
+ * @returns {JSX.Element} The provider component
+ *
+ * @example
+ * ```tsx
+ * <AuthProvider
+ *   checkAuthFn={checkAuthFunction}
+ *   signOutFn={signOutFunction}
+ *   getUserFn={getUserFunction}
+ * >
+ *   <App />
+ * </AuthProvider>
+ * ```
+ */
+declare const AuthProvider: ({ children, checkAuthFn, signOutFn, initialAuthState, getUserFn, getSessionFn, getTokensFn, }: AuthProviderProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Hook to use the authentication context
+ *
+ * @throws {Error} When used outside of AuthProvider
+ * @returns {AuthContextType} The authentication context
+ *
+ * @example
+ * ```tsx
+ * const { isAuthenticated, user, signOut } = useAuth();
+ * ```
+ */
+declare const useAuth: () => AuthContextType;
+/**
+ * Props for the ProtectedRoute component
+ *
+ * @interface ProtectedRouteProps
+ * @property {ReactNode} children - Components to render when authenticated
+ * @property {string} [redirectTo] - Path to redirect when not authenticated (default: '/')
+ * @property {ReactNode} [loadingComponent] - Custom loading component
+ * @property {(authState: AuthState) => boolean} [additionalCheck] - Additional authentication check
+ */
+interface ProtectedRouteProps {
+    children: ReactNode;
+    /**
+     * Path para redirecionamento quando não autenticado
+     */
+    redirectTo?: string;
+    /**
+     * Componente de loading personalizado
+     */
+    loadingComponent?: ReactNode;
+    /**
+     * Função adicional de verificação (ex: verificar permissões específicas)
+     */
+    additionalCheck?: (authState: AuthState) => boolean;
+}
+/**
+ * Componente para proteger rotas que requerem autenticação
+ *
+ * @example
+ * ```tsx
+ * <ProtectedRoute redirectTo="/login">
+ *   <PainelPage />
+ * </ProtectedRoute>
+ * ```
+ */
+declare const ProtectedRoute: ({ children, redirectTo, loadingComponent, additionalCheck, }: ProtectedRouteProps) => react_jsx_runtime.JSX.Element | null;
+/**
+ * Props for the PublicRoute component
+ *
+ * @interface PublicRouteProps
+ * @property {ReactNode} children - Components to render
+ * @property {string} [redirectTo] - Path to redirect to (default: '/painel')
+ * @property {boolean} [redirectIfAuthenticated] - Whether to redirect if authenticated
+ * @property {boolean} [checkAuthBeforeRender] - Whether to check auth before rendering
+ */
+interface PublicRouteProps {
+    children: ReactNode;
+    /**
+     * Path para redirecionamento
+     */
+    redirectTo?: string;
+    /**
+     * Se deve redirecionar quando usuário estiver autenticado
+     */
+    redirectIfAuthenticated?: boolean;
+    /**
+     * Se deve verificar autenticação antes de renderizar
+     */
+    checkAuthBeforeRender?: boolean;
+}
+/**
+ * Componente para rotas públicas (login, recuperação de senha, etc.)
+ * Opcionalmente redireciona se o usuário já estiver autenticado
+ *
+ * @example
+ * ```tsx
+ * <PublicRoute redirectTo="/painel" redirectIfAuthenticated={true}>
+ *   <LoginPage />
+ * </PublicRoute>
+ * ```
+ */
+declare const PublicRoute: ({ children, redirectTo, redirectIfAuthenticated, checkAuthBeforeRender, }: PublicRouteProps) => react_jsx_runtime.JSX.Element;
+/**
+ * Higher-Order Component to protect components with authentication
+ *
+ * @template P - Component props type
+ * @param {ComponentType<P>} Component - Component to wrap with authentication
+ * @param {Omit<ProtectedRouteProps, 'children'>} [options] - Protection options
+ * @returns {(props: P) => JSX.Element} Wrapped component
+ *
+ * @example
+ * ```tsx
+ * const ProtectedComponent = withAuth(MyComponent, {
+ *   redirectTo: "/login",
+ *   loadingComponent: <CustomSpinner />
+ * });
+ * ```
+ */
+declare const withAuth: <P extends object>(Component: ComponentType<P>, options?: Omit<ProtectedRouteProps, "children">) => (props: P) => react_jsx_runtime.JSX.Element;
+/**
+ * Hook for authentication guard with custom checks
+ *
+ * @param {object} [options] - Guard options
+ * @param {boolean} [options.requireAuth=true] - Whether authentication is required
+ * @param {(authState: AuthState) => boolean} [options.customCheck] - Custom check function
+ * @returns {object} Guard result with canAccess, isLoading, and authState
+ *
+ * @example
+ * ```tsx
+ * const { canAccess, isLoading } = useAuthGuard({
+ *   requireAuth: true,
+ *   customCheck: (authState) => authState.user?.role === 'admin'
+ * });
+ * ```
+ */
+declare const useAuthGuard: (options?: {
+    requireAuth?: boolean;
+    customCheck?: (authState: AuthState) => boolean;
+}) => {
+    canAccess: boolean;
+    isLoading: boolean;
+    authState: AuthContextType;
+};
+/**
+ * Hook to check authentication on specific routes
+ * Useful for conditional checks within components
+ *
+ * @param {string} [fallbackPath='/'] - Path to redirect when not authenticated
+ * @returns {object} Object with isAuthenticated, isLoading, and redirectToLogin function
+ *
+ * @example
+ * ```tsx
+ * const { isAuthenticated, redirectToLogin } = useRouteAuth();
+ *
+ * if (!isAuthenticated) {
+ *   return redirectToLogin();
+ * }
+ * ```
+ */
+declare const useRouteAuth: (fallbackPath?: string) => {
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    redirectToLogin: () => react_jsx_runtime.JSX.Element;
+};
+/**
+ * Get the root domain from the current window location
+ * Handles localhost and subdomain cases
+ *
+ * @returns {string} The root domain URL
+ */
+declare const getRootDomain: () => string;
+declare const _default: {
+    AuthProvider: ({ children, checkAuthFn, signOutFn, initialAuthState, getUserFn, getSessionFn, getTokensFn, }: AuthProviderProps) => react_jsx_runtime.JSX.Element;
+    ProtectedRoute: ({ children, redirectTo, loadingComponent, additionalCheck, }: ProtectedRouteProps) => react_jsx_runtime.JSX.Element | null;
+    PublicRoute: ({ children, redirectTo, redirectIfAuthenticated, checkAuthBeforeRender, }: PublicRouteProps) => react_jsx_runtime.JSX.Element;
+    withAuth: <P extends object>(Component: ComponentType<P>, options?: Omit<ProtectedRouteProps, "children">) => (props: P) => react_jsx_runtime.JSX.Element;
+    useAuth: () => AuthContextType;
+    useAuthGuard: (options?: {
+        requireAuth?: boolean;
+        customCheck?: (authState: AuthState) => boolean;
+    }) => {
+        canAccess: boolean;
+        isLoading: boolean;
+        authState: AuthContextType;
+    };
+    useRouteAuth: (fallbackPath?: string) => {
+        isAuthenticated: boolean;
+        isLoading: boolean;
+        redirectToLogin: () => react_jsx_runtime.JSX.Element;
+    };
+};
+
+export { type AuthContextType, AuthProvider, type AuthProviderProps, type AuthState, type AuthTokens, type AuthUser, ProtectedRoute, type ProtectedRouteProps, PublicRoute, type PublicRouteProps, type SessionInfo, _default as default, getRootDomain, useAuth, useAuthGuard, useRouteAuth, withAuth };

package/dist/Auth/index.js

@@ -210,3 +210,4 @@ var Auth_default = {
   useRouteAuth,
   withAuth
 });
+//# sourceMappingURL=index.js.map

package/dist/Auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/Auth/Auth.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n  ReactNode,\n  ComponentType,\n  useCallback,\n  useMemo,\n} from 'react';\nimport { useLocation, Navigate } from 'react-router-dom';\n\n/**\n * Interface for basic authentication tokens\n *\n * @interface AuthTokens\n * @property {string} token - Main authentication token\n * @property {string} refreshToken - Token used to refresh the main token\n * @property {unknown} [key] - Additional properties that can be included\n */\nexport interface AuthTokens {\n  token: string;\n  refreshToken: string;\n  [key: string]: unknown;\n}\n\n/**\n * Interface for basic user information\n *\n * @interface AuthUser\n * @property {string} id - Unique user identifier\n * @property {string} [name] - Optional user name\n * @property {string} [email] - Optional user email\n * @property {unknown} [key] - Additional user properties\n */\nexport interface AuthUser {\n  id: string;\n  name?: string;\n  email?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Interface for basic session information\n *\n * @interface SessionInfo\n * @property {string} [institutionId] - Optional institution identifier\n * @property {string} [profileId] - Optional profile identifier\n * @property {string} [schoolId] - Optional school identifier\n * @property {string} [schoolYearId] - Optional school year identifier\n * @property {string} [classId] - Optional class identifier\n * @property {unknown} [key] - Additional session properties\n */\nexport interface SessionInfo {\n  institutionId?: string;\n  profileId?: string;\n  schoolId?: string;\n  schoolYearId?: string;\n  classId?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Interface for authentication state\n *\n * @interface AuthState\n * @property {boolean} isAuthenticated - Whether the user is authenticated\n * @property {boolean} isLoading - Whether authentication is being checked\n * @property {AuthUser | null} [user] - Current user information\n * @property {SessionInfo | null} [sessionInfo] - Current session information\n * @property {AuthTokens | null} [tokens] - Current authentication tokens\n */\nexport interface AuthState {\n  isAuthenticated: boolean;\n  isLoading: boolean;\n  user?: AuthUser | null;\n  sessionInfo?: SessionInfo | null;\n  tokens?: AuthTokens | null;\n}\n\n/**\n * Interface for authentication context functions and state\n *\n * @interface AuthContextType\n * @extends {AuthState}\n * @property {() => Promise<boolean>} checkAuth - Function to check authentication status\n * @property {() => void} signOut - Function to sign out the user\n */\nexport interface AuthContextType extends AuthState {\n  checkAuth: () => Promise<boolean>;\n  signOut: () => void;\n}\n\n/**\n * Authentication context for React components\n *\n * @private\n */\nconst AuthContext = createContext<AuthContextType | undefined>(undefined);\n\n/**\n * Props for the AuthProvider component\n *\n * @interface AuthProviderProps\n * @property {ReactNode} children - Child components\n * @property {() => Promise<boolean> | boolean} [checkAuthFn] - Function to check if user is authenticated\n * @property {() => void} [signOutFn] - Function to handle logout\n * @property {Partial<AuthState>} [initialAuthState] - Initial authentication state\n * @property {() => AuthUser | null | undefined} [getUserFn] - Function to get user data\n * @property {() => SessionInfo | null | undefined} [getSessionFn] - Function to get session info\n * @property {() => AuthTokens | null | undefined} [getTokensFn] - Function to get tokens\n */\nexport interface AuthProviderProps {\n  children: ReactNode;\n  /**\n   * Função para verificar se o usuário está autenticado\n   * Deve retornar uma Promise<boolean>\n   */\n  checkAuthFn?: () => Promise<boolean> | boolean;\n  /**\n   * Função para fazer logout\n   */\n  signOutFn?: () => void;\n  /**\n   * Estado de autenticação inicial\n   */\n  initialAuthState?: Partial<AuthState>;\n  /**\n   * Função para obter dados do usuário (opcional)\n   */\n  getUserFn?: () => AuthUser | null | undefined;\n  /**\n   * Função para obter informações da sessão (opcional)\n   */\n  getSessionFn?: () => SessionInfo | null | undefined;\n  /**\n   * Função para obter tokens (opcional)\n   */\n  getTokensFn?: () => AuthTokens | null | undefined;\n}\n\n/**\n * Authentication provider that manages global auth state\n * Compatible with any store (Zustand, Redux, Context, etc.)\n *\n * @param {AuthProviderProps} props - The provider props\n * @returns {JSX.Element} The provider component\n *\n * @example\n * ```tsx\n * <AuthProvider\n *   checkAuthFn={checkAuthFunction}\n *   signOutFn={signOutFunction}\n *   getUserFn={getUserFunction}\n * >\n *   <App />\n * </AuthProvider>\n * ```\n */\nexport const AuthProvider = ({\n  children,\n  checkAuthFn,\n  signOutFn,\n  initialAuthState = {},\n  getUserFn,\n  getSessionFn,\n  getTokensFn,\n}: AuthProviderProps) => {\n  const [authState, setAuthState] = useState<AuthState>({\n    isAuthenticated: false,\n    isLoading: true,\n    ...initialAuthState,\n  });\n\n  /**\n   * Check authentication status and update state accordingly\n   *\n   * @returns {Promise<boolean>} Promise that resolves to authentication status\n   */\n  const checkAuth = useCallback(async (): Promise<boolean> => {\n    try {\n      setAuthState((prev) => ({ ...prev, isLoading: true }));\n\n      // Se não há função de verificação, assume como não autenticado\n      if (!checkAuthFn) {\n        setAuthState((prev) => ({\n          ...prev,\n          isAuthenticated: false,\n          isLoading: false,\n        }));\n        return false;\n      }\n\n      const isAuth = await checkAuthFn();\n\n      setAuthState((prev) => ({\n        ...prev,\n        isAuthenticated: isAuth,\n        isLoading: false,\n        user: getUserFn ? getUserFn() : prev.user,\n        sessionInfo: getSessionFn ? getSessionFn() : prev.sessionInfo,\n        tokens: getTokensFn ? getTokensFn() : prev.tokens,\n      }));\n\n      return isAuth;\n    } catch (error) {\n      console.error('Erro ao verificar autenticação:', error);\n      setAuthState((prev) => ({\n        ...prev,\n        isAuthenticated: false,\n        isLoading: false,\n      }));\n      return false;\n    }\n  }, [checkAuthFn, getUserFn, getSessionFn, getTokensFn]);\n\n  /**\n   * Sign out the current user and clear auth state\n   *\n   * @returns {void}\n   */\n  const signOut = useCallback(() => {\n    if (signOutFn) {\n      signOutFn();\n    }\n    setAuthState((prev) => ({\n      ...prev,\n      isAuthenticated: false,\n      user: undefined,\n      sessionInfo: undefined,\n      tokens: undefined,\n    }));\n  }, [signOutFn]);\n\n  useEffect(() => {\n    checkAuth();\n  }, [checkAuth]);\n\n  const contextValue = useMemo(\n    (): AuthContextType => ({\n      ...authState,\n      checkAuth,\n      signOut,\n    }),\n    [authState, checkAuth, signOut]\n  );\n\n  return (\n    <AuthContext.Provider value={contextValue}>{children}</AuthContext.Provider>\n  );\n};\n\n/**\n * Hook to use the authentication context\n *\n * @throws {Error} When used outside of AuthProvider\n * @returns {AuthContextType} The authentication context\n *\n * @example\n * ```tsx\n * const { isAuthenticated, user, signOut } = useAuth();\n * ```\n */\nexport const useAuth = (): AuthContextType => {\n  const context = useContext(AuthContext);\n  if (context === undefined) {\n    throw new Error('useAuth deve ser usado dentro de um AuthProvider');\n  }\n  return context;\n};\n\n/**\n * Props for the ProtectedRoute component\n *\n * @interface ProtectedRouteProps\n * @property {ReactNode} children - Components to render when authenticated\n * @property {string} [redirectTo] - Path to redirect when not authenticated (default: '/')\n * @property {ReactNode} [loadingComponent] - Custom loading component\n * @property {(authState: AuthState) => boolean} [additionalCheck] - Additional authentication check\n */\nexport interface ProtectedRouteProps {\n  children: ReactNode;\n  /**\n   * Path para redirecionamento quando não autenticado\n   */\n  redirectTo?: string;\n  /**\n   * Componente de loading personalizado\n   */\n  loadingComponent?: ReactNode;\n  /**\n   * Função adicional de verificação (ex: verificar permissões específicas)\n   */\n  additionalCheck?: (authState: AuthState) => boolean;\n}\n\n/**\n * Componente para proteger rotas que requerem autenticação\n *\n * @example\n * ```tsx\n * <ProtectedRoute redirectTo=\"/login\">\n *   <PainelPage />\n * </ProtectedRoute>\n * ```\n */\nexport const ProtectedRoute = ({\n  children,\n  redirectTo = '/',\n  loadingComponent,\n  additionalCheck,\n}: ProtectedRouteProps) => {\n  const { isAuthenticated, isLoading, ...authState } = useAuth();\n\n  // Componente de loading padrão\n  const defaultLoadingComponent = (\n    <div className=\"flex items-center justify-center min-h-screen\">\n      <div className=\"text-text-950 text-lg\">Carregando...</div>\n    </div>\n  );\n\n  // Mostrar loading enquanto verifica autenticação\n  if (isLoading) {\n    return <>{loadingComponent || defaultLoadingComponent}</>;\n  }\n\n  // Verificar autenticação básica\n  if (!isAuthenticated) {\n    if (typeof window !== 'undefined') {\n      const rootDomain = getRootDomain();\n      // Only redirect if the root domain is different from current location\n      const currentLocation = `${window.location.protocol}//${window.location.hostname}${window.location.port ? ':' + window.location.port : ''}`;\n      if (rootDomain !== currentLocation) {\n        window.location.href = rootDomain;\n        return null;\n      }\n    }\n    return <Navigate to={redirectTo} replace />;\n  }\n\n  // Verificação adicional (ex: permissões)\n  if (\n    additionalCheck &&\n    !additionalCheck({ isAuthenticated, isLoading, ...authState })\n  ) {\n    return <Navigate to={redirectTo} replace />;\n  }\n\n  return <>{children}</>;\n};\n\n/**\n * Props for the PublicRoute component\n *\n * @interface PublicRouteProps\n * @property {ReactNode} children - Components to render\n * @property {string} [redirectTo] - Path to redirect to (default: '/painel')\n * @property {boolean} [redirectIfAuthenticated] - Whether to redirect if authenticated\n * @property {boolean} [checkAuthBeforeRender] - Whether to check auth before rendering\n */\nexport interface PublicRouteProps {\n  children: ReactNode;\n  /**\n   * Path para redirecionamento\n   */\n  redirectTo?: string;\n  /**\n   * Se deve redirecionar quando usuário estiver autenticado\n   */\n  redirectIfAuthenticated?: boolean;\n  /**\n   * Se deve verificar autenticação antes de renderizar\n   */\n  checkAuthBeforeRender?: boolean;\n}\n\n/**\n * Componente para rotas públicas (login, recuperação de senha, etc.)\n * Opcionalmente redireciona se o usuário já estiver autenticado\n *\n * @example\n * ```tsx\n * <PublicRoute redirectTo=\"/painel\" redirectIfAuthenticated={true}>\n *   <LoginPage />\n * </PublicRoute>\n * ```\n */\nexport const PublicRoute = ({\n  children,\n  redirectTo = '/painel',\n  redirectIfAuthenticated = false,\n  checkAuthBeforeRender = false,\n}: PublicRouteProps) => {\n  const { isAuthenticated, isLoading } = useAuth();\n\n  // Se deve aguardar verificação de auth antes de renderizar\n  if (checkAuthBeforeRender && isLoading) {\n    return (\n      <div className=\"flex items-center justify-center min-h-screen\">\n        <div className=\"text-text-950 text-lg\">Carregando...</div>\n      </div>\n    );\n  }\n\n  // Redirecionar se já autenticado e configurado para isso\n  if (isAuthenticated && redirectIfAuthenticated) {\n    return <Navigate to={redirectTo} replace />;\n  }\n\n  return <>{children}</>;\n};\n\n/**\n * Higher-Order Component to protect components with authentication\n *\n * @template P - Component props type\n * @param {ComponentType<P>} Component - Component to wrap with authentication\n * @param {Omit<ProtectedRouteProps, 'children'>} [options] - Protection options\n * @returns {(props: P) => JSX.Element} Wrapped component\n *\n * @example\n * ```tsx\n * const ProtectedComponent = withAuth(MyComponent, {\n *   redirectTo: \"/login\",\n *   loadingComponent: <CustomSpinner />\n * });\n * ```\n */\nexport const withAuth = <P extends object>(\n  Component: ComponentType<P>,\n  options: Omit<ProtectedRouteProps, 'children'> = {}\n) => {\n  return (props: P) => (\n    <ProtectedRoute {...options}>\n      <Component {...props} />\n    </ProtectedRoute>\n  );\n};\n\n/**\n * Hook for authentication guard with custom checks\n *\n * @param {object} [options] - Guard options\n * @param {boolean} [options.requireAuth=true] - Whether authentication is required\n * @param {(authState: AuthState) => boolean} [options.customCheck] - Custom check function\n * @returns {object} Guard result with canAccess, isLoading, and authState\n *\n * @example\n * ```tsx\n * const { canAccess, isLoading } = useAuthGuard({\n *   requireAuth: true,\n *   customCheck: (authState) => authState.user?.role === 'admin'\n * });\n * ```\n */\nexport const useAuthGuard = (\n  options: {\n    requireAuth?: boolean;\n    customCheck?: (authState: AuthState) => boolean;\n  } = {}\n) => {\n  const authState = useAuth();\n  const { requireAuth = true, customCheck } = options;\n\n  const canAccess =\n    !authState.isLoading &&\n    (requireAuth\n      ? authState.isAuthenticated && (!customCheck || customCheck(authState))\n      : !authState.isAuthenticated || !customCheck || customCheck(authState));\n\n  return {\n    canAccess,\n    isLoading: authState.isLoading,\n    authState,\n  };\n};\n\n/**\n * Hook to check authentication on specific routes\n * Useful for conditional checks within components\n *\n * @param {string} [fallbackPath='/'] - Path to redirect when not authenticated\n * @returns {object} Object with isAuthenticated, isLoading, and redirectToLogin function\n *\n * @example\n * ```tsx\n * const { isAuthenticated, redirectToLogin } = useRouteAuth();\n *\n * if (!isAuthenticated) {\n *   return redirectToLogin();\n * }\n * ```\n */\nexport const useRouteAuth = (fallbackPath = '/') => {\n  const { isAuthenticated, isLoading } = useAuth();\n  const location = useLocation();\n\n  const redirectToLogin = () => (\n    <Navigate to={fallbackPath} state={{ from: location }} replace />\n  );\n\n  return {\n    isAuthenticated,\n    isLoading,\n    redirectToLogin,\n  };\n};\n\n/**\n * Get the root domain from the current window location\n * Handles localhost and subdomain cases\n *\n * @returns {string} The root domain URL\n */\nexport const getRootDomain = () => {\n  const { hostname, protocol, port } = window.location;\n  const portStr = port ? ':' + port : '';\n  if (hostname === 'localhost') {\n    return `${protocol}//${hostname}${portStr}`;\n  }\n  const parts = hostname.split('.');\n  // Only treat as subdomain if there are 3+ parts (e.g., subdomain.example.com)\n  if (parts.length > 2) {\n    // Return the last 2 parts as the root domain (example.com)\n    const base = parts.slice(-2).join('.');\n    return `${protocol}//${base}${portStr}`;\n  }\n  // For 2-part domains (example.com) or single domains, return as-is\n  return `${protocol}//${hostname}${portStr}`;\n};\n\nexport default {\n  AuthProvider,\n  ProtectedRoute,\n  PublicRoute,\n  withAuth,\n  useAuth,\n  useAuthGuard,\n  useRouteAuth,\n};\n"],"mappings":"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","names":[]}

package/dist/Auth/index.mjs

@@ -185,3 +185,4 @@ export {
   useRouteAuth,
   withAuth
 };
+//# sourceMappingURL=index.mjs.map