forlogic-core 2.4.2 → 2.4.3

package/dist/providers/CoreProviders.d.ts

@@ -39,18 +39,18 @@ export interface CoreProvidersProps {
      */
     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
+     * 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`.
      *
-     * Exige `moduleAlias` configurado (o alias entra no path). Default: não
-     * informado → usa a common (comportamento atual).
+     * Independente de `moduleAlias` — pode ser usada sem ativar o gating de módulo.
      *
-     * @example moduleApiUrl={import.meta.env.VITE_MODULE_API_URL}
+     * @example associationsBaseUrl={import.meta.env.VITE_ASSOCIATIONS_API_URL}
+     *          // ex: "https://api.qualiex.com/api/inovacao/v1"
      */
-    moduleApiUrl?: string;
+    associationsBaseUrl?: string;
     /**
      * Props opcionais para o ModuleAccessGuard.
      * Permite configurar módulos contratados, callbacks e URLs.
@@ -132,4 +132,4 @@ export declare function getSecurityMode(): 'legacy' | 'strict';
  * }
  * ```
  */
-export declare function CoreProviders({ children, queryClient, moduleAlias, moduleApiUrl, 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

@@ -41,18 +41,19 @@ declare class QualiexApiService {
      *
      * 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`
+     * 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 a API do módulo
+     * @param opts - Override opcional para apontar para outra base URL
      * @returns Array de UserAssociation com softwares[], roleId, roleName, etc.
      */
     fetchUserAssociations(userId: string, alias: string, opts?: {
         baseUrl?: string;
-        moduleSegment?: string;
     }): Promise<UserAssociation[]>;
 }
 /**

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

@@ -29,43 +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 | Base URL da API do módulo para resolver associações. Ver seção "Associações pela API do módulo". |
+| 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 pela API do módulo
+## Associações em outra base URL
 
-Por padrão, `useModuleAccess` (e o `ModuleAccessGuard`) busca as associações do usuário em:
+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 `moduleApiUrl` no `CoreProviders`. A lib troca o segmento `common` pelo `moduleAlias` configurado:
+Quando o módulo expõe seu próprio endpoint de associações, informe `associationsBaseUrl` no `CoreProviders`. A lib passa a chamar:
 
 ```
-{moduleApiUrl}/api/{moduleAlias}/v1/Users/{userId}/associations
+{associationsBaseUrl}/Users/{userId}/associations
 ```
 
+`associationsBaseUrl` deve incluir todo o prefixo (host + `/api/{modulo}/v1`):
+
 ```tsx
 <CoreProviders
   backend="dotnet"
-  moduleAlias="inovacao"
-  moduleApiUrl={import.meta.env.VITE_MODULE_API_URL}
+  associationsBaseUrl={import.meta.env.VITE_ASSOCIATIONS_API_URL}
+  // ex: "https://api.qualiex.com/api/inovacao/v1"
 >
   ...
 </CoreProviders>
 ```
 
-Requisitos:
+Características:
 
-- `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>`.
+- **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.2",
+  "version": "2.4.3",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",