@hed-hog/core 0.0.390 → 0.0.393

package/hedhog/frontend/messages/pt.json

@@ -75,6 +75,7 @@
     "tab2fa": "2FA",
     "tabAccounts": "Contas",
     "tabSessions": "Sessões",
+    "tabDevices": "Dispositivos",
     "tabMcpTokens": "Tokens MCP",
     "tabTokens": "Tokens",
     "breadcrumbLabel": "Conta",
@@ -255,6 +256,7 @@
     "tabIdentifiers": "Identificadores",
     "tabMfa": "MFA",
     "tabSessions": "Sessões",
+    "tabDevices": "Dispositivos",
     "tabEmails": "E-mails",
     "tabLogs": "Logs",
     "cardLastLoginDescription": "Último login",
@@ -384,7 +386,8 @@
     "passwordResetPending": "Reset pendente",
     "passwordResetNone": "Em dia",
     "neverLoggedIn": "Nunca acessou",
-    "filterOptionPasswordReset": "Reset de senha pendente"
+    "filterOptionPasswordReset": "Reset de senha pendente",
+    "activityByActor": "por {name}"
   },
   "RolePage": {
     "title": "Gerenciamento de Cargos",
@@ -584,12 +587,14 @@
     "variablesHelp": "Use '{{variavel}}' no corpo do e-mail",
     "bodyLabel": "Corpo HTML",
     "localeLabel": "Idioma",
+    "sectionIdentification": "Identificação",
     "preview": "Preview",
     "availableVariables": "Variáveis disponíveis:",
     "testValuePlaceholder": "Valor de teste",
     "downloadYAML": "Baixar YAML",
     "generateMigration": "Gerar Migration",
     "sendTestEmail": "Enviar e-mail de teste",
+    "moreActions": "Mais ações",
     "cancel": "Cancelar",
     "saveChanges": "Salvar Alterações",
     "createTemplate": "Criar Template",
@@ -719,7 +724,11 @@
     "logout": "Realizou logout",
     "resetPassword": "Redefiniu a senha",
     "revokeAllSessions": "Revogou todas as sessões",
-    "revokeSession": "Revogou uma sessão"
+    "revokeSession": "Revogou uma sessão",
+    "impersonationStarted": "Acesso simulado por um operador",
+    "impersonationEnded": "Simulação de acesso encerrada",
+    "impersonationPerformed": "Simulou o acesso de outro usuário",
+    "impersonationPerformedEnded": "Encerrou a simulação de acesso"
   },
   "LoginPage": {
     "title": "Autenticação",
@@ -770,6 +779,16 @@
     "submitButton": "Redefinir senha",
     "submitButtonLoading": "Redefinindo..."
   },
