feat(auth): implementar autenticação OAuth com Google e GitHub

* Implementado fluxo completo de autenticação OAuth para Google e GitHub
* Adicionado gerenciamento seguro de `state` utilizando `iron-session`
* Implementada validação de `state` no callback OAuth para proteção contra CSRF
* Corrigido fluxo do Google OAuth utilizando `openid-client`
* Adicionado suporte ao `authorizationCodeGrant` com callback URL dinâmica
* Implementado envio da URL completa de callback (`callbackUrl`) para providers OpenID
* Refatorada arquitetura dos providers OAuth para padronização de interfaces
* Criado tipo `ExchangeCodeParams` para desacoplamento entre controller/service/providers
* Removido uso de `any` dos providers OAuth
* Melhorada tipagem do fluxo de autenticação com Zod + TypeScript
* Adicionados logs detalhados para debug do fluxo OAuth
* Implementado suporte a múltiplos providers (`github`, `google`, `linkedin`)
* Ajustado fluxo de criação/busca de usuário autenticado
* Corrigidos problemas de incompatibilidade de tipos entre providers e AuthService
* Estruturado fluxo para futura expansão de login social multi-provider

Author: hltav

.cspell/custom-dictionary-workspace.txt

@@ -6,6 +6,7 @@ aceita
 acentos
 acesso
 achar
+acontece
 adicionais
 Adicionamos
 adzuna
@@ -40,7 +41,10 @@ atingido
 ativa
 ativas
 ativos
+atômica
+atômicas
 atuais
+atualização
 atualizadas
 aumentamos
 Aumentei
@@ -72,11 +76,13 @@ carregados
 carregamos
 cascadia
 casos
+Centraliza
 Certificados
 cespare
 chainalysis
 chainlink
 chamada
+Chamamos
 chave
 Chaves
 checamos
@@ -90,6 +96,7 @@ combinações
 commitar
 compartilhado
 completa
+complexa
 composta
 concluído
 concorrência
@@ -102,6 +109,7 @@ configurado
 configurados
 conflito
 conhecidas
+conjunto
 considere
 constrói
 contagem
@@ -145,6 +153,7 @@ devolvido
 diacríticos
 diferenciar
 diferentes
+dinamicamente
 direto
 disparado
 disponível
@@ -173,6 +182,7 @@ então
 envia
 enviado
 enviou
+envolver
 equivale
 equivalente
 ernstandyoung
@@ -189,6 +199,7 @@ esperada
 esperar
 estavam
 estilo
+estivesse
 Estranha
 estranho
 Estrutura
@@ -200,6 +211,7 @@ executar
 existem
 existente
 existirem
+expirado
 expirou
 explícito
 exporta
@@ -219,6 +231,7 @@ filtros
 Finaliza
 FINALIZADO
 fintech
+flexibilidade
 fluxo
 flyio
 fonte
@@ -228,6 +241,7 @@ formato
 fornecidas
 funciona
 funcionando
+futuro
 garantindo
 genérico
 goldmark
@@ -246,6 +260,7 @@ ignorado
 iguais
 implementa
 implementados
+Importando
 incompleto
 independente
 indisponivel
@@ -260,6 +275,7 @@ Inicializa
 inicializado
 Iniciando
 início
+injetar
 instacart
 Instancia
 inteligente
@@ -269,6 +285,7 @@ interrompe
 interrupção
 Intervalo
 Inválida
+invalidar
 isso
 jobsglobal
 jobsglobalscraper
@@ -295,10 +312,13 @@ Localização
 logar
 longo
 lote
+lugar
+mágica
 maior
 maioria
 maiúsculas
 mantém
+Mantemos
 manualmente
 Mapeando
 marca
@@ -311,6 +331,7 @@ mescladas
 mesma
 Mesmos
 metadados
+método
 MÉTRICA
 milissegundos
 mínimo
@@ -348,6 +369,7 @@ operações
 organização
 Origem
 origens
+orquestração
 otimizado
 outra
 pacote
@@ -361,15 +383,19 @@ paralelas
 paralelo
 parseia
 partir
+passos
 pegar
 pela
 pelos
 peloton
+pendentes
 permite
 permitida
+permitidos
 permitindo
 planetscale
 pôde
+poderia
 ponteiro
 populada
 populado
@@ -411,6 +437,7 @@ Quebrada
 quiser
 reais
 reaproveita
