Huz.Com > Component > Scalar

Handles primitive/scalar types as plain, array, map or map of

Standards

• Language: TS
• Eslint: Yes
• Static Code Analysis: Yes IntelliJ Code Inspections
• DDD - Document Driven: Yes
• EDD - Exception Driven: Yes
• TDD - Test Driven: Yes go to test folder
• Standards Complied: Huz Standards

Commands

• npm run clear // clears "dist" folder
• npm run lint // runs eslint for static code analysis
• npm run test // runs test files in "test" folder
• npm run build // builds JS files at "dist" folder
• npm publish or npm run publix // publishes "dist" folder to npm

Install

npm i @huz-com/scalar

Shared Options

Name	Type	Default	cast	castArray	castMap	Info
log	boolean	true	[x]	[x]	[x]	logs when a problem
error	boolean	false	[x]	[x]	[x]	throws when a problem
mandatory	boolean	false	[x]	[o]	[o]	problem if null
unique	boolean	false	[o]	[x]	[o]	removes duplicated items in array
keepNullItems	boolean	false	[o]	[x]	[o]	keeps null items in array (default: remove nulls)
minItems	integer	null	[o]	[x]	[o]	problem if array size is less than
maxItems	integer	null	[o]	[x]	[o]	problem if array size is greater than
keepNullValues	boolean	false	[o]	[o]	[x]	keeps null values in map (default: remove nulls)
minKeys	integer	null	[o]	[o]	[x]	problem if object key size is less than
maxKeys	integer	null	[o]	[o]	[x]	problem if object key size is greater than

Types

stringType/codeType/namerType/uuidType

• Returns a string in any event ==> string|null
• Trims texts (else noTrim:true)
• Converts empty string to null (else noTrim:true)

Specific Options

Name	Type	Default	cast	castArray	castMap	Info
noTrim	boolean	false	[x]	[x]	[x]	ignore trim (except uuidType)
minLength	integer	null	[x]	[x]	[x]	problem if text length is less than (except uuidType)
maxLength	integer	null	[x]	[x]	[x]	problem if text length is greater than (except uuidType)
pattern	string	null	[x]	[x]	[x]	for only codeType and namerType

Most Used Function

• stringType.is(value: any): boolean
• stringType.cast(value: any, opt?: Options, req?: Request): string|null
• stringType.castArray(value: any, opt?: Options, req?: Request): Array<string> // or Array<string|null> with keepNullItems:true
• stringType.castMap(value: any, opt?: Options, req?: Request): Record<string, string> // or Record<string, string|null> with keepNullValues:true
• stringType.castMapOf(value: any, opt?: Options, req?: Request): Record<string, any>

Samples

Call	Result
stringType.cast(undefined)	null
stringType.cast(5)	"5"
stringType.cast(true)	"true"
stringType.cast(" ")	null
stringType.cast(" foo bar ")	"foo bar"
stringType.cast([" foo"])	"foo"
stringType.cast({id:5})	"5" id property is special
stringType.cast(() => 5)	"5"
stringType.cast(" foo bar ", {noTrim:true})	" foo bar "
stringType.cast("foo bar", {error: true, minLength:10})	throws
stringType.cast("foo bar", {minLength:10})	logs
stringType.cast(" ", {error: true, mandatory:true})	throws
stringType.cast({a:1})	logs
stringType.castArray(null)	[]
stringType.castArray("foo bar ")	["foo bar"]
stringType.castArray([5,true," foo bar", () => 4.5, {id:5}, null])	["5", "true", "foo bar", "4.5", "5"]
stringType.castMap(null)	{}
stringType.castMap({k1: 5, k2: true, k3: " foo bar", k4: () => 4.5, k5: {id:5}, k6: null})	{k1: "5", k2: "true", k3: "foo bar", k4: "4.5", k5: "5"}

intType/floatType

• Returns a number in any event ==> number|null
• Converts infinite numbers to null
• Converts nan numbers to null
• Floors if number is float for only intType

Specific Options

Name	Type	Default	cast	castArray	castMap	Info
def	integer	null	[x]	[x]	[x]	if null use default value
min	integer	null	[x]	[x]	[x]	problem if value is less than
max	integer	null	[x]	[x]	[x]	problem if value is greater than

Most Used Function

• intType.is(value: any): boolean
• intType.cast(value: any, opt?: Options, req?: Request): number|null
• intType.castArray(value: any, opt?: Options, req?: Request): Array<number> // or Array<number|null> with keepNullItems:true
• intType.castMap(value: any, opt?: Options, req?: Request): Record<string, number> // or Record<string, number|null> with keepNullValues:true
• intType.castMapOf(value: any, opt?: Options, req?: Request): Record<number, any>

Samples

Call	Result
intType.cast(undefined)	null
intType.cast("foo", {def:4})	4
intType.cast("5")	5
intType.cast(true)	1
intType.cast(false)	0
intType.cast({id:5})	5 id property is special
intType.cast(() => 5)	5
intType.cast([5])	5
intType.cast(5.3)	5
intType.cast(" foo bar ", {def: 5})	5
intType.cast("foo", {def: 5})	5
intType.cast("foo", {mandatory:true})	logs
intType.cast("5.3", {min:6, error: true})	throws
intType.castArray(undefined)	[]
intType.castArray("5")	[5]
intType.castArray([5,null])	[5]
intType.castArray(["5",null], {keepNullItems: true})	[5, null]
intType.castMap(undefined)	{}
intType.castMap({k1:5, k2: null})	{k1: 5}
intType.castMap({k1:{id:5}, k2: null}, {keepNullValues: true})	{k1: 5, k2: null}