+  "ConfirmEmailPage": {
+    "title": "Confirmação de e-mail",
+    "checking": "Só um instante enquanto validamos o link...",
+    "invalidTitle": "Link inválido",
+    "invalidDescription": "Este link de confirmação é inválido ou já expirou. Sua conta continua ativa: basta entrar normalmente.",
+    "successTitle": "E-mail confirmado",
+    "successDescription": "Pronto! Seu endereço de e-mail foi confirmado.",
+    "alreadyConfirmedDescription": "Seu e-mail já estava confirmado. Não é preciso fazer mais nada.",
+    "goToLogin": "Ir para o login"
+  },
   "ForgotPage": {
     "title": "Esqueci minha Senha",
     "emailLabel": "E-mail",
@@ -1027,7 +1046,8 @@
     "revokeSuccess": "Sessão revogada com sucesso!",
     "revokeFailure": "Falha ao revogar a sessão",
     "revokeAllSuccess": "Sessões revogadas com sucesso!",
-    "revokeAllFailure": "Falha ao revogar sessões"
+    "revokeAllFailure": "Falha ao revogar sessões",
+    "simulatedBy": "Simulado por {name}"
   },
   "UserMails": {
     "title": "E-mails enviados",
@@ -1069,7 +1089,10 @@
     "role_removed": "Papel removido",
     "avatar_changed": "Avatar alterado",
     "emptyTitle": "Nenhuma alteração registrada",
-    "emptyDescription": "As alterações administrativas feitas neste usuário aparecerão aqui."
+    "emptyDescription": "As alterações administrativas feitas neste usuário aparecerão aqui.",
+    "impersonation_requested": "Simulação de acesso solicitada",
+    "impersonation_started": "Simulação de acesso iniciada",
+    "impersonation_ended": "Simulação de acesso encerrada"
   },
   "UserActiveSessions": {
     "title": "Sessões Ativas",
@@ -1086,7 +1109,9 @@
     "revokeSuccess": "Sessão revogada com sucesso!",
     "revokeFailure": "Falha ao revogar sessão",
     "revokeAllSuccess": "Sessões revogadas com sucesso!",
-    "revokeAllFailure": "Falha ao revogar sessões"
+    "revokeAllFailure": "Falha ao revogar sessões",
+    "simulatedSession": "Acesso simulado",
+    "simulatedBy": "Simulado por {name}"
   },
   "UserIdentifiers": {
     "title": "Identificadores do Usuário",
@@ -1290,6 +1315,7 @@
     "to": "Para",
     "cc": "CC",
     "bcc": "CCO",
+    "providerMessageId": "ID da mensagem no provedor",
     "body": "Corpo",
     "createdAt": "Criado em",
     "updatedAt": "Atualizado em",
@@ -1309,6 +1335,20 @@
     "statusRead": "Lido",
     "statusError": "Erro",
     "statusUnavailable": "Sem status",
+    "filterByDelivery": "Entrega",
+    "deliveryAll": "Qualquer desfecho",
+    "deliveryPending": "Sem resposta ainda",
+    "deliveryPendingHint": "O provedor aceitou a mensagem e ainda não informou o desfecho.",
+    "deliveryDelivered": "Entregue",
+    "deliveryBounced": "Devolvido",
+    "deliveryComplained": "Marcado como spam",
+    "deliveryRejected": "Recusado",
+    "undeliveredCurrentPage": "Não entregues (página)",
+    "undeliveredHint": "Aceitos pelo provedor e devolvidos depois",
+    "providerEvents": "Eventos de entrega do provedor",
+    "noProviderEvents": "O provedor ainda não informou nada sobre esta mensagem.",
+    "allRecipients": "Todos os destinatários",
+    "reportingMta": "Reportado por",
     "statusReceivedShort": "Recebidos: {count}",
     "statusReadShort": "Lidos: {count}",
     "statusErrorShort": "Erros: {count}",
@@ -1360,7 +1400,7 @@
     "fileUploaded": "Arquivo enviado com sucesso.",
     "fileUploadFailed": "Falha ao enviar arquivo.",
     "fileIdNotReturned": "ID do arquivo não retornado.",
-    "temporaryOpenUrlNotReturned": "URL temporária de abertura não retornada.",
+    "apiBaseUrlNotConfigured": "A URL base da API não está configurada.",
     "uploadedFileAlt": "Arquivo enviado",
     "fileUrlPlaceholder": "URL do arquivo",
     "durationUnitSeconds": "Segundos",
@@ -1384,44 +1424,21 @@
     "oauthProfileEmptyState": "Nenhum perfil OAuth encontrado.",
     "selectPaymentProfile": "Selecione um perfil de pagamento",
     "paymentProfileEmptyState": "Nenhum perfil de pagamento encontrado.",
-    "mailProfile": {
-      "nameLabel": "Nome *",
-      "namePlaceholder": "Meu Perfil de Email",
-      "fromEmailLabel": "Email de envio *",
-      "fromEmailPlaceholder": "nao-responda@exemplo.com",
-      "fromNameLabel": "Nome do remetente",
-      "fromNamePlaceholder": "Equipe Comercial",
-      "providerLabel": "Provedor *",
-      "providers": {
-        "ses": "Amazon SES"
-      },
-      "smtpHostLabel": "Host SMTP *",
-      "smtpHostPlaceholder": "smtp.exemplo.com",
-      "smtpPortLabel": "Porta SMTP *",
-      "smtpPortPlaceholder": "587",
-      "smtpUsernameLabel": "Usuário SMTP *",
-      "smtpUsernamePlaceholder": "usuario@exemplo.com",
-      "smtpPasswordLabel": "Senha SMTP *",
-      "replyToEmailLabel": "E-mail do reply-to",
-      "replyToEmailPlaceholder": "suporte@empresa.com",
-      "clientIdLabel": "Client ID *",
-      "clientSecretLabel": "Client Secret *",
-      "refreshTokenLabel": "Refresh Token *",
-      "accessKeyIdLabel": "Access Key ID *",
-      "secretAccessKeyLabel": "Secret Access Key *",
-      "regionLabel": "Região *",
-      "regionPlaceholder": "us-east-1"
-    },
-    "whatsappProfile": {
-      "nameLabel": "Nome *",
-      "namePlaceholder": "Meu Perfil de WhatsApp",
-      "providerLabel": "Provedor *",
-      "hostLabel": "Host da API *",
-      "hostPlaceholder": "https://api.exemplo.com",
-      "instanceNameLabel": "Nome da instância *",
-      "instanceNamePlaceholder": "MinhaInstancia",
-      "tokenLabel": "Token *",
-      "tokenPlaceholder": "Token de autenticação"
+    "whatsappProfileEmptyState": "Nenhum perfil de WhatsApp encontrado.",
+    "selectIntegrationProfile": "Selecione um perfil de integração",
+    "integrationProfileEmptyState": "Nenhum perfil de integração encontrado.",
+    "editProfileAria": "Editar {profile}",
+    "createProfileAria": "Criar {profile}",
+    "profileTypeNames": {
+      "ai": "perfil de IA",
+      "email": "perfil de e-mail",
+      "whatsapp": "perfil de WhatsApp",
+      "storage": "perfil de armazenamento",
+      "oauth": "perfil OAuth",
+      "payment": "perfil de pagamento",
+      "infrastructure": "perfil de infraestrutura",
+      "kubernetes": "perfil Kubernetes",
+      "generic": "perfil de integração"
     },
     "selectInfraProfile": "Selecione o perfil de infraestrutura",
     "infraProfileEmptyState": "Nenhum perfil de infraestrutura encontrado. Crie um perfil DigitalOcean ou Kubernetes primeiro.",
@@ -1816,7 +1833,13 @@
     "decreaseZoom": "Diminuir zoom",
     "resetZoom": "Resetar zoom",
     "increaseZoom": "Aumentar zoom",
-    "saveAndClose": "Salvar e Fechar"
+    "saveAndClose": "Salvar e Fechar",
+    "aiEdit": "Editar com IA",
+    "aiEditPromptLabel": "O que você quer mudar?",
+    "aiEditPromptPlaceholder": "Ex.: deixe o texto mais formal e adicione uma lista com os próximos passos",
+    "aiEditSubmit": "Gerar",
+    "aiEditSuccess": "Conteúdo atualizado pela IA",
+    "aiEditError": "Não foi possível atualizar o conteúdo com IA"
   },
   "DashboardManagement": {
     "title": "Gerenciamento de Dashboards",
@@ -2458,7 +2481,14 @@
     "detailsDescription": "Detalhes completos desta entrada de log de acesso",
     "os": "Sistema Operacional",
     "location": "Localização",
-    "rawUserAgent": "User Agent"
+    "rawUserAgent": "User Agent",
+    "simulated": "Simulado",
+    "simulatedBy": "Simulado por {name}",
+    "simulatedAccess": "Acesso simulado",
+    "filterBySimulated": "Simulação",
+    "simulatedAll": "Todos os acessos",
+    "simulatedOnly": "Somente simulados",
+    "simulatedExclude": "Excluir simulados"
   },
   "IntegrationProfilePage": {
     "breadcrumbHome": "Início",
@@ -2564,6 +2594,7 @@
     "fieldFromName": "Nome de Envio",
     "fieldReplyTo": "E-mail de Resposta",
     "fieldReplyToName": "Nome de Resposta",
+    "fieldSnsTopicArn": "ARN do Tópico SNS (rastreio de entrega)",
     "fieldClientId": "Client ID",
     "fieldClientSecret": "Client Secret",
     "fieldRefreshToken": "Refresh Token",
@@ -2571,6 +2602,7 @@
     "fieldSecretAccessKey": "Secret Access Key",
     "fieldRegion": "Região",
     "fieldDomain": "Domínio",
+    "fieldImapSecure": "TLS direto (porta 993)",
     "fieldToken": "Token",
     "fieldInstanceName": "Nome da Instância",
     "fieldPhoneNumberId": "ID do Número de Telefone",
@@ -2584,6 +2616,13 @@
     "fieldEnvironmentTest": "Teste",
     "fieldEnvironmentProduction": "Produção",
     "copiedToClipboard": "Copiado para a área de transferência",
+    "sesWebhookSectionTitle": "Rastreio de entrega (SNS)",
+    "sesWebhookDescription": "Sem esta assinatura o Hub só sabe que o provedor aceitou a mensagem, não se ela foi entregue.",
+    "sesWebhookEndpointLabel": "URL do endpoint",
+    "sesWebhookStep1": "Crie um tópico SNS na mesma região deste perfil do SES.",
+    "sesWebhookStep2": "Adicione uma assinatura HTTPS no tópico com a URL acima. Ela é confirmada automaticamente.",
+    "sesWebhookStep3": "No SES, abra a identidade de envio e aponte as notificações de Bounce, Complaint e Delivery para esse tópico.",
+    "sesWebhookStep4": "Cole o ARN do tópico no campo acima para que eventos de outros tópicos sejam recusados.",
     "whatsappWebhookSectionTitle": "Webhook da Meta",
     "whatsappWebhookDescription": "Registre este webhook no seu app da Meta para receber mensagens do WhatsApp.",
     "whatsappWebhookCallbackUrlLabel": "URL de Callback",
@@ -2729,7 +2768,9 @@
     "fieldTimeoutMs": "Timeout (ms)",
     "fieldMaxRetries": "Máximo de tentativas",
     "fileStored": "Arquivo armazenado e cifrado. Clique para substituir.",
-    "fileSelected": "Novo arquivo selecionado. Será cifrado ao salvar."
+    "fileSelected": "Novo arquivo selecionado. Será cifrado ao salvar.",
+    "fieldRtdnServiceAccount": "Conta de Serviço das Notificações (RTDN)",
+    "fieldRtdnAudience": "Audience das Notificações (RTDN)"
   },
   "SystemPagesPage": {
     "title": "Páginas",
@@ -3063,7 +3104,18 @@
     "previewTitle": "Pré-visualização do HTML",
     "noContent": "Sem conteúdo para visualizar",
     "complexHtmlWarningTitle": "HTML complexo detectado",
-    "complexHtmlWarningDesc": "Este conteúdo tem tags style, head ou script que o editor visual remove. Use a aba HTML para editá-lo."
+    "complexHtmlWarningDesc": "Este conteúdo tem tags style, head ou script que o editor visual remove. Use a aba HTML para editá-lo.",
+    "aiEditTitle": "Ajustar HTML com IA",
+    "aiInstructionPlaceholder": "Descreva o ajuste que a IA deve fazer neste HTML.",
+    "aiApplyButton": "Ajustar com IA",
+    "aiApplying": "Ajustando...",
+    "aiEditAppliedDefault": "HTML ajustado pela IA. Revise antes de salvar.",
+    "aiEditErrorDefault": "Não foi possível ajustar o HTML com IA.",
+    "enterFullscreen": "Tela cheia",
+    "exitFullscreen": "Sair da tela cheia",
+    "enterSplitView": "Ver painéis lado a lado",
+    "exitSplitView": "Ver em abas",
+    "splitViewLabel": "Preview, HTML e IA lado a lado"
   },
   "MailLayoutPage": {
     "breadcrumbHome": "Início",
@@ -3087,5 +3139,51 @@
     "saveSuccess": "Layout base salvo",
     "saveError": "Falha ao salvar o layout base",
     "missingContentTokenError": "O wrapper precisa conter o token {{{content}}}, senão todos os e-mails seriam enviados vazios."
+  },
+  "KnownDevices": {
+    "title": "Dispositivos Conhecidos",
+    "description": "Aparelhos que sua conta já reconhece. Um acesso vindo de um dispositivo fora desta lista dispara um alerta por e-mail.",
+    "adminDescription": "Aparelhos que a conta deste usuário já reconhece.",
+    "device": "Dispositivo",
+    "browser": "Navegador",
+    "lastIp": "Último IP",
+    "lastSeen": "Último acesso",
+    "firstSeen": "Reconhecido em",
+    "action": "Ação",
+    "unknown": "Desconhecido",
+    "forget": "Esquecer",
+    "noDevices": "Nenhum dispositivo reconhecido ainda",
+    "forgetTitle": "Esquecer dispositivo",
+    "forgetDescription": "O próximo acesso vindo deste dispositivo será tratado como desconhecido e disparará um alerta por e-mail. As sessões abertas nele continuam válidas — para encerrá-las, revogue as sessões.",
+    "cancel": "Cancelar",
+    "forgetSuccess": "Dispositivo esquecido",
+    "forgetFailure": "Não foi possível esquecer o dispositivo",
+    "simulatedNotRecorded": "Acessos simulados não são registrados como dispositivo — veja a aba de sessões."
+  },
+  "AccessSimulation": {
+    "action": "Simular acesso",
+    "dialogTitle": "Simular acesso",
+    "dialogDescription": "Abre uma sessão curta e auditada vendo o sistema como {name}. Tudo o que você fizer fica registrado no nome dessa pessoa e no seu.",
+    "targetApp": "Aplicação de destino",
+    "targetAppPlaceholder": "Escolha onde abrir a sessão",
+    "noAppsConfigured": "Nenhuma aplicação tem URL configurada na setting app-urls.",
+    "reason": "Motivo (opcional)",
+    "reasonPlaceholder": "Chamado, solicitação ou contexto desta simulação",
+    "auditWarning": "A simulação fica registrada nas sessões, no log de acesso e na linha do tempo de atividade dos dois usuários. Dura 30 minutos e não pode ser renovada.",
+    "confirm": "Iniciar simulação",
+    "cancel": "Cancelar",
+    "opening": "Abrindo…",
+    "startFailure": "Não foi possível iniciar a simulação de acesso.",
+    "bannerViewingAs": "ACESSO SIMULADO — você está vendo o sistema como",
+    "bannerOperator": "Operador",
+    "bannerExpiresIn": "expira em",
+    "bannerStop": "Encerrar simulação",
+    "bannerStopping": "Encerrando…",
+    "redeemLoading": "Iniciando a simulação de acesso…",
+    "redeemInvalidTitle": "Este link de simulação não vale mais",
+    "redeemInvalidDescription": "O link funciona uma única vez e expira em um minuto. Peça ao operador para iniciar uma nova simulação.",
+    "redeemMissingCode": "Nenhum código de simulação foi encontrado no link.",
+    "noAdminAccessTitle": "Este usuário não tem acesso ao painel",
+    "noAdminAccessDescription": "{name} não tem papel administrativo, então não há o que mostrar aqui. Simule esse acesso na aplicação que a pessoa realmente usa."
   }
 }

