refatoração para ia

dist-front/index.d.mts

@@ -1,3 +1,8 @@
+/**
+ * Códigos padrão usados pelo contrato de respostas.
+ *
+ * Observação: este enum é parte da API pública do pacote.
+ */
 declare enum codigosResposta {
     sucesso = 200,
     erroConhecido = 400,
@@ -29,6 +34,11 @@ type tipoPrErroInterno = {
     local: string;
     __filename?: string;
 };
+/**
+ * Cria um conjunto de geradores de respostas.
+ *
+ * @param registrarErroInterno callback para registrar/normalizar erros internos.
+ */
 declare const gerarRespostas: (
 /** Faz um processamento quando erro interno
  * Recebe o erro gerado, mensagem personalizada e detalhes
@@ -68,7 +78,7 @@ registrarErroInterno: (op: tipoPrErroInterno) => Partial<tipoRespostaErro>) => {
     erroEspera: (mensagem?: string | undefined | null, detalhes?: string[]) => tipoRespostaErro;
 };
 /**
- * Uso de respostas em comuns
+ * Instância default (sem handler de erro interno).
  */
 declare const respostaComuns: {
     /**