orval-labs/orval

Features

• Type-Safe Client Generators - Generates fully typed TypeScript API clients, hooks, and mocks from OpenAPI specifications.
• Model Schema Generators from OpenAPI - Generates Zod validation schemas for every model in an OpenAPI spec for runtime type checking.
• Schema Generators from OpenAPI - Generates Zod and Effect-TS schemas from OpenAPI specs for runtime API validation.
• Effect Schema - Generates Effect-TS schemas from OpenAPI specs and decodes runtime data against them.
• TypeScript Type Generators - Generates TypeScript interfaces and types from OpenAPI schemas for type-safe API interactions.
• OpenAPI Client SDK Generators - Generates fully typed API clients including models and HTTP client code from OpenAPI specifications.
• Schema-Driven Code Generators - Controls all generation options through a configuration file or object, including input source and output structure.
• HTTP Request Code Generators - Creates ready-to-use, typed HTTP request functions for every API endpoint defined in the specification.
• API Client Generators - Generates type-safe API clients, hooks, and mocks from an OpenAPI specification via a configuration file.
• Code from Specification Generators - Reads OpenAPI or Swagger specifications and produces TypeScript API clients, hooks, and mocks.
• TanStack - Generates fully typed TanStack Query hooks for every API path defined in an OpenAPI specification.
• API Mocking - Generates MSW handlers and Faker.js mock factories from OpenAPI specs for testing.
• OpenAPI Mock Generators - Generates MSW handlers and Faker.js mock factories from OpenAPI specs for testing.
• Resource Function Generators - Creates reactive httpResource functions that return Angular HttpResourceRef signals for retrieval-style operations.
• Angular - Generates injectable Angular service classes with typed methods from OpenAPI specifications.
• Angular Service Generators - Creates injectable Angular services with typed HTTP methods using HttpClient from OpenAPI specs.
• Zod Response Validators - Validates API responses against generated Zod schemas at runtime to catch data mismatches.
• Data Fetching Hooks - Creates type-safe data fetching hooks for React Query, Vue Query, Svelte Query, and more.
• Multi-Framework Hook Generators - Generates data-fetching hooks for React Query, Vue Query, Svelte Query, Solid Query, Angular, and SWR.
• React Query Hooks - Generates type-safe React Query hooks from OpenAPI specifications for API integration.
• Frontend Query Library Hooks - Produces data-fetching hooks tailored to multiple frontend query libraries from a single spec.
• Infinite Data Fetching - Generates infinite query functions with configurable pagination parameters for loading paginated data.
• OpenAPI to TypeScript Converters - Converts OpenAPI specifications into fully typed TypeScript type definitions and client code.
• Per-Tag Behavior Overrides - Applies custom mutators, query options, or mock data to all operations sharing an OpenAPI tag.
• MCP Servers - Generates MCP servers from OpenAPI specs so AI agents can interact with APIs through generated tools.
• OpenAPI Generators - Generates Model Context Protocol servers from OpenAPI specifications for AI agent integration.
• OpenAPI Specification Transformers - Applies custom transformations to OpenAPI documents before code generation to repair or augment them.
• Request Payload Validators - Generates Zod schemas that validate outgoing request payloads before they are sent to the API.
• Hono Server Stub Generators - Generates Hono route handlers and validators from OpenAPI specs for server-side implementation.
• Per-Operation Query Option Overrides - Applies custom query settings, such as infinite scrolling, to individual API operations instead of globally.
• Per-Operation Validation Rule Scopings - Applies Zod settings like coercion or strict mode to a single endpoint or all endpoints sharing a tag.
• Mutation-Based Cache Invalidation - Invalidates specified cached queries when named mutations succeed, reducing manual cache management.
• Angular Mutation Functions - Generates Angular injectable mutation functions with automatic cache invalidation from OpenAPI specs.
• Pre-Generation Spec Transformations - Runs a custom sync or async function on the OpenAPI document before validation to repair or augment it.
• API Endpoint Filtering - Selects a subset of API endpoints from the specification to include in the generated output.
• Per-Operation Client Customizations - Overrides specific operations with custom mutators, mock data, and parameter options like URL encoding.
• Pipeline Customizers - Configures the entire code generation pipeline including HTTP clients, mutators, and post-generation scripts.
• Property-Level Mock Value Customizations - Overrides mock generation for specific properties using name, regex, or path matching, with scoping per schema, tag, or operation.
• Multi-Spec Processors - Processes several OpenAPI specifications in a single run with independent configurations.
• Effect Schema Generators - Generates Effect-TS schemas for request parameters, bodies, and responses from OpenAPI specifications.
• Generated Code Organizers - Organizes generated API client code into separate files per endpoint, tag, or schema with configurable output paths.
• MSW Handler Generation - Produces mock handlers for MSW from the API specification to develop frontend features without a live backend.
• Mock Data Generators - Produces realistic mock data for API endpoints using configurable faker-based property generators.
• Angular Signal Queries - Integrates Angular signals with generated queries for automatic re-execution on signal changes.
• Handler Template Generators - Creates handler stubs with built-in Zod validation for server-side implementation.
• Effect Schema Generators - Produces Effect schema modules from OpenAPI specs for runtime validation alongside generated HTTP clients.
• Standard Schema Response Validators - Validates API responses against generated Zod schemas at runtime to catch type mismatches.
• Conditional Data Fetching - Disables generated data hooks when conditions are not met, preventing unnecessary network requests.
• Pluggable - Provides a pluggable HTTP client architecture that swaps between fetch, Axios, or custom implementations.
• Composable Generators - Creates useInfiniteQuery composables for paginated endpoints with configurable cursor parameters.
• Hook Generators - Creates useInfiniteQuery hooks for paginated endpoints that load data in pages.
• Primitive Generators - Creates infinite query hooks with configurable pagination parameters and stale times.
• Store Generators - Produces infinite query stores that support cursor-based pagination using a specified query parameter.
• Per-Operation Behavior Overrides - Applies custom mutators, query options, or mock data to a specific API operation by its ID.
• Angular Query Functions - Generates Angular injectable query functions wrapping TanStack Query for type-safe data fetching.
• Generators and Scaffolding - Generates, validates, and mocks frontend code from OpenAPI specs.

Star history