package/hedhog/table/access_log.yaml

@@ -25,7 +25,14 @@ columns:
   - name: mcp_prompt
     type: text
     isNullable: true
+  # Operador por tras de um acesso simulado. INT puro, SEM FK: uma segunda FK
+  # para `user` renomearia a relacao `user.access_log` no prisma db pull e
+  # quebraria AccessLogService.list. O nome sai de uma segunda consulta.
+  - name: impersonator_user_id
+    type: int
+    isNullable: true
   - type: created_at
 indexes:
   - fields: [user_id]
   - fields: [created_at]
+  - fields: [impersonator_user_id]

package/hedhog/table/file.yaml

@@ -19,5 +19,13 @@ columns:
     type: int
     unsigned: true
     default: 0
+  # Tira o arquivo das duas rotas que servem por id sem autenticacao
+  # (GET /file/open/:id e GET /file/image/:id). O caminho autenticado
+  # PUT /file/open/:id -> token -> GET /file/open/:token continua valendo, e e
+  # por ele que o admin exibe anexo sensivel. Existe porque id de arquivo e
+  # sequencial: sem isso, um formulario de vaga com curriculos e enumeravel.
+  - name: is_private
+    type: boolean
+    default: false
   - type: created_at
   - type: updated_at

package/hedhog/table/mail_delivery_event.yaml

