refatoração para ia

src/index.ts

@@ -1 +1,2 @@
+// Re-export da API pública do pacote.
 export * from "./respostas"

src/respostas.ts

@@ -1,3 +1,8 @@
+/**
+ * Códigos padrão usados pelo contrato de respostas.
+ *
+ * Observação: este enum é parte da API pública do pacote.
+ */
 export enum codigosResposta {
   sucesso = 200,
   erroConhecido = 400,
@@ -39,6 +44,11 @@ export type tipoPrErroInterno = {
   __filename?: string
 }
 
+/**
+ * Cria um conjunto de geradores de respostas.
+ *
+ * @param registrarErroInterno callback para registrar/normalizar erros internos.
+ */
 export const gerarRespostas = (
   /** Faz um processamento quando erro interno
    * Recebe o erro gerado, mensagem personalizada e detalhes
@@ -178,6 +188,6 @@ export const gerarRespostas = (
 }
 
 /**
- * Uso de respostas em comuns
+ * Instância default (sem handler de erro interno).
  */
 export const respostaComuns = gerarRespostas(() => ({}))