forlogic-core 1.16.0 → 1.16.1

package/dist/providers/CoreProviders.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
+import { ModuleAccessGuardProps } from '../components/modules';
 /**
  * Props for CoreProviders component
  */
@@ -13,6 +14,21 @@ export interface CoreProvidersProps {
      * If not provided, a default QueryClient will be created
      */
     queryClient?: QueryClient;
+    /**
+     * Alias do módulo do projeto consumidor.
+     * Usado pelo hook useModuleAccess para verificar automaticamente
+     * se o usuário tem acesso ao módulo deste projeto.
+     * Quando configurado, o ModuleAccessGuard bloqueia automaticamente
+     * o acesso caso o usuário não tenha permissão.
+     *
+     * @example "performance" | "suppliers" | "occurrences" | "audit"
+     */
+    moduleAlias?: string;
+    /**
+     * Props opcionais para o ModuleAccessGuard.
+     * Permite configurar módulos contratados, callbacks e URLs.
+     */
+    moduleAccessGuardProps?: Omit<ModuleAccessGuardProps, 'children'>;
 }
 /**
  * CoreProviders - Encapsulates all essential providers for forlogic-core applications
@@ -23,7 +39,7 @@ export interface CoreProvidersProps {
  * - QueryClientProvider (data fetching)
  * - AuthProvider (authentication)
  * - LocaleProvider (locale management)
- * - TranslationLoader (removed - translations now loaded from local JSON)
+ * - ModuleProvider (module access configuration)
  *
  * @example
  * ```tsx
@@ -32,7 +48,7 @@ export interface CoreProvidersProps {
  *
  * function App() {
  *   return (
- *     <CoreProviders>
+ *     <CoreProviders moduleAlias="performance">
  *       <BrowserRouter>
  *         <Routes>
  *           {/* Your routes here *\/}
@@ -56,11 +72,11 @@ export interface CoreProvidersProps {
  *
  * function App() {
  *   return (
- *     <CoreProviders queryClient={queryClient}>
+ *     <CoreProviders queryClient={queryClient} moduleAlias="suppliers">
  *       {/* Your app *\/}
  *     </CoreProviders>
  *   );
  * }
  * ```
  */
-export declare function CoreProviders({ children, queryClient }: CoreProvidersProps): import("react/jsx-runtime").JSX.Element;
+export declare function CoreProviders({ children, queryClient, moduleAlias, moduleAccessGuardProps }: CoreProvidersProps): import("react/jsx-runtime").JSX.Element;

package/dist/qualiex/services/qualiexApi.d.ts

@@ -1,4 +1,4 @@
-import { QualiexUser } from '../../types';
+import { QualiexUser, Software, UserAssociation } from '../../types';
 declare class QualiexApiService {
     private get baseUrl();
     /**
@@ -17,6 +17,23 @@ declare class QualiexApiService {
     fetchUserById(userId: string, alias: string, companyId: string): Promise<QualiexUser | null>;
     fetchActiveUsersMap(alias: string, companyId: string): Promise<Map<string, QualiexUser>>;
     getUsers(alias: string): Promise<QualiexUser[]>;
+    /**
+     * Busca a lista de todos os módulos/softwares disponíveis na plataforma.
+     * GET /api/common/v1/softwares
+     *
+     * @param alias - Alias da unidade (usado no header un-alias)
+     * @returns Array de Software com id, alias, cores e nomes traduzidos
+     */
+    fetchSoftwares(alias: string): Promise<Software[]>;
+    /**
+     * Busca as associações do usuário (empresas, roles, módulos com acesso).
+     * GET /api/common/v1/Users/{userId}/associations
+     *
+     * @param userId - ID do usuário no Qualiex (subNewId / user.id)
+     * @param alias - Alias da unidade (usado no header un-alias)
+     * @returns Array de UserAssociation com softwares[], roleId, roleName, etc.
+     */
+    fetchUserAssociations(userId: string, alias: string): Promise<UserAssociation[]>;
 }
 export declare const qualiexApi: QualiexApiService;
 export {};

package/dist/setup.d.ts

@@ -6,6 +6,8 @@ interface QualiexCoreConfig {
     };
     theme?: 'light' | 'dark' | 'system';
     queryClient?: QueryClient;