@@ -0,0 +1,76 @@
+# Evento de entrega devolvido pelo provedor de e-mail (SES via SNS, por ora).
+#
+# Motivo: ate aqui "enviado" significava apenas "o provedor aceitou". O chamado
+# 202608-000020 teve tres mensagens aceitas pelo SES, cada uma com MessageId de
+# sucesso, e nenhuma chegou a caixa alguma - sem esta tabela nao havia como
+# saber disso, nem por que. O `diagnostic_code` e a resposta literal do servidor
+# destinatario, que e o que responde "por que nao chegou".
+columns:
+  - type: pk
+  # Nullable de proposito: um evento pode chegar de um envio anterior a coluna
+  # provider_message_id existir, ou de um e-mail que saiu por fora do Hub.
+  # Descartar seria jogar fora justamente a evidencia de que algo escapou.
+  - type: fk
+    name: mail_sent_id
+    isNullable: true
+    references:
+      table: mail_sent
+      column: id
+      onDelete: set null
+      onUpdate: cascade
+  # Chave de juncao com mail_sent.provider_message_id.
+  - name: provider_message_id
+    type: varchar
+    length: 255
+  # O provedor reporta por destinatario: uma mensagem para tres pessoas pode
+  # ser entregue a duas e voltar da terceira.
+  - name: recipient_email
+    type: varchar
+    length: 255
+    isNullable: true
+  # varchar e nao enum: o SES ja tem sete tipos e acrescenta outros sem aviso,
+  # e um valor novo nao pode derrubar a ingestao do webhook.
+  - name: event_type
+    type: varchar
+    length: 32
+  - name: bounce_type
+    type: varchar
+    length: 64
+    isNullable: true
+  - name: bounce_subtype
+    type: varchar
+    length: 64
+    isNullable: true
+  - name: diagnostic_code
+    type: text
+    isNullable: true
+  - name: reporting_mta
+    type: varchar
+    length: 255
+    isNullable: true
+  # Notificacao crua, para o que o schema nao previu.
+  - name: payload
+    type: json
+    isNullable: true
+  # Horario do provedor, nao o nosso: o SNS reentrega e o nosso relogio diria
+  # quando processamos, nao quando aconteceu.
+  - name: occurred_at
+    type: timestamp
+  - type: created_at
+  - type: updated_at
+indices:
+  - columns:
+      - provider_message_id
+  - columns:
+      - mail_sent_id
+  - columns:
+      - event_type
+      - occurred_at
+  # O SNS reentrega quando a resposta demora; sem esta chave o mesmo bounce
+  # viraria uma linha nova a cada tentativa.
+  - columns:
+      - provider_message_id
+      - recipient_email
+      - event_type
+      - occurred_at
+    isUnique: true

