rl-core-front 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rl-core-front",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Telas e componentes Next.js do core: login com 2FA, usu\u00e1rios, RBAC, auditoria, logs e listagens com filtro din\u00e2mico",
   "author": "Rodrigo Liberti",
   "license": "MIT",

package/src/_services/api/app-error-code.enum.ts

@@ -0,0 +1,23 @@
+/**
+ * Espelho do `AppErrorCode` do backend (core/filters/appErrorCode.enum.ts).
+ *
+ * Chave de protocolo, então continua string (§7): o valor é o que trafega no
+ * corpo do erro, e a tradução de cada um mora em `errors.codes.<CÓDIGO>` no
+ * dicionário de i18n.
+ *
+ * Só entra aqui o código que a interface precisa **reconhecer** para mudar de
+ * comportamento — mostrar a mensagem não exige nada disto, porque o
+ * `useRequest` já traduz pelo código que veio.
+ */
+export enum AppErrorCode {
+  /** Conta travada por excesso de tentativas. Só um admin reabre. */
+  ACCOUNT_LOCKED = "ACCOUNT_LOCKED",
+  /** Conta desativada por um administrador. */
+  ACCOUNT_INACTIVE = "ACCOUNT_INACTIVE",
+  /** E-mail/senha não conferem. */
+  INVALID_CREDENTIALS = "INVALID_CREDENTIALS",
+  /** Código de 2FA não confere. */
+  INVALID_TWO_FACTOR_CODE = "INVALID_TWO_FACTOR_CODE",
+  /** A janela entre a senha e o 2FA venceu — refazer o login resolve. */
+  PENDING_TOKEN_EXPIRED = "PENDING_TOKEN_EXPIRED",
+}

package/src/_services/api/schema.d.ts

