forlogic-core 2.4.1 → 2.4.3

package/dist/providers/CoreProviders.d.ts

@@ -38,6 +38,19 @@ export interface CoreProvidersProps {
      * @example "performance" | "suppliers" | "occurrences" | "audit"
      */
     moduleAlias?: string;
+    /**
+     * Base URL completa (até antes de `/Users/{userId}/associations`) usada para
+     * buscar as associações do usuário. Quando informada, a lib chama
+     *   `{associationsBaseUrl}/Users/{userId}/associations`
+     * em vez do default
+     *   `{QUALIEX_API_URL}/api/common/v1/Users/{userId}/associations`.
+     *
+     * Independente de `moduleAlias` — pode ser usada sem ativar o gating de módulo.
+     *
+     * @example associationsBaseUrl={import.meta.env.VITE_ASSOCIATIONS_API_URL}
+     *          // ex: "https://api.qualiex.com/api/inovacao/v1"
+     */
+    associationsBaseUrl?: 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, associationsBaseUrl, moduleAccessGuardProps, appTranslations, clarityProjectId, clarityMode, backend, securityMode, }: CoreProvidersProps): import("react/jsx-runtime").JSX.Element;

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

@@ -38,13 +38,23 @@ 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` é informado, a chamada vai para:
+     * `GET {opts.baseUrl}/Users/{userId}/associations`
+     *
+     * (o `baseUrl` deve incluir todo o prefixo, ex.:
+     *  `https://api.qualiex.com/api/inovacao/v1`)
      *
      * @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 outra base URL
      * @returns Array de UserAssociation com softwares[], roleId, roleName, etc.
      */
-    fetchUserAssociations(userId: string, alias: string): Promise<UserAssociation[]>;
+    fetchUserAssociations(userId: string, alias: string, opts?: {
+        baseUrl?: 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,47 @@
 | 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 | (DEPRECATED — substituído por `associationsBaseUrl`) |
+| associationsBaseUrl | string | Não | Base URL completa para `/Users/{userId}/associations`. Ver seção abaixo. |
 | 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 em outra base URL
+
+Por padrão, `useModuleAccess` (e o `ModuleAccessGuard`) busca as associações em:
+
+```
+{QUALIEX_API_URL}/api/common/v1/Users/{userId}/associations
+```
+
+Quando o módulo expõe seu próprio endpoint de associações, informe `associationsBaseUrl` no `CoreProviders`. A lib passa a chamar:
+
+```
+{associationsBaseUrl}/Users/{userId}/associations
+```
+
+`associationsBaseUrl` deve incluir todo o prefixo (host + `/api/{modulo}/v1`):
+
+```tsx
+<CoreProviders
+  backend="dotnet"
+  associationsBaseUrl={import.meta.env.VITE_ASSOCIATIONS_API_URL}
+  // ex: "https://api.qualiex.com/api/inovacao/v1"
+>
+  ...
+</CoreProviders>
+```
+
+Características:
+
+- **Uma única variável** — não exige `moduleAlias`. Pode ser usada sem ativar o `ModuleAccessGuard` (útil enquanto o software do módulo ainda não foi cadastrado no `SOFTWARES_MAP` da lib).
+- A API alvo 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.3",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",