package/hedhog/table/mail_sent.yaml

@@ -17,5 +17,28 @@ columns:
     isNullable: true
   - name: body
     type: text
+  # Id devolvido pelo provedor (MessageId do SES, messageId do nodemailer).
+  # Sem ele nao ha como cruzar um envio nosso com o evento de entrega/bounce
+  # do provedor - foi essa lacuna que deixou "enviado sem erro, nunca chegou"
+  # sem resposta possivel.
+  - name: provider_message_id
+    length: 255
+    isNullable: true
+  # Desfecho consolidado dos eventos de mail_delivery_event, para a listagem do
+  # log nao precisar agregar a tabela de eventos a cada linha.
+  # delivered | bounced | complained | rejected
+  - name: delivery_status
+    type: varchar
+    length: 32
+    isNullable: true
+  - name: delivery_updated_at
+    type: timestamp
+    isNullable: true
   - type: created_at
   - type: updated_at
+indices:
+  # Coluna de lookup do webhook de entrega: o provedor so conhece o MessageId.
+  - columns:
+      - provider_message_id
+  - columns:
+      - delivery_status

package/hedhog/table/user_activity.yaml

@@ -8,6 +8,15 @@ columns:
       onDelete: CASCADE
   - name: action
     type: text
+  # Quem provocou a atividade, quando nao foi o proprio usuario (hoje: simulacao
+  # de acesso). INT puro, SEM FK: uma segunda FK para `user` renomearia a relacao
+  # `user.user_activity` no prisma db pull e quebraria getUserIncludeClause.
+  - name: actor_user_id
+    type: int
+    isNullable: true
   - type: created_at
   - type: updated_at
 
