tscript-helpers

Utilities

Bool

import { bool } from 'tscript-helpers/utils'

bool([]) == true
bool({}) == true

Cast

import { cast } from 'tscript-helpers/utils'

cast.toBool() // cast to boolean
cast.asBool() // cast to boolean or undefined


cast.toBool('yes', { extend:false }) // true
cast.toBool('no',  { extend:false }) // false

cast.toBool('none', { extend:true  }) // false
cast.toBool('none', { extend:false }) // Error

cast.asBool('abc123', { extend:false, undefine:true  }) // undefined
cast.asBool('abc123', { extend:false, undefine:false }) // Error

// no black box definition
function toBool(x:undefined|null|boolean|number|string, props:{ force:boolean }) {
    
    if (['true','1','t','y','yes'].includes(String(x).toLowerCase())) return true
    if (['false','0','f','n','no'].includes(String(x).toLowerCase())) return false
    
    if (props.force) {
        if (['undefined','null','none','nan',''].includes(String(x).toLowerCase())) return false
    }

    throw new Error('BOOLEAN_CASTING_FAILED')
}

// no black box definition
function asBool(x:undefined|null|boolean|number|string, props:{ extend:boolean, undefine:boolean }) {

    if (['true','1','t','y','yes'].includes(String(x).toLowerCase())) return true
    if (['false','0','f','n','no'].includes(String(x).toLowerCase())) return false
    
    if (props.extend) {
        if (['undefined','null','none','nan',''].includes(String(x).toLowerCase())) return false
    }

    if (props.undefine) {
        return undefined
    }

    throw new Error('BOOLEAN_CASTING_FAILED')
}

Compact

import { compact } from 'tscript-helpers/utils'

compact(-10)  // -10
compact(100)  // 100

compact(1000) //   1K
compact(1025) //   1K
compact(1075) // 1.1K
compact(1250) // 1.3K
compact(1500) // 1.5K

compact(10_000)  //  10K
compact(123_000) // 120K
compact(125_000) // 130K

Counter

import { Counter } from 'tscript-helpers/utils'

const { getValue, increment, decrement, reset } = new Counter({ initial:0 })

Paginator

import { Paginator } from 'tscript-helpers/utils'

const { pagination } = Paginator()

const feat = TRPC.procedure.input(zod.object({ 
    cursor: zod.number().default(pagination.initialPage), // 1) initialPage 
})).query(async ({ input }) => {
    
    const data = await prismaClient.table.query({ 
        ...pagination.calcPrisma(input.limit, input.cursor),  // 2) calcPrisma
    })
    
    return { data, ...pagination.calcTRPC(data.length, input.limit, input.cursor) } // 3) calcTPRC
})

Optional Call

import { optional_call } from 'tscript-helpers/utils'

let pipe
pipe = optional_call(pipe, 'modifier', arg)       // pipe = pipe.modifier(arg)
pipe = optional_call(pipe, 'modifier', undefined) // pipe = pipe

Stingify

import { stringify } from 'tscript-helpers/utils'

stringify(['https://domain.com', 'endpoint', 'ID'], { abc:123, def:456 }) // https://domain.com/endpoint/ID?abc=123&def=456 

// no black box definition
export function stringify(left:string[], right:Record<string, undefined|null|boolean|number|string>) {
    return [
        left.filter(Boolean).join('/'), 
        Object
            .entries(right)
            .filter(([k, v]) => (k != '') && (v != undefined))
            .map(([k, v]) => k+'='+v)
            .filter(Boolean).join('&')
    ].filter(Boolean).join('?')
}

SQL Queries

SELECT

import { SELECT } from 'tscript-helpers/SQL'

const QUERY = SELECT(['*'], 'Table', { where:'ColA = 123', orderby:['RAND()'], limit:10, offset:10 })

console.log('>> QUERY:', QUERY)

>> QUERY:
SELECT *
FROM Table
WHERE ColA = 123
ORDER BY RAND()
LIMIT 10
OFFSET 10

Hooks

useCounter

import { useCounter } from 'tscript-helpers/hooks'

const { value, setValue, reset, increment, decrement } = useCounter({ initial: 0 })

usePersistedState

import { usePersistedState } from 'tscript-helpers/hooks'

const { data, isLoading } = TRPCNext.feature.useQuery()

const [ data2, __ ] = usePersistedState(data, [])

JSX

If

import { If } from 'tscript-helpers/JSX'

const Component = () => (
    <>
        <If cond={true} > <p>Render</p>   </If>
        <If cond={false}> <p>Disabled</p> </If>
    </>
)