<p><a href="https://github.com/colinhacks/zod">Zod</a> é a biblioteca de validação mais famosa do ecossistema TypeScript. Com Zod, você cria um <em>schema</em> e valida seus dados de acordo com o <em>schema</em>. Observe o <em>schema</em> abaixo:</p>
<pre><code class="highlited-code-wrapper langts"><div class="highlited-code" data-language="ts">import { z } from 'zod'

const UserSchema = z.object({
  name: z.string().min(1),
  age: z.number({ coerce: true }).min(18),
  email: z.string().email(),
})</div>
</code></pre><p>Este <em>schema</em> pode ser usado para validar um objeto da seguinte maneira:</p>
<pre><code class="highlited-code-wrapper langts"><div class="highlited-code" data-language="ts">const data = {
  name: 'John Doe',
  age: 18,
  email: 'john@example.com',
}

// Caso haja um erro na validação, lança um erro
const validatedData = UserSchema.parse(data)

// Caso haja um erro na validação, retorna um objeto com erro, para você tratar posteriormente
const safeValidatedData = UserSchema.safeParse(data)
// =&gt; { success: false; error: ZodError }
// =&gt; { success: true; data: 'billie' }</div>
</code></pre><p>O Zod é capaz de fazer diversos tipos de validações nos seus dados, certifique-se de ler a <a href="https://github.com/colinhacks/zod">documentação</a> para mais detalhes.</p>
<h2>Validando as variáveis de ambiente</h2>
<p>Podemos usar o Zod para validar os valores presentes no <a href="https://nodejs.org/api/process.html#processenv"><code>process.env</code></a> e até processá-los antes de usar as variáveis de ambiente na nossa aplicação. Normalmente, eu gosto de criar um arquivo <code>environment.ts</code>, como no exemplo abaixo:</p>
<pre><code class="highlited-code-wrapper langts"><div class="highlited-code" data-language="ts">import { z } from 'zod'

const environmentSchema = z.object({
  // Define os valores possíveis para o NODE_ENV, deixando sempre um valor padrão:
  NODE_ENV: z.enum(['test', 'development', 'production']).default('production'),
  // Variáveis de ambiente sempre são definidas como strings. Aqui, transformo a string em número e defino um valor padrão: 
  PORT: z.number({ coerce: true }).default(3000),
})

export const env = environmentSchema.parse(process.env)</div>
</code></pre><p>Depois, é só importar a variável e usar ao longo da minha aplicação:</p>
<pre><code class="highlited-code-wrapper langts"><div class="highlited-code" data-language="ts">import Fastify from 'fastify'
import { env } from './environment.js'

const app = Fastify({ logger: true })
app.listen({ port: env.PORT }, (err) =&gt; {
  if (err) {
    app.log.error(err)
    process.exit(1)
  }
})</div>
</code></pre>

Douglas Moura

Douglas Moura

#Tips

Valide suas variáveis de ambiente com Zod