ianstormtaylor/superstruct
Superstruct
Superstruct is a JavaScript and TypeScript data validation library used to verify that data structures match defined shapes and types. It functions as a composable schema builder and a TypeScript schema validator, ensuring that runtime data checks remain synchronized with static type definitions.
The library features a data coercion engine that transforms input values or injects default values before the validation process is executed. It enables the creation of complex validation rules by nesting, merging, or omitting properties from existing structures.
Its capabilities cover the validation of complex types such as unions, intersections, tuples, and dictionaries, alongside the ability to define custom validators and apply specific refinements to base data types. The system also provides automatic type inference to derive static types from schemas, removing the need for manual type casting.
Features
- Data Type Validation - Ensures data conforms to expected structures by checking that values match specific types and schema definitions at runtime.
- Schema Validation - A comprehensive system for verifying data structures against predefined composable schemas.
- Data Type Coercion - Provides a data coercion engine to transform input values into target types before final validation.
- Data Validation Libraries - Provides a comprehensive library for parsing, validating, and enforcing data structures against predefined schemas in JavaScript and TypeScript.
- Composable Schema Builders - Offers a set of tools for creating intricate validation rules by nesting, merging, or omitting properties from existing structures.
- Structural Data Validators - Evaluates and validates incoming data against defined structural requirements and custom types.
- Data Schema Definitions - Provides structures for defining complex, nested data models and validation rules via composable primitives.
- Schema Composition - Enables building complex validators by picking, omitting, or merging properties from existing structural definitions.
- Recursive Validation Engines - Implements a system that handles nested data structures by recursively dispatching validation logic across hierarchies.
- Schema Composition Libraries - Provides a functional approach to building complex validation structures by nesting and chaining reusable schema primitives.
- Schema-Driven Type Inference - Automatically derives static TypeScript type definitions from runtime schema configurations to keep them synchronized.
- Schema Type Inference - Automatically maps runtime schema definitions to static TypeScript types for automated type safety.
- Type-Safe Schema Validations - Synchronizes runtime data checks with static TypeScript type definitions to ensure end-to-end type safety.
- Schema-Driven Input Mutators - Transforms raw input data and injects defaults to ensure the input meets required schema formats.
- Value Transformations - Provides custom functions that modify data values or apply defaults during the casting process before validation.
- Property Strictness - Implements rules that ensure objects contain only specified keys by filtering or stripping extras.
- Custom Validators - Provides the mechanism for creating specialized validation rules for types not covered by standard primitives.
- Value Type Conversions - Transforms data from one primitive or complex type to another during the validation pipeline.
- Data Transformation Pipelines - Implements utilities for processing and converting raw input data through multi-stage transformation and validation workflows.
- Schema Default Values - Injects fallback values into fields when input data is undefined or missing during validation.
- Predicate Refinements - Allows extending base type checks with custom predicate functions to enforce specific value ranges or formats.
- Request Validation - Provides utilities for validating incoming HTTP request data before it is processed by the backend.
- Schema Validation Refinements - Allows for the application of custom validation logic and specialized constraints, such as numeric ranges, to base data types.
- Validator Composition - Enables the creation of complex validation rules by wrapping existing validators for unions or intersections.
- Data Validation - Simple and composable data validation.
- Runtime Validation - Composable data validation library.
- Data Validation - Composable data validation for JS and TS.
