Qu'est-ce que @sinclair/typebox et quel est l'intérêt d'y convertir du SQL DDL ?

TypeBox est un constructeur de schémas JSON Schema ultra-rapide pour TypeScript qui unifie validation à l'exécution et inférence de types statiques, particulièrement adapté aux architectures web modernes avec Fastify ou Elysia.js.

Comment l'utilitaire Static extrait-il les types TypeScript ?

Grâce aux types conditionnels avancés de TypeScript, l'utilitaire Static infère directement l'interface TypeScript équivalente depuis l'objet schéma JavaScript, éliminant toute duplication manuelle.

Comment les clés primaires auto-incrémentées (SERIAL, AUTO_INCREMENT) sont-elles gérées ?

Le générateur traduit les identifiants auto-incrémentés en Type.Integer({ minimum: 1 }). Pour les schémas d'insertion (INSERT), ces champs peuvent être déclarés optionnels avec Type.Optional(), la base générant la clé.

Les schémas SQL ou structures de bases de données sont-ils envoyés à un serveur ?

Non. L'analyse syntaxique du SQL et la génération du code TypeBox s'exécutent intégralement côté client dans votre navigateur web, garantissant la confidentialité absolue de votre modèle de données.

Générateur de schémas TypeScript TypeBox depuis SQL DDL

Convertissez les instructions SQL CREATE TABLE en schémas de validation à l'exécution @sinclair/typebox utilisant Type.Object, Type.String, Type.Number et Type.Optional.

Presets:

Dialecte SQL:

Gestion des valeurs nulles:

Format de date:

Casse des identifiants:

Entrée SQL DDL3 tables détectées

-- 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
);

Lignes : 39•Dialecte SQL: PostgreSQL•Colonnes: 27

1,457 caractères • 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>;

Lignes de sortie : 72•Format: TypeScript (TypeBox)•Spec: JSON Schema Draft 7/2020-12

2,477 caractères

Tables détectées

Colonnes traitées

Schémas TypeBox

Traitement côté client

Traitement haute performance exécuté entièrement dans la mémoire de votre navigateur.

Confidentialité sans envoi au serveur

Toutes les données restent strictement locales sans aucune communication vers un serveur externe.

Export prêt pour la production

Formats de sortie propres et optimisés, prêts pour un déploiement immédiat en production.

Générateur de schémas TypeScript TypeBox depuis SQL DDL

Traitement côté client

Confidentialité sans envoi au serveur

Export prêt pour la production

Guide développeur du générateur de schémas TypeScript TypeBox depuis SQL DDL — Guide de référence

Paramètres clés et contrôles

Conseils de pro et bonnes practices

Puisque TypeBox génère des

Pour les colonnes PostgreSQL

En JavaScript

Pièges courants et dépannage

Les colonnes sans NOT NULL génèrent des propriétés Type.Optional inattendues

Erreur d'analyse sur les extensions ou types composites propriétaires

Foire aux questions (FAQ)

Outils et utilitaires connexes