O que é o @sinclair/typebox e por que converter DDL SQL para ele?

O TypeBox é um construtor de esquemas JSON Schema de alta performance para TypeScript que combina validação em tempo de execução com inferência de tipos estáticos, sendo a escolha ideal para frameworks como Fastify e Elysia.js.

Como o Static deriva tipos TypeScript em tempo de compilação?

Utilizando tipos condicionais avançados do TypeScript, o utilitário Static extrai a tipagem estática equivalente a partir do objeto JavaScript do esquema sem necessidade de gerar arquivos duplicados.

Como chaves primárias autoincrementais (SERIAL, AUTO_INCREMENT) são tratadas?

O gerador converte inteiros autoincrementais para Type.Integer({ minimum: 1 }). Em esquemas para operações de inserção (INSERT), esses campos podem ser envolvidos com Type.Optional(), pois o banco gera os identificadores.

Os esquemas SQL ou definições de tabelas são enviados para algum servidor?

Não. Todo o processamento sintático do SQL e a geração de código TypeBox ocorrem 100% no navegador do usuário, garantindo total privacidade e conformidade de segurança.

Gerador de Esquemas TypeScript TypeBox a partir de SQL DDL

Converta instruções SQL CREATE TABLE em esquemas de validação em tempo de execução @sinclair/typebox usando Type.Object, Type.String, Type.Number e Type.Optional.

Presets:

Dialeto SQL:

Estratégia de nulos:

Modo de data:

Formato de texto:

Entrada SQL DDL3 tabelas detectadas

-- PostgreSQL SaaS Multi-Tenant Platform
CREATE TYPE user_role AS ENUM ('SUPERADMIN', 'ORG_ADMIN', 'MEMBER', 'BILLING', 'GUEST');
CREATE TYPE subscription_status AS ENUM ('TRIALING', 'ACTIVE', 'PAST_DUE', 'CANCELED');

CREATE TABLE organizations (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  slug VARCHAR(64) NOT NULL UNIQUE,
  name VARCHAR(255) NOT NULL,
  billing_email VARCHAR(255) NOT NULL,
  status subscription_status NOT NULL DEFAULT 'TRIALING',
  settings JSONB,
  is_active BOOLEAN NOT NULL DEFAULT true,
  created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE users (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  organization_id UUID NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
  email VARCHAR(255) NOT NULL UNIQUE,
  full_name VARCHAR(120),
  avatar_url VARCHAR(500),
  role user_role NOT NULL DEFAULT 'MEMBER',
  phone_number VARCHAR(32),
  is_verified BOOLEAN NOT NULL DEFAULT false,
  last_login_at TIMESTAMPTZ,
  created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE audit_logs (
  id BIGSERIAL PRIMARY KEY,
  organization_id UUID NOT NULL REFERENCES organizations(id) ON DELETE CASCADE,
  actor_id UUID REFERENCES users(id) ON DELETE SET NULL,
  event_name VARCHAR(100) NOT NULL,
  ip_address VARCHAR(45),
  user_agent VARCHAR(500),
  payload JSONB,
  created_at TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP
);

Linhas: 39•Dialeto SQL: PostgreSQL•Colunas: 27

1,457 caracteres • 1.4 KB

import { Type, Static } from '@sinclair/typebox';

UserRole {
  SUPERADMIN = 'SUPERADMIN',
  ORG_ADMIN = 'ORG_ADMIN',
  MEMBER = 'MEMBER',
  BILLING = 'BILLING',
  GUEST = 'GUEST',
}
UserRoleSchema = Type.Enum(UserRole);
UserRoleType = Static<typeof UserRoleSchema>;

SubscriptionStatus {
  TRIALING = 'TRIALING',
  ACTIVE = 'ACTIVE',
  PAST_DUE = 'PAST_DUE',
  CANCELED = 'CANCELED',
}
SubscriptionStatusSchema = Type.Enum(SubscriptionStatus);
SubscriptionStatusType = Static<typeof SubscriptionStatusSchema>;

/**
 * TypeBox Schema for SQL table "organizations"
 * Primary Key: [id]
 */
OrganizationSchema = Type.Object({
  id: Type.String({ format: 'uuid' }),
  slug: Type.String({ maxLength: 64 }),
  name: Type.String({ maxLength: 255 }),
  billingEmail: Type.String({ format: 'email', maxLength: 255 }),
  status: SubscriptionStatusSchema,
  settings: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
  isActive: Type.Boolean({ default: true }),
  createdAt: Type.String({ format: 'date-time' }),
  updatedAt: Type.String({ format: 'date-time' }),
}, { additionalProperties: false });
Organization = Static<typeof OrganizationSchema>;

/**
 * TypeBox Schema for SQL table "users"
 * Primary Key: [id]
 */
UserSchema = Type.Object({
  id: Type.String({ format: 'uuid' }),
  organizationId: Type.String({ format: 'uuid' }),
  email: Type.String({ format: 'email', maxLength: 255 }),
  fullName: Type.Optional(Type.String({ maxLength: 120 })),
  avatarUrl: Type.Optional(Type.String({ format: 'uri', maxLength: 500 })),
  role: UserRoleSchema,
  phoneNumber: Type.Optional(Type.String({ maxLength: 32 })),
  isVerified: Type.Boolean({ default: false }),
  lastLoginAt: Type.Optional(Type.String({ format: 'date-time' })),
  createdAt: Type.String({ format: 'date-time' }),
}, { additionalProperties: false });
User = Static<typeof UserSchema>;

/**
 * TypeBox Schema for SQL table "audit_logs"
 * Primary Key: [id]
 */
AuditLogSchema = Type.Object({
  id: Type.Integer({ minimum: 0 }),
  organizationId: Type.String({ format: 'uuid' }),
  actorId: Type.Optional(Type.String({ format: 'uuid' })),
  eventName: Type.String({ maxLength: 100 }),
  ipAddress: Type.Optional(Type.String({ format: 'ipv4' })),
  userAgent: Type.Optional(Type.String({ maxLength: 500 })),
  payload: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
  createdAt: Type.String({ format: 'date-time' }),
}, { additionalProperties: false });
AuditLog = Static<typeof AuditLogSchema>;

Linhas de saída: 72•Format: TypeScript (TypeBox)•Spec: JSON Schema Draft 7/2020-12

2,477 caracteres

Tabelas detectadas

Colunas processadas

Esquemas TypeBox

Processamento no cliente

Processamento de alto desempenho executado inteiramente na memória do navegador.

Privacidade sem envio a servidores

Todas as cargas de dados permanecem estritamente locais, sem comunicação com servidores externos.

Exportação pronta para produção

Formatos de saída limpos e otimizados, prontos para implantação imediata em produção.

Gerador de Esquemas TypeScript TypeBox a partir de SQL DDL

Processamento no cliente

Privacidade sem envio a servidores

Exportação pronta para produção

Guia do Desenvolvedor: Gerador de Schemas TypeScript TypeBox a partir de DDL SQL — Guia de referência

Parâmetros principais e controles

Dicas profissionais e melhores práticas

Como o TypeBox compila diretamente

Para colunas JSON/JSONB no PostgreSQL

Em JavaScript

Problemas comuns e solução de problemas

Colunas sem NOT NULL geram campos opcionais inesperados

Falha ao processar extensões proprietárias ou tipos compostos

Perguntas frequentes (FAQ)

Ferramentas e utilitários relacionados