.

README.md

@@ -11,6 +11,8 @@ Contrato simples e tipado de respostas para APIs e serviços (sucesso/erro), com
 ## Instalação
 
 ```bash
+bun add p-respostas
+# ou
 pnpm add p-respostas
 # ou
 npm i p-respostas
@@ -68,6 +70,26 @@ Cria um conjunto de funções padronizadas para gerar respostas.
 
 Instância default de `gerarRespostas(() => ({}))`.
 
+### Validação Zod (`zRespostas`)
+
+Permite validar e inferir tipos de payloads recebidos via HTTP/APIs:
+
+```ts
+import z from "zod"
+import { zRespostas } from "p-respostas"
+
+const schema = zRespostas(z.string())
+const resultado = schema.parse(payload)
+
+if (resultado.eCerto) {
+  console.log("Sucesso:", resultado.valor)
+} else {
+  console.log("Erro:", resultado.mensagem, resultado.cod)
+}
+```
+
+Também exporta `zResposta`, `zRespostaSucesso`, `zRespostaErro`, `zCodigosRespostaErro` e `type tipoZResposta<T>`.
+
 ## Compatibilidade
 
 - Node: `>=20`