academe-kit 0.1.7 → 0.1.9

package/dist/types/components/ProtectedApp/index.d.ts

@@ -1,7 +1,7 @@
 type ProtectedAppProps = {
     children: React.ReactElement;
     requiredClientRoles?: string[];
-    unauthorizedMessage?: string;
+    requiredRealmRoles?: string[];
 };
 export declare const ProtectedApp: React.FC<ProtectedAppProps>;
 export {};

package/dist/types/context/SecurityProvider/types.d.ts

@@ -1,30 +1,33 @@
 import { KeycloakLoginOptions, KeycloakPromise } from 'keycloak-js';
+import { MongoDBUser } from '../../services/userService';
 export type AcademeKeycloakContextProps = {
     realm: string;
     hubUrl: string;
     clientId: string;
     keycloakUrl: string;
+    apiBaseUrl?: string;
     children: React.ReactElement;
 };
 export type SecurityProviderProps = {
     hubUrl: string;
+    apiBaseUrl?: string;
     children: React.ReactElement;
 };
 export type KeycloakUser = {
     name: string;
     lastName: string;
     email: string;
-    attributes: {
-        school_ids: Array<string>;
-    };
+};
+export type AcademeUser = MongoDBUser & {
+    keycloakUser?: KeycloakUser;
 };
 export type SecurityContextType = {
     isInitialized: boolean;
     isAuthenticated: () => boolean;
     signOut: () => void | null;
-    redirectToHub: (errorMessage: string) => void | null;
     goToLogin: (options?: KeycloakLoginOptions | undefined) => KeycloakPromise<void, void> | null;
-    getUser: () => KeycloakUser;
+    user: AcademeUser | null;
+    refreshUserData: () => Promise<void>;
     hasRealmRole: (role: string) => boolean;
     hasSchool: (schoolId: string) => boolean;
     hasClientRole: (role: string, resource?: string) => boolean;

package/dist/types/hooks/useCurrentUser.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Custom hook for accessing current user data
+ * Provides easy access to MongoDB-enriched user information
+ */
+import { AcademeUser } from '../context/SecurityProvider/types';
+export interface UseCurrentUserReturn {
+    user: AcademeUser | null;
+    isLoading: boolean;
+    error: Error | null;
+    userId: string | undefined;
+    email: string | undefined;
+    fullName: string | undefined;
+    schoolId: string | undefined;
+    roles: string[];
+    isStudent: boolean;
+    registrationNumber: string | undefined;
+    className: string | undefined;
+    completionRate: number;
+    engagementRate: number;
+    isAdmin: boolean;
+    isSchoolAdmin: boolean;
+    isTeacher: boolean;
+    hasCompletedOnboarding: boolean;
+    hasAccessEnabled: boolean;
+    refreshUser: () => Promise<void>;
+}
+export declare const useCurrentUser: () => UseCurrentUserReturn;
+/**
+ * Hook to check if user has a specific role
+ */
+export declare const useHasRole: (role: string) => boolean;
+/**
+ * Hook to check if user has any of the specified roles
+ */
+export declare const useHasAnyRole: (requiredRoles: string[]) => boolean;
+/**
+ * Hook to check if user has all of the specified roles
+ */
+export declare const useHasAllRoles: (requiredRoles: string[]) => boolean;
+/**
+ * Hook to check if user belongs to a specific school
+ */
+export declare const useHasSchoolAccess: (schoolId: string) => boolean;
+/**
+ * Hook for student-specific data and checks
+ */
+export declare const useStudentData: () => {
+    isStudent: boolean;
+    hasStudentData: boolean;
+    studentInfo: null;
+    academicInfo: null;
+    responsibleInfo: null;
+    metrics: null;
+} | {
+    isStudent: boolean;
+    hasStudentData: boolean;
+    studentInfo: {
+        registrationNumber: string | undefined;
+        cpf: string | undefined;
+        birthDate: string | undefined;
+        gender: string | undefined;
+        phone: string | undefined;
+    };
+    academicInfo: {
+        schoolYear: string | undefined;
+        grade: string | undefined;
+        className: string | undefined;
+        shift: string | undefined;
+        classId: string | undefined;
+    };
+    responsibleInfo: {
+        name: string | undefined;
+        email: string | undefined;
+        phone: string | undefined;
+    };
+    metrics: {
+        completionRate: number;
+        engagementRate: number;
+        hasCompletedOnboarding: boolean;
+        hasAccessEnabled: boolean;
+    };
+};

package/dist/types/index.d.ts

@@ -5,7 +5,9 @@ export { ProtectedComponent } from './components/ProtectedComponent';
 export { ProtectedRouter } from './components/ProtectedRouter';
 export { Spinner } from './components/ui/spinner';
 export { AcademeAuthProvider, useAcademeAuth } from './context/SecurityProvider';
-export type { AcademeKeycloakContextProps, SecurityProviderProps, KeycloakUser, SecurityContextType, } from './context/SecurityProvider/types';
+export { createUserService } from './services/userService';
+export type { MongoDBUser, UserServiceConfig } from './services/userService';
+export type { AcademeKeycloakContextProps, SecurityProviderProps, KeycloakUser, SecurityContextType, AcademeUser, } from './context/SecurityProvider/types';
 export { cn } from './lib/utils';
 import './index.css';
 import './styles/globals.css';

package/dist/types/services/userService.d.ts

@@ -0,0 +1,79 @@
+/**
+ * User Service - Fetches complete user data from MongoDB
+ * This service interacts with the new unified users collection
+ */
+export interface MongoDBUser {
+    id: string;
+    keycloak_user_id: string;
+    email: string;
+    full_name: string;
+    phone?: string;
+    school_id?: string;
+    active: boolean;
+    created_at: string;
+    updated_at: string;
+    last_login?: string;
+    registration_number?: string;
+    school_year?: string;
+    serie_ano?: string;
+    turma?: string;
+    turno?: string;
+    class_id?: string;
+    nome_responsavel?: string;
+    email_responsavel?: string;
+    telefone_responsavel?: string;
+    data_nascimento?: string;
+    cpf?: string;
+    sexo?: string;
+    completion_rate: number;
+    engagement_rate: number;
+    onboarding_completo: boolean;
+    acesso_liberado: boolean;
+    roles?: string[];
+}
+export interface UserServiceConfig {
+    apiBaseUrl: string;
+    getAccessToken: () => string | null;
+}
+declare class UserService {
+    private client;
+    private getAccessToken;
+    private cachedUser;
+    private cacheExpiry;
+    constructor(config: UserServiceConfig);
+    /**
+     * Get current user data from MongoDB
+     * Includes caching to reduce API calls
+     */
+    getCurrentUser(forceRefresh?: boolean): Promise<MongoDBUser | null>;
+    /**
+     * Update current user data
+     */
+    updateCurrentUser(data: Partial<MongoDBUser>): Promise<MongoDBUser | null>;
+    /**
+     * Clear cached user data
+     */
+    clearCache(): void;
+    /**
+     * Check if user has a specific role
+     */
+    hasRole(user: MongoDBUser | null, role: string): boolean;
+    /**
+     * Check if user has access to a specific school
+     */
+    hasSchoolAccess(user: MongoDBUser | null, schoolId: string): boolean;
+    /**
+     * Check if user is a student (has student-specific data)
+     */
+    isStudent(user: MongoDBUser | null): boolean;
+    /**
+     * Check if user has completed onboarding
+     */
+    hasCompletedOnboarding(user: MongoDBUser | null): boolean;
+    /**
+     * Check if user has access enabled
+     */
+    hasAccessEnabled(user: MongoDBUser | null): boolean;
+}
+export declare const createUserService: (config: UserServiceConfig) => UserService;
+export default UserService;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "academe-kit",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "A React component library with Tailwind CSS and Storybook",
   "main": "dist/index.js",