[PAV-133] Corrigir tipagem em autenticação e conexões

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.

[Jovinull]

Linear

Issue: PAV-133

Branch flow

• Este PR é um fix destinado a develop.
• Este PR não contém alteração direta ou fluxo indevido para master.
• A branch foi criada a partir da base prevista pelo fluxo do projeto.

Objetivo

Corrigir erros de TypeScript nos fluxos de boas-vindas e desconexão de provedores, preservando o comportamento das rotas e evitando coerções de tipo inseguras.

Escopo

O que faz parte desta entrega:

• Garantia de valores string no envio de e-mail de boas-vindas.
• Fallback de nome para perfil OAuth sem nome ou username.
• Uso dos valores validados no cadastro por credenciais.
• Validação de req.params.provider como valor escalar antes da lista de providers e da desconexão.
• Testes de regressão para os cenários corrigidos.

O que está fora do escopo:

• Alterar templates ou provider de e-mail.
• Alterar banco, migrations ou contratos HTTP.

Resumo das alterações

• O OAuth usa Usuário como fallback de nome quando os dois campos opcionais não existem.
• O cadastro usa o e-mail normalizado e o nome validado — ou o prefixo do e-mail — para o e-mail de boas-vindas.
• A rota de conexões recusa provider em formato não escalar antes de chamar o serviço.
• Adicionados testes de fallback de nome e provider inválido em array.

Como testar

npm exec --workspace=backend tsc -- --noEmit -p tsconfig.json
npm test --workspace=backend

Validation

• Checagem de tipos do backend executada sem erros.
• Testes relevantes executados.
• Suíte completa do backend executada: 60 arquivos e 572 testes aprovados.
• Validação manual não aplicável: a mudança é interna ao backend e está coberta por testes unitários e de rota.

Impacto de banco / migration

• Não altera schema nem migrations.

Impacto em contratos/API

• Não altera endpoint, payload, schema ou comportamento público de API.

Impacto de configuração / infraestrutura

• Não altera configuração, env, Docker, filas, cache, serviços ou infraestrutura.

Impacto de segurança

• Sem impacto relevante.

Impacto de dados pessoais / privacidade

• Sem tratamento novo ou alteração de dados pessoais.

Compatibilidade / dependências

• Não depende de outra task/PR.

Riscos

Baixo. O fallback impede que dados nulos cheguem ao template de e-mail, e a nova validação apenas rejeita formatos que a rota não suporta.

Rollback

Reverter este commit restaura o comportamento anterior sem migração nem alteração de dados.

Checklist final

• Escopo limitado ao card.
• Não inclui segredos, .env, certificados ou tokens.
• Não inclui arquivos temporários, builds, caches ou artefatos desnecessários.
• Não executa deploy como efeito desta PR.
• Critérios de aceite do card foram conferidos individualmente.