typedconverter

TypedConverter

Convert object into classes match with TypeScript type annotation

Convert Primitive Type

import createConverter from "typedconverter";

const convert = createConverter()
const numb = await convert("12345", Number) //return number 12345
const numb = await convert("YES", Boolean) //return true
const numb = await convert("2019-1-1", Date) //return date 1/1/2019

Specify type on configuration

Expected type can be specified in the configuration, than you can omit expected type on the second parameter of the convert function. Useful when you want to covert several times without specifying expected type.

import createConverter from "typedconverter";

const convert = createConverter({type: Number})
const numb = await convert("12345")
const numb1 = await convert("-12345")
const numb2 = await convert("12345.123")

Convert custom class

TypedConvert uses tinspector to get type metadata, so it aware about TypeScript type annotation.

import createConverter from "typedconverter";
import reflect from "tinspector"

const convert = createConverter()

@reflect.parameterProperties()
class AnimalClass {
    constructor(
        public id: number,
        public name: string,
        public deceased: boolean,
        public birthday: Date
    ) { }
}
//return instance of AnimalClass with appropriate properties type
const data = await convert({ 
    id: "200", 
    name: "Mimi", 
    deceased: "ON", 
    birthday: "2018-1-1" }, 
    AnimalClass) 

Convert Array

Convert into array by providing array of type in the expected type.

import createConverter from "typedconverter";

const convert = createConverter()
const numb = await convert(["1", "2", "-3"], [Number])

Convert Child Array

Nested child array need to be decorate for TypeScript added design data type

import createConverter from "typedconverter";

@reflect.parameterProperties()
class Tag {
    constructor(
        public name: string,
    ) { }
}

@reflect.parameterProperties()
class Animal {
    constructor(
        public name: string,
        @reflect.array(Tag)
        public tags: Tags
    ) { }
}

const convert = createConverter()
//tags is instance of Tag class
const numb = await convert({name: "Mimi", tags: [{name: "Susi"}, {name: "Lorem"}]}, Animal)

Guess Array Element

Useful when converting data from url encoded, where single value could be a single array.

const convert = createConverter({ guessArrayElement: true })
const b = await convert("1", [Number]) //ok

Custom Converter

Provided custom converter on the configuration

import createConverter from "typedconverter";

const convert = createConverter({ 
    type: Boolean, 
    converters: [{ type: Boolean, converter: async x =>  new ConversionResult("Custom Boolean")  }] 
})
const numb = await convert("True") //result: "Custom Boolean"

Visitors

Visitors executed after conversion process traverse through properties / array element. Invocation can be multiple and run in sequence the last sequence will execute the converter. Visitors work like Plumier middleware

Signature of Visitor is like below:

type Visitor = (value: any, invocation: ConverterInvocation) => Promise<ConversionResult>

Visitor is a function receive two parameters value and invocation.

• value is current value traversed
• invocation next invocation