A validação atual cobre leituras suportadas em PostgreSQL e SQLite, com relatórios de benchmark para Prisma v6, v7, v8, Drizzle e SQL gerado.
Cada teste segue um processo rigoroso de 5 passos para garantir que o SQL gerado produza resultados idênticos ao Prisma
Faz o parsing dos argumentos da consulta Prisma e gera SQL equivalente usando os mesmos models e schema. O SQL gerado usa consultas parametrizadas por segurança e performance.
Executa o SQL gerado diretamente via postgres.js ou better-sqlite3 e a mesma consulta via Prisma. Ambas atingem o mesmo estado do banco.
Trata diferenças de tipo (BigInt vs Number, precisão de Decimal, serialização de Date) e normaliza a ordem das chaves dos objetos para uma comparação justa.
Verifica se os resultados correspondem exatamente: mesmo número de linhas, mesmos valores de campo, mesmas relações aninhadas, mesma ordenação. Qualquer divergência falha o teste.
Mede o tempo de execução com 5 execuções de aquecimento e depois calcula a média de 10-50 iterações por teste. Compara com Prisma v6, Prisma v7, Prisma v8 e Drizzle ORM.
Testes cobrem todas as operações de leitura do Prisma em múltiplos níveis de complexidade
Veja como validamos uma consulta aninhada complexa com filtros de relação
it('nested relation filter', () =>
runParityTest(
db,
benchmarkResults,
'findMany nested relation',
'Organization',
{
method: 'findMany',
where: {
projects: {
some: {
tasks: { some: { status: 'DONE' } }
}
}
}
},
() => db.prisma.organization.findMany({
where: {
projects: {
some: {
tasks: { some: { status: 'DONE' } }
}
}
},
orderBy: { id: 'asc' }
}),
)
)
// runParityTest internamente:
// 1. Chama generateSQL() com os args
// 2. Executa o SQL gerado diretamente
// 3. Executa a consulta Prisma
// 4. Normaliza ambos os resultados
// 5. Verificação de igualdade profunda - falha se houver qualquer diferença
// 6. Mede o tempo de execuçãoA função generateSQL() faz o parsing dos args do Prisma e cria SQL parametrizado. Esta etapa tem benchmark separado para medir o overhead de geração da consulta.
Ambas as consultas atingem o mesmo estado do banco simultaneamente via Promise.all(), garantindo comparação justa e condições de dados idênticas.
Os resultados passam por normalização recursiva: BigInt→Number, Decimal→Float(10), Date→null, parse de JSON, ordenação de chaves. Isso garante precisão na comparação byte a byte.
Comparação via JSON stringify com tolerância zero. Qualquer divergência em número de linhas, valores de campo, objetos aninhados ou ordenação falha o teste com saída de diff detalhada.
Após a validação, 5-50 iterações medem o tempo médio de execução. Os resultados incluem: Prisma v6, Prisma v7, Prisma v8, Drizzle ORM, SQL gerado e overhead de geração de SQL.
Cada teste com benchmark roda no Prisma v6, v7 e v8, onde houver suporte:
Todos os resultados de benchmark são gerados automaticamente e armazenados como JSON para transparência total:
Cada arquivo contém: nome do teste, tempo de execução do Prisma, tempo do SQL gerado, tempo do Drizzle, taxas de aceleração e timestamp ISO.
A suíte de validação e os relatórios de benchmark são open source. Revise o código dos testes, os dados de benchmark e as verificações de paridade.