@danhachuel/leadmaster 0.1.10 → 0.1.12

package/CHANGELOG.md

@@ -6,6 +6,77 @@ O formato é baseado no [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.
 A etiqueta visual de versão usa patch de dois dígitos (ex.: `0.1.00`); o registry NPM
 normaliza para a forma canônica (ex.: `0.1.0`).
 
+## [0.1.11] — 2026-11-08
+
+### Corrigido
+
+- **Launcher ainda devolvia o prompt no MobaXterm — a 0.1.9 não resolveu** — o
+   processo Node encerrava seu event loop logo após imprimir "LeadMaster no ar...",
+   mesmo com o keep-alive `setInterval`. Sem o Node vivo, o MobaXterm fecha a
+   pseudo-console (PTY) e o uvicorn perde o terminal, encerrando junto. Correções
+   definitivas no `scripts/cli.mjs`:
+   - **Terminal preso:** `process.stdin.resume();` inserido **logo antes das
+     mensagens finais de sucesso** — o Node fica indefinidamente vivo ouvindo a
+     entrada padrão, sem depender de timers nem do wrapper do `npx`. O keep-alive
+     `setInterval` permanece como segunda camada de proteção.
+   - **Ciclo de vida vinculado nos dois sentidos:** `child.on('close')` encerra o
+     launcher quando o servidor Python cai (mensagem "Servidor encerrado"), e
+     `process.on('exit')` mata o filho quando o launcher morre — nenhum processo
+     fica órfão. O worker Python continua **sem `.unref()`** (o pai não pode
+     morrer sozinho).
+   - **Erros globais (debug):** handlers `unhandledRejection` e `uncaughtException`
+     logam o erro em vez de derrubar o launcher silenciosamente.
+   - **Sem `process.exit(0)` após o sucesso:** a saída do fluxo principal agora é
+     natural (via listeners do filho); chamadas de `process.exit` permanecem apenas
+     em caminhos de erro acionável, na parada legítima (`SIGTERM`/`SIGBREAK`) e no
+     aviso informativo "já está rodando".
+- **AGENTS.md:** regra inviolável do launcher passa de quatro para **cinco
+   proteções** (nova: *Terminal preso*, incluindo a proibição de `process.exit(0)`
+   após o sucesso e a vedação do `.unref()`).
+- **Gate de regressão reforçado:** `backend/tests/test_launcher_protections.py`
+   falha se `process.stdin.resume();` desaparecer, se `.unref()` aparecer, se o
+   ciclo de vida vinculado for removido ou se os handlers globais sumirem.
+
+## [0.1.12] — 2026-11-08
+
+### Adicionado
+
+- **Extrator de Leads (Instagram)** — segunda fonte dedicada, mesmo padrão do Maps:
+  - Rota `POST /api/extractors/instagram` (`profile_url`, `limit`): sem igmapper
+    configurado gera **mock de 5–10 leads** (segurança anti-bloqueio de conta);
+    com `lucasoal/igmapper` configurado em Ferramentas, executa o CLI real com as
+    flags de isolamento (`creationflags`). Leads salvos em `leads.json` na coluna
+    **"Novos Leads"**.
+  - Página `frontend/src/pages/ExtratorInstagram.tsx` (rota `/extrator-instagram`,
+    link no menu lateral): campo de URL do perfil + slider de quantidade, botão
+    **"Iniciar Extração"** em gradiente (von Restorff/Fitts), **barra de progresso
+    animada** "Buscando seguidores..." (Zeigarnik), tabela de resultados
+    (Nome/Username, Telefone, Fonte, Seguidores) e botão **"Ir para o CRM"**.
+  - Opções avançadas (apenas contas comerciais, mínimo de seguidores) escondidas
+    em accordion (Lei de Hick).
+  - Aba Instagram duplicada em Extratores removida — a página agora tem apenas
+    CNPJ + atalhos para as duas páginas dedicadas (Maps e Instagram).
+
+### Corrigido
+
+- **Launcher (5ª regra inviolável):** `process.on('exit')` mata o worker Python em
+  qualquer caminho de saída (erros inesperados inclusive); `.unref()` eliminado
+  também dos comentários. Gate de regressão atualizado
+  (`test_launcher_protections.py`): falha se `process.stdin.resume()`, o ciclo de
+  vida vinculado ou o isolamento desaparecerem do launcher.
+- **Renumeração por colisão:** a `0.1.11` já estava publicada no registry (commit
+  do terminal preso) — esta sessão renumera para o patch seguinte, conforme regra
+  do AGENTS.md.
+
+## [0.1.11] — 2026-11-08
+
+### Corrigido
+
+- **Launcher — terminal preso:** `process.stdin.resume();` imediatamente antes das
+  mensagens finais de sucesso — o processo Node permanece vivo ouvindo a entrada
+  padrão, o prompt do MobaXterm nunca é devolvido e a PTY (e com ela o uvicorn)
+  não é fechada. Publicada via tag `v0.1.11`.
+
 ## [0.1.10] — 2026-11-08
 
 ### Adicionado

package/backend/main.py

@@ -117,6 +117,11 @@ class MapsExtractIn(BaseModel):
     limit: int = 10
 
 
+class InstagramExtractIn(BaseModel):
+    profile_url: str = Field(min_length=6)
+    limit: int = 10
+
+
 class CnpjIn(BaseModel):
     cnpj: str = Field(min_length=8)
 
@@ -378,6 +383,46 @@ def remover_campanha(campaign_id: str):
 # Extratores
 # ---------------------------------------------------------------------------
 
+@app.post("/api/extractors/instagram", status_code=201)
+def extrair_instagram_endpoint(dados: InstagramExtractIn):
+    """Extrator de leads do Instagram (seguidores de um perfil).
+
+    Sem igmapper configurado, gera mock de 5–10 leads (segurança anti-bloqueio
+    de conta); com `lucasoal/igmapper` configurado em Ferramentas, executa o
+    CLI real com as flags de isolamento de processos. Leads salvos em leads.json
+    na coluna "Novos Leads".
+    """
+    conf = storage.get_config()["extratores"]
+    cli = conf.get("igmapper_cli", "")
+
+    origem = "mock"
+    aviso = ""
+    leads: list = []
+
+    if cli and Path(cli).exists():
+        try:
+            resultado = extractors.extrair_instagram(dados.profile_url)
+            leads = resultado.get("leads", [])
+            if leads:
+                origem = "cli"
+            else:
+                aviso = "O igmapper rodou mas não retornou leads — usando dados mockados."
+        except (extractors.ExtratorNaoConfigurado, extractors.ExtratorErro) as e:
+            aviso = f"igmapper indisponível ({e}); usando dados mockados."
+
+    if not leads:
+        leads = extractors.gerar_mock_instagram(dados.profile_url, dados.limit)
+
+    importados = storage.import_leads(leads)
+    return {
+        "origem": origem,
+        "aviso": aviso,
+        "extraidos": leads,
+        "importados": importados["importados"],
+        "duplicados": len(importados["duplicados"]),
+    }
+
+
 @app.post("/api/extractors/maps", status_code=201)
 def extrair_maps(dados: MapsExtractIn):
     """Extrator de leads do Google Maps.
@@ -420,16 +465,6 @@ def extrair_maps(dados: MapsExtractIn):
     }
 
 
-@app.post("/api/extract/instagram")
-def extrair_instagram(dados: InstagramIn):
-    try:
-        return extractors.extrair_instagram(dados.profile_url)
-    except extractors.ExtratorNaoConfigurado as e:
-        raise HTTPException(400, str(e))
-    except extractors.ExtratorErro as e:
-        raise HTTPException(502, str(e))
-
-
 @app.post("/api/extract/cnpj")
 def consultar_cnpj(dados: CnpjIn):
     try:

package/backend/services/extractors.py

@@ -277,6 +277,55 @@ def gerar_mock_maps(keyword: str, location: str, limit: int = 10) -> list:
     return leads
 
 
+# ---------------------------------------------------------------------------
+# Instagram — mock para teste inicial (anti-bloqueio de conta)
+# ---------------------------------------------------------------------------
+
+_HANDLES_MOCK = [
+    "ju.moreira", "rafa.santos", "carol.dias", "pedro.lima", "bia.rocha",
+    "thi.alves", "fer.mendes", "lu.gabriel", "nai.barbosa", "vi.carvalho",
+]
+
+_PRIMEIROS_MOCK = ["Juliana", "Rafael", "Carolina", "Pedro", "Beatriz", "Thiago", "Fernanda", "Lucas", "Naiane", "Vitor"]
+
+
+def gerar_mock_instagram(profile_url: str, limit: int = 10) -> list:
+    """Gera 5 a 10 leads fictícios de seguidores do Instagram para teste.
+
+    Usado quando o igmapper (lucasoal/igmapper) não está configurado — evita
+    bloqueios de conta nos primeiros testes. Com o CLI configurado em
+    Ferramentas, `extrair_instagram` (com flags de isolamento) é usada no lugar.
+    """
+    quantidade = max(5, min(int(limit or 10), 10))
+    perfil = (profile_url or "").rstrip("/").split("/")[-1] or "perfil"
+    leads = []
+    for i in range(quantidade):
+        handle = _HANDLES_MOCK[i % len(_HANDLES_MOCK)]
+        nome = f"{_PRIMEIROS_MOCK[i % len(_PRIMEIROS_MOCK)]} Seguidores {i + 1:02d}"
+        ddd = 21 + (i * 5) % 79
+        telefone = f"({ddd}) 9{2000 + i:04d}-{5000 + i:04d}"
+        leads.append(
+            {
+                "nome": nome,
+                "telefone": telefone,
+                "email": f"{handle}@gmail.com",
+                "fonte": "Instagram",
+                "etapa": "leads",
+                "empresa": nome,
+                "cidade": "São Paulo/SP",
+                "score": 40 + (i * 6) % 40,
+                "tags": ["instagram"],
+                "extras": {
+                    "username": handle,
+                    "perfil_origem": perfil,
+                    "seguidores": 800 + i * 137,
+                    "bio": f"seguidor de @{perfil}",
+                },
+            }
+        )
+    return leads
+
+
 # ---------------------------------------------------------------------------
 # Utilitários de parsing tolerante
 # ---------------------------------------------------------------------------

package/backend/tests/test_instagram_extractor.py

@@ -0,0 +1,51 @@
+"""Testes do Extrator de Leads (Instagram) — POST /api/extractors/instagram.
+
+Sem igmapper configurado, a rota gera mock (5–10 leads) e persiste em
+leads.json na coluna "Novos Leads". LEADMASTER_HOME em diretório temporário.
+"""
+
+import pytest
+from fastapi.testclient import TestClient
+
+import main
+
+
+@pytest.fixture()
+def client(tmp_path, monkeypatch):
+    monkeypatch.setenv("LEADMASTER_HOME", str(tmp_path))
+    with TestClient(main.app) as c:
+        yield c
+
+
+def test_mock_gera_e_persiste(client):
+    antes = len(client.get("/api/crm/leads").json())
+    r = client.post(
+        "/api/extractors/instagram",
+        json={"profile_url": "https://instagram.com/nike", "limit": 10},
+    )
+    assert r.status_code == 201
+    corpo = r.json()
+    assert corpo["origem"] == "mock"
+    assert 5 <= len(corpo["importados"]) <= 10
+
+    for lead in corpo["importados"]:
+        assert lead["fonte"] == "Instagram"
+        assert lead["etapa"] == "leads"  # coluna "Novos Leads"
+        assert lead["nome"] and lead["telefone"]
+
+    depois = client.get("/api/crm/leads").json()
+    assert len(depois) == antes + len(corpo["importados"])
+
+
+def test_limit_respeitado(client):
+    r = client.post(
+        "/api/extractors/instagram",
+        json={"profile_url": "https://instagram.com/perfil", "limit": 6},
+    )
+    assert r.status_code == 201
+    assert len(r.json()["importados"]) == 6
+
+
+def test_payload_invalido(client):
+    r = client.post("/api/extractors/instagram", json={"limit": 5})
+    assert r.status_code == 422

package/backend/tests/test_launcher_protections.py

@@ -4,9 +4,11 @@ Lê o launcher e falha se qualquer proteção contra encerramento silencioso no
 Windows (MobaXterm) for removida:
 
 1. Keep-alive com setInterval (event loop ativo sem I/O de console);
-2. Absorção de SIGINT/SIGHUP no Windows (apenas log, sem encerrar);
-3. Função guardConsoleStream (anti-EPIPE com espelho em arquivo de log);
-4. Isolamento do worker Python (detached: true / CREATE_NEW_PROCESS_GROUP).
+2. Terminal preso: `process.stdin.resume();` (PTY do MobaXterm nunca fecha);
+   sem `process.exit(0)` no caminho de sucesso e sem `.unref()` no worker;
+3. Absorção de SIGINT/SIGHUP no Windows (apenas log, sem encerrar);
+4. Função guardConsoleStream (anti-EPIPE com espelho em arquivo de log);
+5. Isolamento do worker Python (detached: true / CREATE_NEW_PROCESS_GROUP).
 """
 
 from pathlib import Path
@@ -23,6 +25,18 @@ class TestLauncherProtections:
     def test_keepalivo(self):
         assert "setInterval(() => {}, 1000)" in _conteudo()
 
+    def test_terminal_preso_stdin_resume(self):
+        assert "process.stdin.resume();" in _conteudo()
+
+    def test_worker_nunca_unref(self):
+        assert ".unref()" not in _conteudo()
+
+    def test_ciclo_de_vida_vinculado(self):
+        c = _conteudo()
+        assert "child.on('exit'" in c or "child.on(\"exit\"" in c
+        assert "child.on('close'" in c or "child.on(\"close\"" in c
+        assert "process.on('exit'" in c or "process.on(\"exit\"" in c
+
     def test_absorcao_de_sinais_no_windows(self):
         c = _conteudo()
         assert "SIGINT" in c and "SIGTERM" in c and "SIGHUP" in c