forlogic-core 2.4.1 → 2.4.2

package/dist/providers/CoreProviders.d.ts

@@ -38,6 +38,19 @@ export interface CoreProvidersProps {
      * @example "performance" | "suppliers" | "occurrences" | "audit"
      */
     moduleAlias?: string;
+    /**
+     * Base URL da API do módulo. Quando informada, `useModuleAccess` busca as
+     * associações em
+     *   `{moduleApiUrl}/api/{moduleAlias}/v1/Users/{userId}/associations`
+     * em vez de
+     *   `{QUALIEX_API_URL}/api/common/v1/Users/{userId}/associations`.
+     *
+     * Exige `moduleAlias` configurado (o alias entra no path). Default: não
+     * informado → usa a common (comportamento atual).
+     *
+     * @example moduleApiUrl={import.meta.env.VITE_MODULE_API_URL}
+     */
+    moduleApiUrl?: string;
     /**
      * Props opcionais para o ModuleAccessGuard.
      * Permite configurar módulos contratados, callbacks e URLs.
@@ -119,4 +132,4 @@ export declare function getSecurityMode(): 'legacy' | 'strict';
  * }
  * ```
  */
-export declare function CoreProviders({ children, queryClient, moduleAlias, moduleAccessGuardProps, appTranslations, clarityProjectId, clarityMode, backend, securityMode, }: CoreProvidersProps): import("react/jsx-runtime").JSX.Element;
+export declare function CoreProviders({ children, queryClient, moduleAlias, moduleApiUrl, moduleAccessGuardProps, appTranslations, clarityProjectId, clarityMode, backend, securityMode, }: CoreProvidersProps): import("react/jsx-runtime").JSX.Element;

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

@@ -38,13 +38,22 @@ declare class QualiexApiService {
     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
+     *
+     * Default: `GET {QUALIEX_API_URL}/api/common/v1/Users/{userId}/associations`
+     *
+     * Quando `opts.baseUrl` e `opts.moduleSegment` são informados, a chamada vai
+     * para a API do próprio módulo:
+     * `GET {opts.baseUrl}/api/{opts.moduleSegment}/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)
+     * @param opts - Override opcional para apontar para a API do módulo
      * @returns Array de UserAssociation com softwares[], roleId, roleName, etc.
      */
-    fetchUserAssociations(userId: string, alias: string): Promise<UserAssociation[]>;
+    fetchUserAssociations(userId: string, alias: string, opts?: {
+        baseUrl?: string;
+        moduleSegment?: string;
+    }): Promise<UserAssociation[]>;
 }
 /**
  * Singleton do serviço Qualiex (API common-v4) — usuários, grupos e unidades organizacionais.

package/docs/design-system/patterns/core-providers.md

@@ -29,12 +29,43 @@
 | children | ReactNode | Sim | Componentes filhos |
 | queryClient | QueryClient | Não | Instância customizada (default criado automaticamente) |
 | moduleAlias | string | Não | Alias do módulo para verificação de acesso |
+| moduleApiUrl | string | Não | Base URL da API do módulo para resolver associações. Ver seção "Associações pela API do módulo". |
 | moduleAccessGuardProps | object | Não | Props para o ModuleAccessGuard |
 | appTranslations | Record<string, Record<string, string>> | Não | Traduções por idioma no namespace 'app' |
 | clarityProjectId | string | Não | Project ID do Microsoft Clarity. Sem ele, integração desativada. |
 | clarityMode | 'auto' \| 'disabled' | Não | Opt-out do tracking Clarity. Default `'auto'`. |
 | backend | 'supabase' \| 'dotnet' | Não | Backend ativo. Default `'supabase'`. Ver seção abaixo. |
 
+## Associações pela API do módulo
+
+Por padrão, `useModuleAccess` (e o `ModuleAccessGuard`) busca as associações do usuário em:
+
+```
+{QUALIEX_API_URL}/api/common/v1/Users/{userId}/associations
+```
+
+Quando o módulo expõe seu próprio endpoint de associações, informe `moduleApiUrl` no `CoreProviders`. A lib troca o segmento `common` pelo `moduleAlias` configurado:
+
+```
+{moduleApiUrl}/api/{moduleAlias}/v1/Users/{userId}/associations
+```
+
+```tsx
+<CoreProviders
+  backend="dotnet"
+  moduleAlias="inovacao"
+  moduleApiUrl={import.meta.env.VITE_MODULE_API_URL}
+>
+  ...
+</CoreProviders>
+```
+
+Requisitos:
+
+- `moduleAlias` é obrigatório quando `moduleApiUrl` é informado (entra no path). Sem ele, a lib cai no comportamento default e emite `console.warn`.
+- A API do módulo deve responder no mesmo contrato (`UserAssociation[]`) e aceitar os headers `Authorization: Bearer <token>` e `un-alias: <alias>`.
+- Demais endpoints (`/companiesusers`, `/softwares`) continuam consultando a common.
+
 ## Backend (Supabase opcional)
 
 A prop `backend` controla se a lib usa o stack Supabase ou apenas a API .NET do Qualiex.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forlogic-core",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",