/**
 * Tradução leiga (pt-br) dos vetos da cadeia before_send (Operação Visível F2-i).
 * Os códigos são contrato do engine (lib/agent-engine/guardrails/before-send.ts +
 * pacing/spinning/promise/disclosure) — a tela mostra POR QUE uma resposta do
 * assistente foi retida, sem jargão. Módulo puro: testável sem DOM.
 */

import { cidadeDoFuso } from "@/lib/tempo/fusos";

/** Contexto dos knobs efetivos do número — interpola janela/horário na copy. */
export interface RetentionContext {
  window_start_hour: number;
  window_end_hour: number;
  allow_sunday: boolean;
  timezone: string;
}

export type RetentionKind = "protection" | "compliance" | "quality" | "handoff";

export interface RetentionCopy {
  kind: RetentionKind;
  title: string;
  description: string;
}

const TITLES: Record<RetentionKind, string> = {
  protection: "Resposta segurada pela proteção do número",
  compliance: "Resposta bloqueada por conformidade",
  quality: "Resposta retida para correção",
  // #3310: família própria porque as outras três mentem aqui. A resposta não foi
  // segurada por proteção do número, nem bloqueada por conformidade (nada de
  // LGPD aconteceu), nem retida para correção: o automático está PAUSADO porque
  // a conversa foi passada para a equipe.
  handoff: "Resposta pausada: a conversa está com a equipe",
};

/**
 * Copy por código de veto. Códigos de proteção (pacing/spinning) tranquilizam:
 * foi proteção anti-bloqueio, não erro. Conformidade (stop/LGPD) é definitivo.
 * Qualidade (promise/disclosure) explica que o assistente corrige sozinho.
 */
export function retentionCopy(
  code: string | null,
  ctx: RetentionContext,
  t: (texto: string) => string = (texto) => texto,
): RetentionCopy {
  // O fuso vai escrito: "22h" sem dizer DE ONDE foi o que escondeu, por meses,
  // uma janela avaliada em São Paulo numa operação de Manaus. É o fuso que o
  // motor usou (`fusoDaJanela`), nunca UTC.
  const janela = `${ctx.window_start_hour}h–${ctx.window_end_hour}h, ${t("horário de")} ${cidadeDoFuso(ctx.timezone)}${ctx.allow_sunday ? "" : `, ${t("sem domingo")}`}`;
  const make = (kind: RetentionKind, description: string): RetentionCopy => ({
    kind,
    title: t(TITLES[kind]),
    description,
  });

  switch (code) {
    case "outside_window":
      return make(
        "protection",
        `${t("Fora da janela de envio")} (${janela}). ${t("A resposta fica agendada para a próxima abertura da janela, às")} ${ctx.window_start_hour}h — ${t("isso protege o número contra bloqueio do WhatsApp.")}`,
      );
    case "warmup_cap":
      return make(
        "protection",
        `${t("Este número ainda está em aquecimento e o limite diário de envios dele foi atingido. Enviar além disso arriscaria bloqueio pelo WhatsApp — libera de novo amanhã, a partir das")} ${ctx.window_start_hour}h.`,
      );
    case "daily_cap":
      return make(
        "protection",
        `${t("O limite diário de envios do número foi atingido — proteção contra bloqueio do WhatsApp. Libera de novo amanhã, a partir das")} ${ctx.window_start_hour}h.`,
      );
    case "mass_identical":
      return make(
        "protection",
        t(
          "A mesma mensagem estava se repetindo em massa por este número. O envio foi segurado para variar o texto e não parecer robô para o WhatsApp.",
        ),
      );
    case "contato_bloqueado":
      return make(
        "compliance",
        t("O contato pediu para não receber mensagens (opt-out). Nada será enviado a ele."),
      );
    case "atendimento_com_humano":
      // #3310: este código é o `force_human` SOZINHO — a conversa foi passada
      // para a equipe (ou alguém a pausou à mão), e o contato NÃO pediu para
      // sair. A frase tem de dizer as duas coisas que a equipe precisa: por que
      // o automático está calado e como trazê-lo de volta — senão sobra o
      // caminho mais caro, que é ler o cliente vivo como descadastrado.
      return make(
        "handoff",
        t(
          "O atendimento automático está pausado porque a conversa foi passada para a equipe. Use “Devolver ao automático” para a IA voltar a responder.",
        ),
      );
    case "lgpd_anonymized":
      return make(
        "compliance",
        t("Este contato foi anonimizado (LGPD) — é proibido enviar qualquer mensagem a ele."),
      );
    case "lgpd_missing_legal_basis":
      return make(
        "compliance",
        t(
          "Não há base legal (LGPD) para o primeiro contato de prospecção com este lead. O time precisa regularizar o cadastro antes de abordar.",
        ),
      );
    case "promise_out_of_table":
      return make(
        "quality",
        t(
          "A resposta prometia um preço ou condição fora da tabela aprovada. O assistente foi orientado a corrigir antes de enviar.",
        ),
      );
    case "promise_semantic":
      return make(
        "quality",
        t("A resposta continha uma promessa não autorizada. O assistente foi orientado a reescrever antes de enviar."),
      );
    case "disclosure_required":
      return make(
        "quality",
        t(
          "A primeira mensagem a um contato novo precisa se apresentar como assistente virtual. O assistente foi orientado a corrigir antes de enviar.",
        ),
      );
    default:
      return make(
        "protection",
        `${t("Uma trava de segurança segurou esta resposta")}${code ? ` (${t("código")} ${code})` : ""}. ${t("Ela não foi enviada ao contato.")}`,
      );
  }
}