+recebe
 receber
 recente
 reconecta
@@ -453,6 +480,7 @@ sendo
 sensível
 separa
 separadas
+seria
 setar
 silencioso
 simplificado
@@ -482,6 +510,7 @@ tigra
 tipado
 titulo
 tiver
+transação
 trata
 tratamento
 travar
@@ -501,8 +530,12 @@ usam
 útil
 utilizando
 vaga
+validado
+Validamos
 validar
 validos
+valkey
+Valkey
 vamos
 várias
 variável

backend/bruno/GitHubAuthCallback.bru

@@ -0,0 +1,21 @@
+meta {
+  name: GitHubAuthCallback
+  type: http
+  seq: 4
+}
+
+get {
+  url: {{base_url}}/auth/github/callback?code=4%2F0AeoWuM-9o1BomIsJXolunjZ34_ezLHxLEgIKhI1-Pvh11jD4YHFPBvspBBu6P1WhwuSczA&state=q5iv69L89IMH6cuWAvUjAb5nnfpqYzSwBc1tyo0lZbo
+  body: none
+  auth: inherit
+}
+
+params:query {
+  code: 4%2F0AeoWuM-9o1BomIsJXolunjZ34_ezLHxLEgIKhI1-Pvh11jD4YHFPBvspBBu6P1WhwuSczA
+  state: q5iv69L89IMH6cuWAvUjAb5nnfpqYzSwBc1tyo0lZbo
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}

backend/bruno/GitHubAuthUrl.bru

@@ -0,0 +1,16 @@
+meta {
+  name: GitHubAuthUrl
+  type: http
+  seq: 5
+}
+
+get {
+  url: {{base_url}}/auth/github/url
+  body: none
+  auth: inherit
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}

backend/bruno/GoogleAuthCallback.bru

@@ -0,0 +1,21 @@
+meta {
+  name: GoogleAuthCallback
+  type: http
+  seq: 1
+}
+
+get {
+  url: {{base_url}}/auth/google/callback?code=4%2F0AeoWuM-9o1BomIsJXolunjZ34_ezLHxLEgIKhI1-Pvh11jD4YHFPBvspBBu6P1WhwuSczA&state=q5iv69L89IMH6cuWAvUjAb5nnfpqYzSwBc1tyo0lZbo
+  body: none
+  auth: inherit
+}
+
+params:query {
+  code: 4%2F0AeoWuM-9o1BomIsJXolunjZ34_ezLHxLEgIKhI1-Pvh11jD4YHFPBvspBBu6P1WhwuSczA
+  state: q5iv69L89IMH6cuWAvUjAb5nnfpqYzSwBc1tyo0lZbo
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}

backend/bruno/GoogleAuthUrl.bru

@@ -0,0 +1,16 @@
+meta {
+  name: GoogleAuthUrl
+  type: http
+  seq: 2
+}
+
+get {
+  url: {{base_url}}/auth/google/url
+  body: none
+  auth: inherit
+}
+
+settings {
+  encodeUrl: true
+  timeout: 0
+}

backend/bruno/bruno.json

@@ -0,0 +1,6 @@
+{
+  "name": "Jobs_Scraper_Global",
+  "version": "1",
+  "type": "collection",
+  "ignore": ["node_modules", ".git"]
+}

backend/bruno/environments/Local.bru

@@ -0,0 +1,3 @@
+vars {
+  base_url: http://localhost:3001/api
+}

backend/package.json

@@ -40,6 +40,7 @@
     "cors": "^2.8.6",
     "dotenv": "^17.3.1",
     "express": "^5.2.1",
+    "iron-session": "^8.0.4",
     "pdfkit": "^0.18.0",
     "redis": "^4.7.1",
     "swagger-jsdoc": "^6.2.8",

backend/src/jobsApiApp.ts

@@ -8,6 +8,7 @@ import {
 import { searchJobs, type ScrapeParams } from "./adapters/goScraper";
 import { getConfig } from "./config";
 import { logWarn } from "./logger";
+import { authRoutes } from "./modules/auth/auth.routes";
 
 interface JobsApiAppOptions {
   outputDir?: string;
@@ -60,6 +61,8 @@ export function createJobsApiApp(_options: JobsApiAppOptions = {}) {
   });
   app.use(cors(corsOptions));
 
+  app.use("/api/auth", authRoutes);
+
   // ── health ────────────────────────────────────────────────────────────────
 
   /**