@archbase/security 4.2.6 → 4.3.1

package/dist/src/ArchbaseSecurityDiagnosticsService.d.ts

@@ -1,5 +1,5 @@
 import { ArchbaseRemoteApiClient } from '@archbase/data';
-import { ArchbaseAccessDecision, ArchbaseAccessOverview, ArchbaseOverviewItemPage, ArchbaseOverviewMetric, ArchbaseGroupReport, ArchbaseReachEntry, ArchbaseTreeBranch, ArchbaseTreeNodePage, ArchbaseEffectiveAccessReport, ArchbaseSimulationRequest } from './SecurityDiagnosticsDomain';
+import { ArchbaseSecurityEventPage, ArchbaseSecurityEventType, ArchbaseAccessDecision, ArchbaseAccessOverview, ArchbaseOverviewItemPage, ArchbaseOverviewMetric, ArchbaseGroupReport, ArchbaseReachEntry, ArchbaseTreeBranch, ArchbaseTreeNodePage, ArchbaseEffectiveAccessReport, ArchbaseSimulationRequest } from './SecurityDiagnosticsDomain';
 /**
  * Leitura do diagnóstico de acesso — `/api/v1/security/diagnostics/*`.
  *
@@ -17,6 +17,11 @@ export declare class ArchbaseSecurityDiagnosticsService {
     constructor(client: ArchbaseRemoteApiClient);
     protected configureHeaders(): Record<string, string>;
     protected getEndpoint(): string;
+    /**
+     * Base própria: a trilha vive fora do diagnóstico porque tem chave própria no backend
+     * ({@code archbase.security.audit.enabled}) e some inteira quando ela está desligada.
+     */
+    protected getAuditEndpoint(): string;
     /** Retrato do tenant: contagens do catálogo e o estado das proteções configuráveis. */
     getOverview(): Promise<ArchbaseAccessOverview>;
     /**
@@ -61,4 +66,21 @@ export declare class ArchbaseSecurityDiagnosticsService {
      * que precisa mudar para o acesso passar a existir.
      */
     simulate(request: ArchbaseSimulationRequest): Promise<ArchbaseAccessDecision>;
+    /**
+     * Os acontecimentos de segurança, do mais recente para o mais antigo.
+     *
+     * <p>Sem período informado o servidor assume os últimos trinta dias — a primeira consulta de
+     * quem abre a tela não deve varrer a tabela inteira.
+     *
+     * <p>Devolve 403 para quem não é administrador, e 404 quando a trilha está desligada: os dois
+     * casos precisam ser distinguidos na tela, porque significam coisas diferentes.
+     */
+    getAuditEvents(options?: {
+        usuario?: string;
+        tipo?: ArchbaseSecurityEventType;
+        inicio?: string;
+        fim?: string;
+        page?: number;
+        size?: number;
+    }): Promise<ArchbaseSecurityEventPage>;
 }

package/dist/src/SecurityDiagnosticsDomain.d.ts

@@ -219,3 +219,32 @@ export interface ArchbaseReachEntry {
     kind: string;
     situation: string;
 }
+/**
+ * O que a trilha registra além das alterações.
+ *
+ * <p>Entrar, errar a senha e ter acesso negado não mudam tabela nenhuma — a trilha de alterações,
+ * por construção, não os vê. São eles que respondem "quem tentou o quê", enquanto a outra metade
+ * responde "quem mudou o quê".
+ */
+export type ArchbaseSecurityEventType = 'LOGIN' | 'LOGIN_FALHOU' | 'LOGOUT' | 'ACESSO_NEGADO' | 'SIMULACAO';
+export interface ArchbaseSecurityEvent {
+    id: string;
+    tipo: ArchbaseSecurityEventType;
+    dataHora: string;
+    /** Pode não corresponder a ninguém: numa tentativa com e-mail inexistente é esse o dado útil. */
+    usuario?: string | null;
+    tenantId?: string | null;
+    origem?: string | null;
+    recurso?: string | null;
+    acao?: string | null;
+    /** O porquê: o portão que recusou, ou o tipo da falha de autenticação. */
+    detalhe?: string | null;
+    sucesso: boolean;
+}
+export interface ArchbaseSecurityEventPage {
+    content: ArchbaseSecurityEvent[];
+    totalElements: number;
+    totalPages: number;
+    number: number;
+    size: number;
+}

package/dist/src/SecurityDomain.d.ts

@@ -127,6 +127,28 @@ export declare class UserDto extends SecurityDto {
     email?: string;
     type: string;
     isNewUser: boolean;
+    /**
+     * Matrícula do funcionário na empresa: o número pelo qual o RH e a folha identificam a pessoa,
+     * e que costuma ser o elo com ponto, crachá e folha de pagamento.
+     *
+     * Opcional de propósito — contas de serviço e usuários que não são funcionários não têm uma.
+     * Não é única: bases herdadas de sistemas antigos costumam ter matrícula repetida, e quem
+     * precisar exigir unicidade cria o índice decidindo o escopo (global ou por tenant).
+     *
+     * Não confundir com {@link externalId}, que identifica a conta num provedor de identidade
+     * (Keycloak, LDAP). Uma é o vínculo empregatício, a outra é a credencial — convivem.
+     *
+     * Requer archbase-security 3.1.20 ou superior no backend.
+     */
+    employeeId?: string;
+    /**
+     * ID da conta num provedor de identidade externo (Keycloak, LDAP e afins).
+     *
+     * Existe no backend desde antes da matrícula, mas nunca esteve neste DTO — então a tela lia e
+     * devolvia o usuário sem ele. Declarado aqui para que o valor sobreviva a uma edição, junto com
+     * a correção do lado do servidor que passou a gravá-lo.
+     */
+    externalId?: string;
     constructor(data: any);
     static newInstance: () => UserDto;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archbase/security",
-  "version": "4.2.6",
+  "version": "4.3.1",
   "description": "Security and authentication components for Archbase React",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -37,10 +37,10 @@
     "reflect-metadata": "^0.1.13",
     "rxjs": "^7.8.2",
     "uuid": "^9.0.1",
-    "@archbase/components": "4.2.6",
-    "@archbase/core": "4.2.6",
-    "@archbase/data": "4.2.6",
-    "@archbase/layout": "4.2.6"
+    "@archbase/components": "4.3.1",
+    "@archbase/core": "4.3.1",
+    "@archbase/data": "4.3.1",
+    "@archbase/layout": "4.3.1"
   },
   "devDependencies": {
     "@types/crypto-js": "^4.1.1",