+indices:
+  - columns: [actor_user_id]
+

package/hedhog/table/user_device.yaml

@@ -0,0 +1,52 @@
+# Dispositivos ja vistos por usuario, usada por AuthService para decidir se um
+# login vem de um dispositivo desconhecido (e-mail auth-login-new-device).
+#
+# Existe porque a checagem anterior olhava o historico de `user_session`, que
+# `clearExpiredSessions` poda por `session-retention-days`: um dispositivo parado
+# alguns meses sumia do historico e era reanunciado como novo.
+columns:
+  - type: pk
+  - name: user_id
+    type: fk
+    references:
+      table: user
+      column: id
+      onDelete: CASCADE
+      onUpdate: CASCADE
+  # sha256 hex de `b:<browser_id>` ou, na falta dele, `u:<user_agent>`.
+  # Ver buildDeviceKey em libraries/core/src/utils/device-key.ts.
+  - name: device_key
+    type: varchar
+    length: 64
+  # browser_id e user_agent ficam gravados crus so para diagnostico: quem decide
+  # a identidade e a device_key.
+  - name: browser_id
+    type: varchar
+    isNullable: true
+  - name: user_agent
+    type: text
+    isNullable: true
+  - name: browser_name
+    type: varchar
+    length: 64
+    isNullable: true
+  - name: os_name
+    type: varchar
+    length: 64
+    isNullable: true
+  - name: last_ip
+    type: varchar
+    length: 45
+    isNullable: true
+  - name: last_seen_at
+    type: timestamptz
+  - type: created_at
+  - type: updated_at
+
+indices:
+  # A unica que importa no caminho de login: "este usuario ja usou este
+  # dispositivo?". Unica porque o upsert do registro depende dela.
+  - columns: [user_id, device_key]
+    isUnique: true
+  # Para uma futura poda de dispositivos ha muito nao usados.
+  - columns: [last_seen_at]

