Api Contract Normalizer

API Endpoint Generator

Generate production-ready CRUD API endpoints with validation and type safety.

Core Workflow

1. Define resource: Entity name and schema
2. Generate routes: POST, GET, PUT/PATCH, DELETE endpoints
3. Add validation: Request body/query validation with Zod/Joi
4. Type responses: TypeScript interfaces for all responses
5. Error handling: Consistent error responses
6. Documentation: OpenAPI/Swagger specs
7. Examples: Request/response samples

Express + TypeScript Pattern

// types/user.types.ts
export interface User {
  id: string;
  email: string;
  name: string;
  role: "user" | "admin";
  createdAt: Date;
  updatedAt: Date;
}

export interface CreateUserDto {
  email: string;
  name: string;
  password: string;
}

export interface UpdateUserDto {
  name?: string;
  email?: string;
}

export interface ApiResponse<T> {
  success: boolean;
  data?: T;
  error?: ApiError;
  meta?: PaginationMeta;
}

export interface ApiError {
  code: string;
  message: string;
  details?: Record<string, string[]>;
}

Validation Schemas (Zod)

// schemas/user.schema.ts
import { z } from "zod";