boolType

• Returns a boolean in any event ==> boolean|null
• Converts most-used text to boolean [ true, t, yes, y, on, false, f, no, n, off ]
• Converts positive numbers to true
• Converts negative and zero numbers to false

Specific Options

Name	Type	Default	cast	castArray	castMap	Info
def	boolean	null	[x]	[x]	[x]	if null use default value

Most Used Function

• boolType.is(value: any): boolean
• boolType.cast(value: any, opt?: Options, req?: Request): boolean|null
• boolType.castArray(value: any, opt?: Options, req?: Request): Array<boolean> // or Array<boolean|null> with keepNullItems:true
• boolType.castMap(value: any, opt?: Options, req?: Request): Record<string, boolean> // or Record<string, boolean|null> with keepNullValues:true

Samples

Call	Result
boolType.cast(undefined)	null
boolType.cast(5)	true
boolType.cast(-1)	false
boolType.cast("on")	true
boolType.cast("off")	false
boolType.cast(() => "t")	true
boolType.cast(["yes"])	true
boolType.cast(" foo bar ", {def: false})	false
boolType.cast("foo", {mandatory:true})	logs
boolType.castArray(undefined)	[]
boolType.castArray("5")	[true]
boolType.castArray(["on",null])	[true]
boolType.castArray(["off",null], {keepNullItems: true})	[false, null]
boolType.castMap(undefined)	{}
boolType.castMap({k1:5, k2: null})	{k1: true}
boolType.castMap({k1:false, k2: null}, {keepNullValues: true})	{k1: false, k2: null}

functionType

• Returns a function in any event ==> function|null
• Checks argument size if need
• Supports default function if null

Specific Options

Name	Type	Default	cast	castArray	castMap	Info
def	Function	null	[x]	[x]	[x]	if null use default value
min	integer	null	[x]	[x]	[x]	problem if argument size is less than
max	integer	null	[x]	[x]	[x]	problem if argument size is greater than

Most Used Function

• functionType.is(value: any): boolean
• functionType.cast(value: any, opt?: Options, req?: Request): Function|null
• functionType.castArray(value: any, opt?: Options, req?: Request): Array<Function> // or Array<Function|null> with keepNullItems:true
• functionType.castMap(value: any, opt?: Options, req?: Request): Record<string, Function> // or Record<string, Function|null> with keepNullValues:true

Samples

Call	Result
functionType.cast(undefined)	null
functionType.cast(undefined, {def: () => 'foo'})	() => 'foo'
functionType.cast((p1) => 2 * p1, {min: 2})	logs
functionType.cast("foo", {mandatory:true, error: true})	throws "foo" is not a function
functionType.castArray(undefined)	[]
functionType.castArray([() => 'foo',null])	[() => 'foo']
functionType.castArray([() => 'foo',null], {keepNullItems: true})	[() => 'foo', null]
functionType.castMap(undefined)	{}
functionType.castMap({k1:() => 'foo', k2: null})	{k1: () => 'foo'}
functionType.castMap({k1:() => 'foo', k2: null}, {keepNullValues: true})	{k1: () => 'foo', k2: null}

Other Types

• @todo
• dateType

  Converts any date related (string, number, integer array, Date, Moment) value Date type

  • Date
  • Date[] | Array<Date>
  • {[key: string]: Date} | Record<string, Date>
• isoDatetimeType [format: yyyy-mm-ddTHH:ii:ss.eee.Z]

  Converts any date related (string, number, integer array, Date, Moment) value ISO Datetime format

  • string
  • string[] | Array<string>
  • {[key: string]: string} | Record<string, string>
• isoDateType [format: yyyy-mm-dd]

  Converts any date related (string, number, integer array, Date, Moment) value ISO Date format

  • string
  • string[] | Array<string>
  • {[key: string]: string} | Record<string, string>
• isoTimeType [format: HH:ii:ss.eee.Z]

  Converts any date related (string, number, integer array, Date, Moment) value ISO Time format

  • string
  • string[] | Array<string>
  • {[key: string]: string} | Record<string, string>
• momentType

  Converts any date related (string, number, integer array, Date, Moment) value Moment class

  • Moment
  • Moment[] | Array<Moment>
  • {[key: string]: Moment} | Record<string, Moment>
• regExpType

  Validates Regexp (also converts string to RegExp)

  • RegExp
  • RegExp[] | Array<RegExp>
  • {[key: string]: RegExp} | Record<string, RegExp>
• anyType

  For anonymous scalar type usage

  • any
  • any[] | Array<any>
  • {[key: string]: any} | Record<string, any>
• arrayType

  For anonymous array usage

  • any[] | Array<any>
  • any[][] | Array<Array<any>>
  • {[key: string]: any[]} | Record<string, Array<any>>
• objectType

  For anonymous object (also be called as map or record) usage

  • {[key: string]: any} | Record<string, any>
  • {[key: string]: any}[] | Array<Record<string, any>>
  • {[key: string]: {[sub: string]: any}} | Record<string, Record<string, any>>