package/hedhog/table/user_session.yaml

@@ -16,5 +16,24 @@ columns:
     isNullable: true
   - name: expires_at
     type: datetime
+  # Sessao aberta por outro usuario via simulacao de acesso. INT puro, SEM FK:
+  # esta tabela ja tem uma FK para `user`, e uma segunda faria o prisma db pull
+  # renomear `user.user_session` (foi o que aconteceu com user_change_log), o que
+  # quebraria UserService.findUserById e a tela de sessoes do admin. O nome do
+  # operador sai de uma segunda consulta.
+  - name: impersonator_user_id
+    type: int
+    isNullable: true
+  - name: impersonation_reason
+    type: varchar
+    length: 255
+    isNullable: true
   - type: created_at
-  - type: updated_at
+  - type: updated_at
+
+# A FK user_id nasceu sem indice, entao toda consulta por usuario (listagem de
+# sessoes, revogacao em massa) fazia seq scan. O prefixo user_id deste indice
+# composto ja cobre esses casos.
+indices:
+  - columns: [user_id, browser_id]
+  - columns: [impersonator_user_id]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hed-hog/core",
-  "version": "0.0.390",
+  "version": "0.0.393",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -39,18 +39,19 @@
     "qrcode": "^1.5.4",
     "redis": "4.7.1",
     "rxjs": "^7.8.2",
