¿Qué es @sinclair/typebox y por qué convertir sentencias DDL SQL a él?

TypeBox es un generador de tipos JSON Schema para TypeScript de alto rendimiento que unifica la validación en tiempo de ejecución con la inferencia de tipos estáticos, resultando ideal para frameworks modernos como Fastify y Elysia.js.

¿Cómo resuelve Static los tipos de TypeScript?

Mediante tipos condicionales avanzados de TypeScript, la utilidad Static infiere automáticamente la interfaz estática equivalente a partir del objeto de esquema JavaScript sin requerir generación adicional de código.

¿Cómo se manejan las claves primarias autoincrementales (SERIAL, AUTO_INCREMENT)?

Las columnas enteras autoincrementales se traducen a Type.Integer({ minimum: 1 }). En esquemas destinados a operaciones de inserción (INSERT), pueden envolverse en Type.Optional(), ya que la base de datos asigna el identificador automáticamente.

¿Se transmiten las definiciones SQL o credenciales a algún servidor remoto?

No. Todo el análisis del código SQL y la generación de esquemas TypeBox se ejecutan al 100 % en el navegador web del cliente. Sus datos y esquemas nunca salen de su entorno local.

Generador de esquemas TypeScript TypeBox desde SQL DDL

Convierta sentencias SQL CREATE TABLE en esquemas de validación en tiempo de ejecución de @sinclair/typebox utilizando Type.Object, Type.String, Type.Number y Type.Optional.

Presets:

Dialecto SQL:

Estrategia para nulos:

Modo de fecha:

Formato de nombres:

Entrada SQL DDL3 tablas 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
);

Líneas: 39•Dialecto SQL: PostgreSQL•Columnas: 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>;

Líneas de salida: 72•Format: TypeScript (TypeBox)•Spec: JSON Schema Draft 7/2020-12

2,477 caracteres

Tablas detectadas

Columnas procesadas

Esquemas TypeBox

Procesamiento en el cliente

Procesamiento de alto rendimiento ejecutado íntegramente en la memoria del navegador.

Privacidad sin subida a servidores

Todos los datos permanecen estrictamente locales sin comunicación con servidores externos.

Exportación lista para producción

Formatos de salida limpios y optimizados listos para su integración inmediata en producción.

Generador de esquemas TypeScript TypeBox desde SQL DDL

Procesamiento en el cliente

Privacidad sin subida a servidores

Exportación lista para producción

Guía de desarrollo del generador de esquemas TypeBox TypeScript desde DDL SQL — Guía de referencia

Parámetros clave y controles

Consejos profesionales y mejores prácticas

Dado que TypeBox genera

Para columnas JSON/JSONB de PostgreSQL

Dado que los números en JavaScript

Errores comunes y solución de problemas

Las columnas sin NOT NULL generan campos opcionales inesperados

Tipos compuestos o extensiones propietarias generan errores al procesar

Preguntas frecuentes (FAQ)

Herramientas y utilidades relacionadas