Package Exports
- typia
- typia/lib/IValidation
- typia/lib/IValidation.js
- typia/lib/Primitive
- typia/lib/Primitive.js
- typia/lib/TypeGuardError
- typia/lib/TypeGuardError.js
- typia/lib/factories/CommentFactory
- typia/lib/factories/CommentFactory.js
- typia/lib/factories/ExpressionFactory
- typia/lib/factories/ExpressionFactory.js
- typia/lib/factories/IdentifierFactory
- typia/lib/factories/IdentifierFactory.js
- typia/lib/factories/LiteralFactory
- typia/lib/factories/LiteralFactory.js
- typia/lib/factories/MetadataCollection
- typia/lib/factories/MetadataCollection.js
- typia/lib/factories/MetadataFactory
- typia/lib/factories/MetadataFactory.js
- typia/lib/factories/MetadataTagFactory
- typia/lib/factories/MetadataTagFactory.js
- typia/lib/factories/StatementFactory
- typia/lib/factories/StatementFactory.js
- typia/lib/factories/TemplateFactory
- typia/lib/factories/TemplateFactory.js
- typia/lib/factories/TypeFactory
- typia/lib/factories/TypeFactory.js
- typia/lib/factories/ValueFactory
- typia/lib/factories/ValueFactory.js
- typia/lib/functional/$every
- typia/lib/functional/$every.js
- typia/lib/functional/$guard
- typia/lib/functional/$guard.js
- typia/lib/functional/$is_email
- typia/lib/functional/$is_email.js
- typia/lib/functional/$is_ipv4
- typia/lib/functional/$is_ipv4.js
- typia/lib/functional/$is_ipv6
- typia/lib/functional/$is_ipv6.js
- typia/lib/functional/$is_url
- typia/lib/functional/$is_url.js
- typia/lib/functional/$is_uuid
- typia/lib/functional/$is_uuid.js
- typia/lib/functional/$join
- typia/lib/functional/$join.js
- typia/lib/functional/$number
- typia/lib/functional/$number.js
- typia/lib/functional/$report
- typia/lib/functional/$report.js
- typia/lib/functional/$rest
- typia/lib/functional/$rest.js
- typia/lib/functional/$string
- typia/lib/functional/$string.js
- typia/lib/functional/$tail
- typia/lib/functional/$tail.js
- typia/lib/index.js
- typia/lib/metadata/IJsDocTagInfo
- typia/lib/metadata/IJsDocTagInfo.js
- typia/lib/metadata/IMetadata
- typia/lib/metadata/IMetadata.js
- typia/lib/metadata/IMetadataApplication
- typia/lib/metadata/IMetadataApplication.js
- typia/lib/metadata/IMetadataConstant
- typia/lib/metadata/IMetadataConstant.js
- typia/lib/metadata/IMetadataEntry
- typia/lib/metadata/IMetadataEntry.js
- typia/lib/metadata/IMetadataObject
- typia/lib/metadata/IMetadataObject.js
- typia/lib/metadata/IMetadataProperty
- typia/lib/metadata/IMetadataProperty.js
- typia/lib/metadata/IMetadataTag
- typia/lib/metadata/IMetadataTag.js
- typia/lib/metadata/Metadata
- typia/lib/metadata/Metadata.js
- typia/lib/metadata/MetadataConstant
- typia/lib/metadata/MetadataConstant.js
- typia/lib/metadata/MetadataObject
- typia/lib/metadata/MetadataObject.js
- typia/lib/metadata/MetadataProperty
- typia/lib/metadata/MetadataProperty.js
- typia/lib/module
- typia/lib/module.js
- typia/lib/programmers/ApplicationProgrammer
- typia/lib/programmers/ApplicationProgrammer.js
- typia/lib/programmers/AssertParseProgrammer
- typia/lib/programmers/AssertParseProgrammer.js
- typia/lib/programmers/AssertProgrammer
- typia/lib/programmers/AssertProgrammer.js
- typia/lib/programmers/AssertStringifyProgrammer
- typia/lib/programmers/AssertStringifyProgrammer.js
- typia/lib/programmers/CheckerProgrammer
- typia/lib/programmers/CheckerProgrammer.js
- typia/lib/programmers/FeatureProgrammer
- typia/lib/programmers/FeatureProgrammer.js
- typia/lib/programmers/IsParseProgrammer
- typia/lib/programmers/IsParseProgrammer.js
- typia/lib/programmers/IsProgrammer
- typia/lib/programmers/IsProgrammer.js
- typia/lib/programmers/IsStringifyProgrammer
- typia/lib/programmers/IsStringifyProgrammer.js
- typia/lib/programmers/StringifyProgrammer
- typia/lib/programmers/StringifyProgrammer.js
- typia/lib/programmers/ValidateParseProgrammer
- typia/lib/programmers/ValidateParseProgrammer.js
- typia/lib/programmers/ValidateProgrammer
- typia/lib/programmers/ValidateProgrammer.js
- typia/lib/programmers/ValidateStringifyProgrammer
- typia/lib/programmers/ValidateStringifyProgrammer.js
- typia/lib/programmers/helpers/AtomicPredicator
- typia/lib/programmers/helpers/AtomicPredicator.js
- typia/lib/programmers/helpers/FunctionImporeter
- typia/lib/programmers/helpers/FunctionImporeter.js
- typia/lib/programmers/helpers/IExpressionEntry
- typia/lib/programmers/helpers/IExpressionEntry.js
- typia/lib/programmers/helpers/OptionPredicator
- typia/lib/programmers/helpers/OptionPredicator.js
- typia/lib/programmers/helpers/StringifyJoinder
- typia/lib/programmers/helpers/StringifyJoinder.js
- typia/lib/programmers/helpers/StringifyPredicator
- typia/lib/programmers/helpers/StringifyPredicator.js
- typia/lib/programmers/helpers/UnionExplorer
- typia/lib/programmers/helpers/UnionExplorer.js
- typia/lib/programmers/helpers/UnionPredicator
- typia/lib/programmers/helpers/UnionPredicator.js
- typia/lib/programmers/internal/application_array
- typia/lib/programmers/internal/application_array.js
- typia/lib/programmers/internal/application_boolean
- typia/lib/programmers/internal/application_boolean.js
- typia/lib/programmers/internal/application_constant
- typia/lib/programmers/internal/application_constant.js
- typia/lib/programmers/internal/application_default
- typia/lib/programmers/internal/application_default.js
- typia/lib/programmers/internal/application_default_string
- typia/lib/programmers/internal/application_default_string.js
- typia/lib/programmers/internal/application_native
- typia/lib/programmers/internal/application_native.js
- typia/lib/programmers/internal/application_number
- typia/lib/programmers/internal/application_number.js
- typia/lib/programmers/internal/application_object
- typia/lib/programmers/internal/application_object.js
- typia/lib/programmers/internal/application_schema
- typia/lib/programmers/internal/application_schema.js
- typia/lib/programmers/internal/application_string
- typia/lib/programmers/internal/application_string.js
- typia/lib/programmers/internal/application_templates
- typia/lib/programmers/internal/application_templates.js
- typia/lib/programmers/internal/application_tuple
- typia/lib/programmers/internal/application_tuple.js
- typia/lib/programmers/internal/check_array
- typia/lib/programmers/internal/check_array.js
- typia/lib/programmers/internal/check_dynamic_properties
- typia/lib/programmers/internal/check_dynamic_properties.js
- typia/lib/programmers/internal/check_everything
- typia/lib/programmers/internal/check_everything.js
- typia/lib/programmers/internal/check_length
- typia/lib/programmers/internal/check_length.js
- typia/lib/programmers/internal/check_native
- typia/lib/programmers/internal/check_native.js
- typia/lib/programmers/internal/check_number
- typia/lib/programmers/internal/check_number.js
- typia/lib/programmers/internal/check_object
- typia/lib/programmers/internal/check_object.js
- typia/lib/programmers/internal/check_string
- typia/lib/programmers/internal/check_string.js
- typia/lib/programmers/internal/check_string_tags
- typia/lib/programmers/internal/check_string_tags.js
- typia/lib/programmers/internal/check_template
- typia/lib/programmers/internal/check_template.js
- typia/lib/programmers/internal/decode_union_object
- typia/lib/programmers/internal/decode_union_object.js
- typia/lib/programmers/internal/feature_object_entries
- typia/lib/programmers/internal/feature_object_entries.js
- typia/lib/programmers/internal/metadata_to_pattern
- typia/lib/programmers/internal/metadata_to_pattern.js
- typia/lib/programmers/internal/stringify_dynamic_properties
- typia/lib/programmers/internal/stringify_dynamic_properties.js
- typia/lib/programmers/internal/stringify_native
- typia/lib/programmers/internal/stringify_native.js
- typia/lib/programmers/internal/stringify_regular_properties
- typia/lib/programmers/internal/stringify_regular_properties.js
- typia/lib/programmers/internal/template_to_pattern
- typia/lib/programmers/internal/template_to_pattern.js
- typia/lib/schemas/IJsonApplication
- typia/lib/schemas/IJsonApplication.js
- typia/lib/schemas/IJsonComponents
- typia/lib/schemas/IJsonComponents.js
- typia/lib/schemas/IJsonSchema
- typia/lib/schemas/IJsonSchema.js
- typia/lib/transform
- typia/lib/transform.js
- typia/lib/transformers/CallExpressionTransformer
- typia/lib/transformers/CallExpressionTransformer.js
- typia/lib/transformers/ExpressionWithArgumentTransformer
- typia/lib/transformers/ExpressionWithArgumentTransformer.js
- typia/lib/transformers/FileTransformer
- typia/lib/transformers/FileTransformer.js
- typia/lib/transformers/IProject
- typia/lib/transformers/IProject.js
- typia/lib/transformers/ITransformOptions
- typia/lib/transformers/ITransformOptions.js
- typia/lib/transformers/NodeTransformer
- typia/lib/transformers/NodeTransformer.js
- typia/lib/transformers/features/miscellaneous/ApplicationTransformer
- typia/lib/transformers/features/miscellaneous/ApplicationTransformer.js
- typia/lib/transformers/features/miscellaneous/CreateInstanceTransformer
- typia/lib/transformers/features/miscellaneous/CreateInstanceTransformer.js
- typia/lib/transformers/features/miscellaneous/MetadataTransformer
- typia/lib/transformers/features/miscellaneous/MetadataTransformer.js
- typia/lib/transformers/features/parsers/AssertParseTransformer
- typia/lib/transformers/features/parsers/AssertParseTransformer.js
- typia/lib/transformers/features/parsers/CreateAssertParseTransformer
- typia/lib/transformers/features/parsers/CreateAssertParseTransformer.js
- typia/lib/transformers/features/parsers/CreateIsParseTransformer
- typia/lib/transformers/features/parsers/CreateIsParseTransformer.js
- typia/lib/transformers/features/parsers/CreateValidateParseTransformer
- typia/lib/transformers/features/parsers/CreateValidateParseTransformer.js
- typia/lib/transformers/features/parsers/IsParseTransformer
- typia/lib/transformers/features/parsers/IsParseTransformer.js
- typia/lib/transformers/features/parsers/ValidateParseTransformer
- typia/lib/transformers/features/parsers/ValidateParseTransformer.js
- typia/lib/transformers/features/stringifiers/AssertStringifyTransformer
- typia/lib/transformers/features/stringifiers/AssertStringifyTransformer.js
- typia/lib/transformers/features/stringifiers/CreateAssertStringifyTransformer
- typia/lib/transformers/features/stringifiers/CreateAssertStringifyTransformer.js
- typia/lib/transformers/features/stringifiers/CreateIsStringifyTransformer
- typia/lib/transformers/features/stringifiers/CreateIsStringifyTransformer.js
- typia/lib/transformers/features/stringifiers/CreateStringifyTransformer
- typia/lib/transformers/features/stringifiers/CreateStringifyTransformer.js
- typia/lib/transformers/features/stringifiers/CreateValidateStringifyProgrammer
- typia/lib/transformers/features/stringifiers/CreateValidateStringifyProgrammer.js
- typia/lib/transformers/features/stringifiers/IsStringifyTransformer
- typia/lib/transformers/features/stringifiers/IsStringifyTransformer.js
- typia/lib/transformers/features/stringifiers/StringifyTransformer
- typia/lib/transformers/features/stringifiers/StringifyTransformer.js
- typia/lib/transformers/features/stringifiers/ValidateStringifyTransformer
- typia/lib/transformers/features/stringifiers/ValidateStringifyTransformer.js
- typia/lib/transformers/features/validators/AssertTransformer
- typia/lib/transformers/features/validators/AssertTransformer.js
- typia/lib/transformers/features/validators/CreateAssertTransformer
- typia/lib/transformers/features/validators/CreateAssertTransformer.js
- typia/lib/transformers/features/validators/CreateIsTransformer
- typia/lib/transformers/features/validators/CreateIsTransformer.js
- typia/lib/transformers/features/validators/CreateValidateTransformer
- typia/lib/transformers/features/validators/CreateValidateTransformer.js
- typia/lib/transformers/features/validators/IsTransformer
- typia/lib/transformers/features/validators/IsTransformer.js
- typia/lib/transformers/features/validators/ValidateTransformer
- typia/lib/transformers/features/validators/ValidateTransformer.js
- typia/lib/typings/Atomic
- typia/lib/typings/Atomic.js
- typia/lib/typings/ClassProperties
- typia/lib/typings/ClassProperties.js
- typia/lib/typings/OmitNever
- typia/lib/typings/OmitNever.js
- typia/lib/typings/SpecialFields
- typia/lib/typings/SpecialFields.js
- typia/lib/typings/Writable
- typia/lib/typings/Writable.js
- typia/lib/utils/ArrayUtil
- typia/lib/utils/ArrayUtil.js
- typia/lib/utils/Escaper
- typia/lib/utils/Escaper.js
- typia/lib/utils/MapUtil
- typia/lib/utils/MapUtil.js
- typia/lib/utils/PatternUtil
- typia/lib/utils/PatternUtil.js
- typia/lib/utils/Singleton
- typia/lib/utils/Singleton.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (typia) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Typia
// RUNTIME VALIDATORS
export function is<T>(input: unknown | T): input is T; // returns boolean
export function assert<T>(input: unknown | T): T; // throws TypeGuardError
export function validate<T>(input: unknown | T): IValidation<T>; // detailed
// STRICT VALIDATORS
export function equals<T>(input: unknown | T): input is T;
export function assertEquals<T>(input: unknown | T): T;
export function validateEquals<T>(input: unknown | T): IValidation<T>;
// JSON
export function application<T>(): IJsonApplication; // JSON schema
export function assertParse<T>(input: string): T; // type safe parser
export function assertStringify<T>(input: T): string; // safe and faster
// +) isParse, validateParse
// +) stringify, isStringify, validateStringifytypia is a transformer library of TypeScript, supporting below features:
- Super-fast Runtime Validators
- Safe JSON parse and fast stringify functions
- JSON schema generator
All functions in typia require only one line. You don't need any extra dedication like JSON schema definitions or decorator function calls. Just call typia function with only one line like typia.assert<T>(input).
Also, as typia performs AOT (Ahead of Time) compilation skill, its performance is much faster than other competitive libaries. For an example, when comparing validate function is() with other competitive libraries, typia is maximum 15,000x times faster than class-validator.
Measured on Intel i5-1135g7, Surface Pro 8
Sponsors and Backers
Thanks for your support.
Your donation would encourage typia development.
Setup
Setup Wizard
npx typia setupJust type npx typia setup, that's all.
Also, you can specify package manager by --manager argument.
npx typia setup --manager npm
npx typia setup --manager pnpm
npx typia setup --manager yarnAfter the setup, you can compile typia utilization code by using ttsc (ttypescript) command. If you want to run your TypeScript file directly through ts-node, add -C ttypescript argument like below:
# COMPILE THROUGH TTYPESCRIPT
npx ttsc
# RUN TS-NODE WITH TTYPESCRIPT
npx ts-node -C ttypescript src/index.tsManual Setup
If you want to install and setup typia manually, read Guide Documents - Setup.
Also, the Guide Documents - Setup, you can learn how to use pure TypeScript compiler tsc instead of installing the ttypescript compiler with ttsc command.
Vite
When you want to setup typia on your frontend project with vite, just configure vite.config.ts like below.
For reference, don't forget running Setup Wizard before.
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import typescript from "@rollup/plugin-typescript";
import ttsc from "ttypescript";
// https://vitejs.dev/config/
export default defineConfig({
plugins: [
react(),
typescript({
typescript: ttsc,
})
]
});Features
In here README documents, only summarized informations are provided.
For more details, refer to the Guide Documents (wiki).
Runtime Validators
// ALLOW SUPERFLUOUS PROPERTIES
export function is<T>(input: T | unknown): input is T; // returns boolean
export function assert<T>(input: T | unknown): T; // throws `TypeGuardError`
export function validate<T>(input: T | unknown): IValidation<T>; // detailed
// DO NOT ALLOW SUPERFLUOUS PROPERTIES
export function equals<T>(input: T | unknown): boolean;
export function assertEquals<T>(input: T | unknown): T;
export function validateEquals<T>(input: T | unknown): IValidation<T>;
// REUSABLE FACTORY FUNCTIONS
export function createIs<T>(): (input: unknown) => T;
export function createAssert<T>(): (input: unknown) => T;
export function createValidate<T>(): (input: unknown) => IValidation<T>;
export function createEquals<T>(): (input: unknown) => boolean;
export function createAssertEquals<T>(): (input: unknown) => T;
export function createValidateEquals<T>(): (input: unknown) => IValidation<T>;typia supports three type of validator functions:
is(): returnsfalseif not matched with the typeTassert(): throws aTypeGuardErrorwhen not matchedvalidate()- when matched, returns
IValidation.ISuccess<T>withvalueproperty - when not matched, returns
IValidation.IFailurewitherrorsproperty
- when matched, returns
Also, if you want more strict validator functions that even do not allowing superfluous properties not written in the type T, you can use those functions instead; equals(), assertEquals(), validateEquals(). Otherwise you want to create resuable validator functions, you can utilize factory functions like createIs() instead.
When you want to add special validation logics, like limiting range of numeric values, you can do it through comment tags. If you want to know about it, visit the Guide Documents (Features > Runtime Validators > Comment Tags).
Enhanced JSON
// JSON SCHEMA GENERATOR
export function application<
Types extends unknown[],
Purpose extends "swagger" | "ajv" = "swagger",
Prefix extends string = Purpose extends "swagger"
? "#/components/schemas"
: "components#/schemas",
>(): IJsonApplication;
// SAFE PARSER FUNCTIONS
export function isParse<T>(input: string): T | null;
export function assertParse<T>(input: string): T;
export function validateParse<T>(input: string): IValidation<T>;
// FASTER STRINGIFY FUNCTIONS
export function stringify<T>(input: T): string; // unsafe
export function isStringify<T>(input: T): string | null; // safe
export function assertStringify<T>(input: T): string;
export function validateStringify<T>(input: T): IValidation<string>;
// FACTORY FUNCTIONS
export function createAssertParse<T>(): (input: string) => T;
export function createAssertStringify<T>(): (input: T) => string;
// +) createIsParse, createValidateParse
// +) createStringify, createIsStringify, createValidateStringifytypia supports enhanced JSON functions.
application(): generate JSON schema with only one line- you can complement JSON schema contents through comment tags
assertParse(): parse JSON string safely with type validationisStringify(): maximum 10x faster JSON stringify fuction even type safe
Measured on AMD R7 5800H
Appendix
Nestia
Nestia is a helper library set for NestJS, supporting below features:
@nestia/core: 15,000x times faster validation decorator usingtypia@nestia/sdk: evolved SDK and Swagger generator for@nestia/corenestia: just CLI (command line interface) tool
import { Controller } from "@nestjs/common";
import { TypedBody, TypedRoute } from "@nestia/core";
import { IBbsArticle } from "@bbs-api/structures/IBbsArticle";
@Controller("bbs/articles")
export class BbsArticlesController {
/**
* Store a new content.
*
* @param inupt Content to store
* @returns Newly archived article
*/
@TypedRoute.Post() // 10x faster and safer JSON.stringify()
public async store(
// super-fast validator
@TypedBody() input: IBbsArticle.IStore
): Promise<IBbsArticle>;
}