+    "@sentry/nestjs": "10.70.0",
     "socket.io": "^4.8.1",
     "sharp": "^0.34.2",
     "speakeasy": "^2.0.0",
     "ua-parser-js": "^2.0.10",
     "uuid": "^11.1.0",
     "@hed-hog/api-prisma": "0.0.6",
-    "@hed-hog/api-locale": "0.0.14",
+    "@hed-hog/api-mail": "0.0.10",
     "@hed-hog/vault-crypto": "0.0.1",
-    "@hed-hog/api": "0.0.8",
     "@hed-hog/api-types": "0.0.1",
-    "@hed-hog/api-mail": "0.0.9",
-    "@hed-hog/api-pagination": "0.0.7"
+    "@hed-hog/api-pagination": "0.0.7",
+    "@hed-hog/api-locale": "0.0.14",
+    "@hed-hog/api": "0.0.8"
   },
   "exports": {
     ".": {

package/src/access-log/access-log.controller.ts

@@ -24,6 +24,7 @@ export class AccessLogController {
       createdAtFrom: query.createdAtFrom,
       createdAtTo: query.createdAtTo,
       type: query.type,
+      simulated: query.simulated,
     });
   }
 }

package/src/access-log/access-log.interceptor.ts

@@ -26,6 +26,10 @@ export class AccessLogInterceptor implements NestInterceptor {
     return next.handle().pipe(
       tap(() => {
         const userId: number | undefined = request.auth?.sub;
+        // Numa simulacao de acesso o `sub` e o ALVO; sem gravar o operador, o
+        // log ficaria indistinguivel de um acesso genuino do usuario.
+        const impersonatorUserId: number | undefined =
+          request.auth?.imp === true ? request.auth?.act : undefined;
         // request.ip já resolve o IP real do cliente respeitando `trust proxy` (main.ts):
         // ler x-forwarded-for na mão aqui pegava o primeiro valor da lista, que é
         // exatamente o mais fácil de forjar pelo próprio cliente.
@@ -33,7 +37,7 @@ export class AccessLogInterceptor implements NestInterceptor {
         const userAgent: string = (request.headers['user-agent'] as string) ?? '';
         const method: string = request.method ?? '';
 
-        this.accessLogService.recordHttp({ userId, ip, userAgent, method, path });
+        this.accessLogService.recordHttp({ userId, ip, userAgent, method, path, impersonatorUserId });
       }),
     );
   }