batchCreate

Valida multiplos itens de uma vez, coletando todos os sucessos e falhas separadamente.

Sequencial (padrao)

import { SchemaBuilder, FString, FEmail, FInt } from "tyforge";
import type { ISchema } from "tyforge";

const userSchema = {
  name: { type: FString },
  email: { type: FEmail },
  age: { type: FInt },
} satisfies ISchema;

const validator = SchemaBuilder.compile(userSchema);

const items = [
  { name: "Maria", email: "maria@test.com", age: 28 },
  { name: "", email: "invalid", age: 0 },  // invalido
  { name: "Joao", email: "joao@test.com", age: 30 },
];

const result = validator.batchCreate(items);

console.log(result.ok.length);      // 2 (itens validos)
console.log(result.errors.length);   // 1 (itens invalidos)
console.log(result.errors[0].index); // 1 (indice original)

Paralelo (worker threads)

Para grandes volumes de dados (100K+ itens), use worker threads para paralelizar a validacao:

const items = loadMillionsFromDatabase();

const result = await validator.batchCreate(items, {
  concurrency: 4,       // numero de worker threads
  chunkSize: 10_000,    // itens por chunk de worker
});

O programador decide quando paralelizar. Sem opcoes, executa sequencialmente com zero overhead.

Opcoes

Opcao	Tipo	Padrao	Descricao
concurrency	number	1	Numero de worker threads. 1 = sequencial.
chunkSize	number	10_000	Itens por chunk de worker.

Quando usar paralelo

Itens	Sequencial	4 Workers	Recomendacao
< 10K	~8ms	~12ms	Sequencial (workers adicionam overhead)
100K	~80ms	~25ms	Paralelo (3x mais rapido)
1M	~800ms	~220ms	Paralelo (3.6x mais rapido)
10M	~8s	~2.2s	Paralelo (3.6x mais rapido)

Casos de uso

• Migracao de banco de dados: validar milhoes de registros antes de inserir em novo schema
• Verificacao de consistencia: validar registros existentes contra regras de schema atualizadas
• Importacao em massa: validar arquivos CSV/JSON com milhares de entradas

Como funciona

1. A thread principal divide os itens em chunks
2. Cada worker thread recebe um chunk + schema serializado
3. Workers compilam o schema localmente e validam seu chunk
4. Resultados (primitivos + detalhes de erros) sao enviados de volta para a thread principal
5. A thread principal reconstroi instancias de TypeField via assign()

Notas importantes

• O modo paralelo retorna uma Promise — use await
• O modo sequencial (padrao) retorna de forma sincrona
• Cada worker compila o schema independentemente (custo insignificante)
• Worker threads requerem Node.js 24+
• A flag --expose-gc e opcional mas recomendada para grandes lotes