optimal

Optimal

Optimal is a system for building and validating any value with typed schemas, and first-class support for defined object structures, like options objects, configuration files, validation fields, and many more. Optimal aims to provide a powerful API, with high performance, the lowest possible filesize, and TypeScript-first support.

// Import schemas to build validators withs
import { array, string, number, optimal } from 'optimal';

// Define and validate values with individual schemas
const maxSizeSchema = number().positive().lte(10000);

maxSizeSchema.validate(1234);

// Or define an explicit shaped blueprint
const schema = optimal({
  name: string().notEmpty(),
  include: array().of(string()),
  exclude: array().of(string()),
  maxSize: maxSizeSchema
});

// Pass a full or partial object to validate
const options = schema.validate({ name: 'Optimal' });

// Which validates, builds, and returns the following object
{
  name: 'Optimal',
  include: [],
  exclude: [],
  maxSize: 10000,
}

Features

• Zero dependencies, with a tree-shakable API.
• Powerful inferrence using a TypeScript first design.
• Runs in both Node.js and the browser.
• Smallest filesize: 5kB minified and gzipped!
• Immutable & fluent schema builder pattern.
• Recursively builds and validates nested structures.
• Supports common data types.
• Autofills missing fields with default values.
• Allows or restricts unknown fields.
• Mark fields as nullable or required.
• Handles logical operators AND, OR, and XOR.

Requirements

• Node v12.17 (server)
• Edge, Chrome, Firefox, Safari (browser)

Installation

yarn add optimal

Documentation

https://optimallib.dev