+    /** Alias do módulo do projeto consumidor (ex: 'performance', 'suppliers', 'occurrences') */
+    moduleAlias?: string;
 }
 export declare function setupQualiexCore(config: QualiexCoreConfig): {
     queryClient: QueryClient;

package/dist/types.d.ts

@@ -471,6 +471,64 @@ export interface QualiexEnrichmentConfig {
     /** Sufixo padrão para campos de username (default: "_username") */
     userUsernameFieldSuffix?: string;
 }
+/**
+ * Representa um módulo/software disponível na plataforma Qualiex.
+ * Retornado pela API GET /api/common/v1/softwares
+ */
+export interface Software {
+    id: number;
+    alias: string;
+    color: string;
+    colorLight: string;
+    namePtBr: string;
+    nameUs: string;
+    nameEs: string;
+}
+/**
+ * Representa uma associação do usuário com uma empresa/unidade.
+ * Retornado pela API GET /api/common/v1/Users/{userId}/associations
+ *
+ * O array `softwares` contém os IDs dos módulos aos quais o usuário tem acesso.
+ * O `roleId` e `roleName` representam o papel do usuário naquela associação.
+ */
+export interface UserAssociation {
+    associationId: string;
+    userId: string;
+    userName: string;
+    companyId: string;
+    companyName: string;
+    companyAlias: string;
+    companyPhotoDate?: string;
+    language?: string;
+    roleId: string;
+    roleName: string;
+    placeId?: string;
+    placeName?: string;
+    softwares: number[];
+    functionalities: string[];
+    isQualitfy?: boolean;
+    isMetroex?: boolean;
+}
+/**
+ * Resultado do hook useModuleAccess
+ */
+export interface ModuleAccessResult {
+    /** Se o usuário tem acesso ao módulo configurado/especificado */
+    hasAccess: boolean;
+    /** Se os dados ainda estão carregando */
+    isLoading: boolean;
+    /** Role do usuário na associação atual */
+    role: {
+        id: string;
+        name: string;
+    } | null;
+    /** Associação completa do usuário para a unidade atual */
+    association: UserAssociation | null;
+    /** Função para verificar acesso a outro(s) módulo(s) */
+    hasAccessTo: (alias: string | string[]) => boolean;
+    /** Lista completa de softwares/módulos disponíveis na plataforma */
+    softwares: Software[];
+}
 export interface ApiResponse<T = unknown> {
     data: T;
     success: boolean;

package/docs/DESIGN_SYSTEM.md

@@ -131,6 +131,7 @@ function App() {
 - [ErrorBoundary](#errorboundary) - Componente de classe React que captura erros de renderização em componentes filhos, evitando que a aplicação inteira quebre.
 - [Hooks](#hooks) - Hooks utilitários da biblioteca forlogic-core para otimização, dados, formatação e UI. Todos os hooks seguem padrões React e são compatíveis com React Query quando aplicável.
 - [Internacionalização (i18n)](#i18n) - Sistema de internacionalização usando react-i18next com traduções carregadas de um arquivo JSON estático local (lib/i18n/translations.json). Suporta pt-BR, en-US e es-ES com gerenciamento de preferências do usuário.
+- [Controle de Acesso a Módulos](#moduleaccess) - Sistema para verificar e bloquear automaticamente o acesso do usuário a módulos da plataforma Qualiex. Inclui proteção automática de rotas via CoreProviders e hook para verificações programáticas.
 - [Segurança (Vite Config)](#security) - Plugin de segurança para Vite que aplica headers OWASP, CSP configurável, CORS seguro e proteções contra ataques comuns. Configuração centralizada para todos os projetos Forlogic.
 - [Services](#services) - Serviços utilitários da biblioteca forlogic-core para operações CRUD, envio de emails, tratamento de erros e gerenciamento de traduções. Todos os serviços são singletons prontos para uso.
 - [Utilities](#utilities) - Funções utilitárias essenciais exportadas pela biblioteca para manipulação de classes CSS, formatação de datas e valores monetários.
@@ -11558,6 +11559,27 @@ console.log(format?.description); // "Padrão Brasileiro"
 
 ---
 
+### Controle de Acesso a Módulos
+
+Sistema para verificar e bloquear automaticamente o acesso do usuário a módulos da plataforma Qualiex. Inclui proteção automática de rotas via CoreProviders e hook para verificações programáticas.
+
+**Uso:**
+```tsx
+present
+```
+
+**Exemplos:**
+
+**Exemplo Interativo:**
+```tsx
+// Ver seção de exemplos no arquivo
+```
+
+**Acessibilidade:**
+- Documentação de acessibilidade presente em HTML estruturado
+
+---
+
 ### Segurança (Vite Config)
 
 Plugin de segurança para Vite que aplica headers OWASP, CSP configurável, CORS seguro e proteções contra ataques comuns. Configuração centralizada para todos os projetos Forlogic.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -75,7 +75,7 @@
     "@radix-ui/react-toggle": "^1.1.9",
     "@radix-ui/react-toggle-group": "^1.1.10",
     "@radix-ui/react-tooltip": "^1.2.7",
-    "@supabase/supabase-js": "^2.98.0",
+    "@supabase/supabase-js": "^2.99.0",
     "@tanstack/react-query": "^5.83.0",
     "@tiptap/extension-color": "^3.14.0",
     "@tiptap/extension-highlight": "^3.14.0",