@@ -528,6 +528,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/rbac/groups/managed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["RbacController_managedGroups"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/rbac/groups/{id}": {
         parameters: {
             query?: never;
@@ -608,46 +624,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/audit/changes": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get: operations["AuditController_changes"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/audit/changes/filter-schema": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get: operations["AuditController_changesFilterSchema"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/audit/errors": {
+    "/audit/requests": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: operations["AuditController_errors"];
+        get: operations["AuditController_requests"];
         put?: never;
         post?: never;
         delete?: never;
@@ -656,14 +640,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/audit/errors/filter-schema": {
+    "/audit/requests/filter-schema": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: operations["AuditController_errorsFilterSchema"];
+        get: operations["AuditController_requestsFilterSchema"];
         put?: never;
         post?: never;
         delete?: never;
@@ -919,6 +903,7 @@ export interface components {
             /** @default true */
             isActive: boolean;
             roleIds?: string[];
+            groupIds?: string[];
         };
         UpdateUserCommand: {
             name?: string;
@@ -928,6 +913,7 @@ export interface components {
             /** @default true */
             isActive: boolean;
             roleIds?: string[];
+            groupIds?: string[];
         };
         ResourceResponse: {
             /** Format: uuid */
@@ -1081,6 +1067,8 @@ export interface components {
             type: components["schemas"]["GroupType"];
             /** Format: uuid */
             parentId?: string | null;
+            /** Format: uuid */
+            managerId?: string | null;
             isActive: boolean;
             roles?: components["schemas"]["RoleResponse"][];
         };
@@ -1094,6 +1082,8 @@ export interface components {
             type: "company" | "department" | "team";
             /** Format: uuid */
             parentId?: string;
+            /** Format: uuid */
+            managerId?: string | null;
             roleIds?: string[];
         };
         UpdateGroupCommand: {
@@ -1106,6 +1096,8 @@ export interface components {
             type: "company" | "department" | "team";
             /** Format: uuid */
             parentId?: string;
+            /** Format: uuid */
+            managerId?: string | null;
             roleIds?: string[];
             isActive?: boolean;
         };
@@ -1122,6 +1114,11 @@ export interface components {
             permissionIds?: string[];
             isActive?: boolean;
         };
+        /**
+         * @description 0 = sucesso, 1 = erro, 2 = abortada
+         * @enum {number}
+         */
+        RequestOutcome: 0 | 1 | 2;
         AuditUserRefResponse: {
             /** Format: uuid */
             id: string;
@@ -1129,58 +1126,43 @@ export interface components {
             /** @example admin@admin.com */
             email: string;
         };
+        /**
+         * @description 0 = validação, 1 = autenticação, 2 = não encontrado, 3 = limite, 4 = banco, 5 = integração, 6 = interno
+         * @enum {number}
+         */
+        ErrorType: 0 | 1 | 2 | 3 | 4 | 5 | 6;
         RequestLogResponse: {
             /** Format: uuid */
             id: string;
-            /** @example GET /api/v1/users */
-            action: string;
-            /** @example User */
-            entity?: string | null;
-            entityId?: string | null;
-            /** @example GET */
+            /**
+             * @description 0 = sucesso, 1 = erro, 2 = abortada
+             * @example 0
+             */
+            outcome: components["schemas"]["RequestOutcome"];
+            /** @example Login */
+            action?: string | null;
+            /** @example POST */
             method?: string | null;
+            /** @example /api/v1/users/9f3c… */
             path?: string | null;
+            /** @example /users/:id */
+            route?: string | null;
             /** @example 200 */
             statusCode?: number | null;
             /** @example 42 */
             durationMs?: number | null;
-            /** @example 10.0.0.1 */
-            ipAddress?: string | null;
-            /** Format: uuid */
-            requestId?: string | null;
-            metadata?: Record<string, never> | null;
             userId?: string | null;
             user?: components["schemas"]["AuditUserRefResponse"] | null;
-            /** Format: date-time */
-            createdAt: string;
-            /** Format: date-time */
-            updatedAt: string;
-            /** Format: date-time */
-            deletedAt?: string | null;
-        };
-        PaginatedRequestLogsResponse: {
-            items: components["schemas"]["RequestLogResponse"][];
-            meta: components["schemas"]["PaginationMetaResponse"];
-        };
-        /** @enum {string} */
-        ErrorType: "VALIDATION" | "AUTH" | "NOT_FOUND" | "RATE_LIMIT" | "DATABASE" | "INTEGRATION" | "INTERNAL";
-        ErrorLogResponse: {
-            /** Format: uuid */
-            id: string;
-            type: components["schemas"]["ErrorType"];
-            /** @example 500 */
-            statusCode?: number | null;
-            message: string;
-            stack?: string | null;
-            /** @example POST */
-            method?: string | null;
-            path?: string | null;
-            /** @example 10.0.0.1 */
-            ipAddress?: string | null;
+            /** @description HMAC do IP — não é reversível ao endereço original */
+            ipHash?: string | null;
+            userAgent?: string | null;
             /** Format: uuid */
             requestId?: string | null;
-            userId?: string | null;
-            user?: components["schemas"]["AuditUserRefResponse"] | null;
+            /** @description 0 = validação, 1 = autenticação, 2 = não encontrado, 3 = limite, 4 = banco, 5 = integração, 6 = interno */
+            errorType?: components["schemas"]["ErrorType"] | null;
+            errorCode?: string | null;
+            errorMessage?: string | null;
+            errorStack?: string | null;
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
@@ -1188,12 +1170,12 @@ export interface components {
             /** Format: date-time */
             deletedAt?: string | null;
         };
-        PaginatedErrorLogsResponse: {
-            items: components["schemas"]["ErrorLogResponse"][];
+        PaginatedRequestLogsResponse: {
+            items: components["schemas"]["RequestLogResponse"][];
             meta: components["schemas"]["PaginationMetaResponse"];
         };
-        /** @enum {string} */
-        AuditDataAction: "CREATE" | "UPDATE" | "DELETE";
+        /** @enum {number} */
+        AuditDataAction: 0 | 1 | 2;
         AuditDataChangeResponse: {
             /** Format: uuid */
             id: string;
@@ -1218,8 +1200,8 @@ export interface components {
             items: components["schemas"]["AuditDataChangeResponse"][];
             meta: components["schemas"]["PaginationMetaResponse"];
         };
-        /** @enum {string} */
-        NotificationType: "INFO" | "SUCCESS" | "WARNING" | "ERROR";
+        /** @enum {number} */
+        NotificationType: 0 | 1 | 2 | 3;
         UserNotificationResponse: {
             /** Format: uuid */
             id: string;
@@ -1245,8 +1227,8 @@ export interface components {
             /** @example 3 */
             unread: number;
         };
-        /** @enum {string} */
-        ScopeType: "USER" | "ROLE" | "ALL";
+        /** @enum {number} */
+        ScopeType: 0 | 1 | 2;
         NotificationTargetCommand: {
             type: components["schemas"]["ScopeType"];
             /** @description Id do usuário quando type=USER, nome do papel quando type=ROLE. Ignorado em ALL. */
@@ -2231,6 +2213,25 @@ export interface operations {
             };
         };
     };
+    RbacController_managedGroups: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GroupResponse"][];
+                };
+            };
+        };
+    };
     RbacController_group: {
         parameters: {
             query?: never;
@@ -2487,7 +2488,7 @@ export interface operations {
             };
         };
     };
-    AuditController_changes: {
+    AuditController_requests: {
         parameters: {
             query?: {
                 page?: number;
@@ -2515,54 +2516,7 @@ export interface operations {
             };
         };
     };
-    AuditController_changesFilterSchema: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["FilterFieldResponse"][];
-                };
-            };
-        };
-    };
-    AuditController_errors: {
-        parameters: {
-            query?: {
-                page?: number;
-                limit?: number;
-                search?: string;
-                /** @description Coluna para ordenar (whitelist por endpoint) */
-                sortBy?: string;
-                sortDir?: "ASC" | "DESC";
-                /** @description JSON, ex.: {"name":{"$SUBSTRING":"ana"}} */
-                filter?: string;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["PaginatedErrorLogsResponse"];
-                };
-            };
-        };
-    };
-    AuditController_errorsFilterSchema: {
+    AuditController_requestsFilterSchema: {
         parameters: {
             query?: never;
             header?: never;

package/src/_services/auth/index.ts

@@ -6,6 +6,8 @@ export type LoginStatus = "SETUP_REQUIRED" | "TOTP_REQUIRED";
 export interface LoginResponse {
   status: LoginStatus;
   pendingToken: string;
+  /** Segundos até a etapa do código vencer — alimenta o contador da tela. */
+  expiresInSeconds: number;
 }
 
 export interface TotpSetup {

package/src/_utils/filter.ts

@@ -1,5 +1,5 @@
 import type { components } from "#core/_services/api/schema";
-import { formatDay, fromIsoDay, toIsoDay } from "#core/_utils/calendar";
+import { fromIsoDay, toIsoDay } from "#core/_utils/calendar";
 
 /**
  * Tipos derivados do `openapi.json` (§5): o catálogo é servido pelo backend,
@@ -63,8 +63,20 @@ export const hasValue = (draft: FilterDraftValue | undefined): boolean => {
   );
 };
 
-export const activeFilterCount = (values: FilterValues): number =>
-  Object.values(values).filter(hasValue).length;
+/**
+ * Quantos filtros o botão "Filtros" anuncia.
+ *
+ * `ignore` são os campos que a barra da listagem controla: eles filtram de
+ * verdade, mas o contador não pode cobrá-los, senão a tela abre marcando 1 num
+ * painel onde não há nada marcado.
+ */
+export const activeFilterCount = (
+  values: FilterValues,
+  ignore: string[] = [],
+): number =>
+  Object.entries(values).filter(
+    ([field, draft]) => hasValue(draft) && !ignore.includes(field),
+  ).length;
 
 /**
  * Ponta de um intervalo de datas em ISO **com o fuso de quem filtrou**.
@@ -280,34 +292,3 @@ const draftFrom = (
     }
   }
 };
-
-/** Resumo de um filtro ativo, para o chip. */
-export const describeValue = (
-  field: FilterField,
-  draft: FilterDraftValue,
-  labels: { from: string; to: string; yes: string; no: string; locale: string },
-): string => {
-  const show = (value: string): string =>
-    field.type === "DATE" || field.type === "DATETIME"
-      ? formatDay(value, labels.locale)
-      : value;
-
-  if (field.type === "BOOLEAN") {
-    return draft.value === "true" ? labels.yes : labels.no;
-  }
-  if (draft.values?.length) {
-    const optionLabel = (value: string): string =>
-      field.options?.find((option) => option.value === value)?.label ?? value;
-    return draft.values.map(optionLabel).join(", ");
-  }
-  if (draft.from && draft.to) {
-    return `${show(draft.from)} – ${show(draft.to)}`;
-  }
-  if (draft.from) {
-    return `${labels.from} ${show(draft.from)}`;
-  }
-  if (draft.to) {
-    return `${labels.to} ${show(draft.to)}`;
-  }
-  return draft.value ?? "";
-};

package/src/_utils/password.ts

@@ -5,3 +5,43 @@
  */
 export const STRONG_PASSWORD_REGEX =
   /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[!@#$%^&*(),.?":{}|<>]).{8,}$/;
+
+/** Tamanho mínimo — o mesmo `{8,}` do regex acima, nomeado. */
+export const PASSWORD_MIN_LENGTH = 8;
+
+export interface PasswordRule {
+  /** Chave de i18n do texto da regra (`validation.rules.*`). */
+  key: string;
+  /** Parâmetros da tradução, quando o texto tem número. */
+  params?: Record<string, string | number>;
+  test: (value: string) => boolean;
+}
+
+/**
+ * As exigências do regex, uma a uma.
+ *
+ * O regex sozinho só sabe dizer "não passou", e uma senha recusada sem dizer o
+ * que falta obriga a pessoa a adivinhar. Aqui cada condição responde por si, e
+ * a tela mostra quais já foram cumpridas enquanto se digita.
+ *
+ * A lista é derivada do mesmo regex e existe **só para explicar**: quem valida
+ * de fato continua sendo `STRONG_PASSWORD_REGEX`, e o backend por último.
+ */
+export const PASSWORD_RULES: PasswordRule[] = [
+  {
+    key: "validation.rules.minLength",
+    params: { count: PASSWORD_MIN_LENGTH },
+    test: (value) => value.length >= PASSWORD_MIN_LENGTH,
+  },
+  { key: "validation.rules.lowercase", test: (value) => /[a-z]/.test(value) },
+  { key: "validation.rules.uppercase", test: (value) => /[A-Z]/.test(value) },
+  { key: "validation.rules.digit", test: (value) => /\d/.test(value) },
+  {
+    key: "validation.rules.special",
+    test: (value) => /[!@#$%^&*(),.?":{}|<>]/.test(value),
+  },
+];
+
+/** Quantas regras a senha já cumpre — base do medidor de força. */
+export const passwordScore = (value: string): number =>
+  PASSWORD_RULES.filter((rule) => rule.test(value)).length;

package/src/_utils/permission.ts

@@ -0,0 +1,14 @@
+/**
+ * Os dois códigos que autorizam a mesma ação em alcances diferentes.
+ *
+ * `anyOrTeam("users:update")` → `["users:update:any", "users:update:team"]`.
+ *
+ * Espelha o helper de mesmo nome do backend (`core/auth/permissionScope.util`),
+ * como os enums do §7: são dois pacotes publicados separadamente, e o front não
+ * importa do outro. O que não pode divergir é o texto dos sufixos — e é
+ * justamente por isso que ele fica escrito num lugar só de cada lado.
+ */
+export const anyOrTeam = (action: string): [string, string] => [
+  `${action}:any`,
+  `${action}:team`,
+];

package/src/_utils/storage.ts

@@ -0,0 +1,64 @@
+/**
+ * Acesso ao `localStorage` que nunca derruba a tela.
+ *
+ * Ler `localStorage` **lança** — não devolve `null` — quando o navegador está
+ * com dados de site bloqueados: Chrome em "bloquear todos os cookies", Safari
+ * com prevenção de rastreamento em contexto de terceiros, políticas
+ * corporativas. Como quem lê são providers da raiz e o shell, um erro ali não
+ * degradava um pedaço da interface: derrubava a aplicação inteira, com tela
+ * branca no login e nenhuma pista para o usuário.
+ *
+ * O script anti-flash do `layout.tsx` já se protegia assim; aqui isso deixa de
+ * ser cuidado de um lugar só e vira a única porta de acesso.
+ *
+ * O que está guardado aqui é conveniência — tema, idioma, menu recolhido,
+ * colunas escondidas. Não poder ler significa cair no padrão, nunca falhar.
+ *
+ * Também cobre o servidor: no primeiro render do Next não existe `window`.
+ */
+const memory = new Map<string, string>();
+
+/**
+ * Espelho em memória para quando o navegador recusa o armazenamento.
+ *
+ * Sem ele, trocar o tema com cookies bloqueados não teria efeito nenhum dentro
+ * da própria sessão — a escrita se perdia e a leitura seguinte devolvia o valor
+ * antigo. Assim a preferência vale enquanto a aba está aberta; ela só não
+ * sobrevive ao recarregamento, que é o máximo possível nesse cenário.
+ */
+export const safeStorage = {
+  get(key: string): string | null {
+    try {
+      if (typeof window === "undefined") {
+        return null;
+      }
+      return window.localStorage.getItem(key);
+    } catch {
+      return memory.get(key) ?? null;
+    }
+  },
+
+  set(key: string, value: string): void {
+    try {
+      if (typeof window === "undefined") {
+        return;
+      }
+      window.localStorage.setItem(key, value);
+    } catch {
+      // Cota estourada ou armazenamento negado: guarda na sessão e segue.
+      memory.set(key, value);
+    }
+  },
+
+  remove(key: string): void {
+    try {
+      memory.delete(key);
+      if (typeof window === "undefined") {
+        return;
+      }
+      window.localStorage.removeItem(key);
+    } catch {
+      // Já saiu do espelho em memória; não há mais nada a fazer.
+    }
+  },
+};

package/src/_utils/user.ts

@@ -0,0 +1,19 @@
+/** Forma mínima que basta para rotular uma pessoa na interface. */
+export interface NamedUser {
+  name?: string | null;
+  lastName?: string | null;
+}
+
+/**
+ * Nome completo para exibição — espelha o getter `fullName` da entidade `User`
+ * do backend, inclusive no comportamento com sobrenome ausente.
+ *
+ * Existe para não haver três concatenações diferentes espalhadas pelas telas:
+ * quem mostra pessoa mostra o nome inteiro, e "Ana" e "Ana" deixam de ser a
+ * mesma linha numa lista de auditoria.
+ *
+ * Saudação é a exceção e continua usando só o primeiro nome — "Bem-vindo, Ana
+ * Paula de Souza" soa como carta de cobrança.
+ */
+export const fullName = (user?: NamedUser | null): string =>
+  [user?.name, user?.lastName].filter(Boolean).join(" ");