Was ist @sinclair/typebox und warum sollte man SQL-DDL darin konvertieren?

TypeBox ist ein extrem performanter JSON-Schema-Typbuilder für TypeScript, der Laufzeitvalidierung mit statischer Typermittlung kombiniert. Er ermöglicht eine konsistente Schema-Wiederverwendung zwischen Datenbankmodellen und API-Endpunkten in Fastify und Elysia.js.

Wie erzeugt Static TypeScript-Typen?

Mithilfe fortschrittlicher bedingter Typen in TypeScript leitet TypeBox zur Kompilierzeit die passenden Interface-Strukturen direkt aus dem JavaScript-Schemaobjekt ab, ohne dass ein separater Code-Generierungsschritt nötig ist.

Wie werden automatisch inkrementierende Primärschlüssel (SERIAL, AUTO_INCREMENT) behandelt?

Der Generator übersetzt Primärschlüssel in Type.Integer({ minimum: 1 }). Für Erstellungsschemata (Insert) können diese Felder mittels Type.Optional() als optional gekennzeichnet werden, da die Datenbank den Wert vergibt.

Werden SQL-Tabellendefinitionen oder Daten an externe Server übertragen?

Nein. Die gesamte DDL-Analyse und Code-Generierung läuft zu 100 % lokal in Ihrem Browser ab. Es werden keinerlei SQL-Anweisungen oder Schemadaten über das Netzwerk übertragen.

SQL DDL zu TypeBox TypeScript Schema Generator

Konvertieren Sie SQL CREATE TABLE-Anweisungen in @sinclair/typebox Laufzeit-Validierungsschemata mit Type.Object, Type.String, Type.Number und Type.Optional.

Presets:

SQL-Dialekt:

Null-Strategie:

Datumsmodus:

Schreibweise:

SQL-DDL-Eingabe3 Tabellen erkannt

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

Zeilen: 39•SQL-Dialekt: PostgreSQL•Spalten: 27

1,457 Zeichen • 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>;

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

2,477 Zeichen

Erkannte Tabellen

Verarbeitete Spalten

TypeBox-Schemata

Client-seitige Verarbeitung

Hochperformante Verarbeitung, die vollständig im Browserspeicher ausgeführt wird.

Zero-Server-Upload Datenschutz

Alle Daten verbleiben strikt lokal ohne externe Serverkommunikation.

Produktionsreifer Export

Saubere, optimierte Ausgabeformate, sofort einsatzbereit für die Produktion.

SQL DDL zu TypeBox TypeScript Schema Generator

Client-seitige Verarbeitung

Zero-Server-Upload Datenschutz

Produktionsreifer Export

SQL-DDL zu TypeBox TypeScript-Schema-Konverter — Referenz-Leitfaden

Wichtige Parameter & Steuerelemente

Profi-Tipps & Best Practices

Da TypeBox standardkonformes

Für JSON- oder JSONB-Spalten empfiehlt

JavaScript verliert bei Ganzzahlen

Häufige Fallstricke & Fehlerbehebung

Spalten ohne NOT NULL werden unerwartet als Type.Optional generiert

Benutzerdefinierte Erweiterungen oder Composite Types schlagen beim Parsen fehl

Häufig gestellte Fragen (FAQ)

Verwandte Werkzeuge & Dienstprogramme