Como rodar TypeScript com Experimental Strip
Como configurar scripts no package.json para rodar seu servidor TypeScript usando Node.js com suporte à flag --experimental-strip-types e evitar problemas com tipos, como o uso de type-only imports
Por que isso é importante
Como rodar TypeScript com Experimental Strip. Como configurar scripts no package.json para rodar seu servidor TypeScript usando Node.js com suporte à flag --experimental-strip-types e evitar problemas com tipos, como o uso de type-only imports
Configurando o script de desenvolvimento no package.json
O primeiro passo é criar um script para iniciar o servidor. No seu package.json, adicione um script chamado dev com a flag --experimental-strip-types para que o Node.js saiba lidar com arquivos TypeScript diretamente.
package.json , crie um script dev: "dev": "node --watch --loader tsx --experimental-specifier-resolution=node
--experimental-strip-types src/server.ts" .npm run dev e observe a
saída no terminal.Entendendo o erro com tipos do Fastify + Zod
Ao executar o servidor, é comum se deparar com um erro relacionado a módulos não encontrados. Isso acontece porque certos tipos como o <code>ZodTypeProvider</code> não são tratados como tipos puros após o strip de tipos do Node.
Atenção
O erro ocorre porque, mesmo após "remover os tipos", o Node ainda tenta interpretar um type como módulo padrão. Sendo assim, devemos destacar explicitamente que se trata de um import apenas de tipo.
A correção consiste em ajustar a importação para o formato <code>import type { ZodTypeProvider } from 'fastify-type-provider-zod'</code> . Assim, o Node ignora esse trecho no runtime por ser apenas tipo, resolvendo o problema.
Eliminando os ExperimentalWarnings
Ao usar recursos experimentais como strip types, o Node emite avisos constantes. Para evitar que eles poluam seu terminal durante o desenvolvimento, podemos desativá-los diretamente no script.
Dica
Adicione <code>--no-warnings=ExperimentalWarning</code> logo após o comando para ocultar essas mensagens.
Adicionando o modo watch automático
A flag <code>--watch</code> reinicia automaticamente o servidor sempre que um arquivo é salvo. Isso acelera bastante o feedback durante o desenvolvimento.
Atenção
Certifique-se de estar utilizando Node.js 20+ com suporte à flag <code>--experimental-watch</code> nativamente.
Script de produção (sem watch)
Para rodar sua aplicação em produção, remova a flag <code>--watch</code> e os warning flags. Crie um script <code>start</code> no <code>package.json</code> que rode o mesmo comando, porém sem <code>--watch</code> .
Importante
Ter scripts separados para desenvolvimento e produção evita conflitos e mantém o ambiente de runtime mais limpo.
Ferramentas utilizadas
Fastify + Zod
Framework web e validador de tipos para rotas
Node.js 20+
Versão mínima recomendada para usar flag --experimental-strip-types
Checklist de Implementação
Continue lendo
Fastify vs Express vs NestJS: O Stack Back-end que Faz API Escalar de Verdade
Como montar o back-end Node.js mais moderno, rápido e validado: Fastify, Express ou NestJS? Veja...
Como documentar APIs Fastify com Scalar, Zodiac e Swagger: guia prático de OpenAPI
Documentação de API não precisa ser difícil. Automatize tudo com Fastify, Scalar e Zodiac e tenha tudo em tempo real...
Como construir um CRUD com Fastify, banco de dados e deploy
A construir uma API com Fastify, trabalhando com operações CRUD, banco de dados em memória e PostgreSQL e...
The Node.js Book for Enterprise: O Guia para Aplicações Escaláveis
A Platformatic lançou um livro gratuito sobre como construir e escalar aplicações Node.js para o ambiente...