Skip to content

Leask/utilitas

BranchesTags

Repository files navigation

🧰 utilitas

MIT licensed Node.js Package

Just another common utility for JavaScript.

Works in Node.js and modern browsers.

Projects developed using utilitas

APIs

alan

symbol type params / value
_NEED Array @anthropic-ai/sdk,@anthropic-ai/vertex-sdk,@google/genai,js-tiktoken,OpenAI
default AsyncFunction options
ATTACHMENTS String [ATTACHMENTS]
CLOUD_40_OPUS String claude-opus-4@20250514
CODE_INTERPRETER Object {"type":"code_interpreter"}
DEEPSEEK_R1 String deepseek-r1
FEATURE_ICONS Object {"audio":"📣","deepsearch":"🔍","fast":"⚡️","finetune":"🔧","image":"🎨","json":"📊","reasoning":"🧠","tools":"🧰","vision":"👁️"}
FUNCTION Object {"type":"function"}
GEMINI_20_FLASH String gemini-2.0-flash-preview-image-generation
GEMINI_25_FLASH String gemini-2.5-flash
GPT_41 String gpt-4.1
GPT_4O String gpt-4o
GPT_O3 String o3
OPENAI_VOICE String OPENAI_VOICE
RETRIEVAL Object {"type":"retrieval"}
TEXT_EMBEDDING_3_SMALL String text-embedding-3-small
_NO_RENDER Array INSTRUCTIONS,MODELS,DEFAULT_MODELS
analyzeSessions AsyncFunction sessionIds, options
buildGptTrainingCase Function prompt, response, options
buildGptTrainingCases Function cases, opts
cancelGptFineTuningJob AsyncFunction aiId, job_id, options
countTokens AsyncFunction input, options
createGeminiEmbedding AsyncFunction aiId, input, options
createGptFineTuningJob AsyncFunction aiId, training_file, options
createOpenAIEmbedding AsyncFunction aiId, input, options
deleteFile AsyncFunction aiId, file_id, options
distillFile AsyncFunction attachments, o
getAi AsyncFunction id, options
getChatAttachmentCost AsyncFunction options
getChatPromptLimit AsyncFunction options
getGptFineTuningJob AsyncFunction aiId, job_id, options
getSession AsyncFunction sessionId, options
init AsyncFunction options
initChat AsyncFunction options
k Function
listFiles AsyncFunction aiId, options
listGptFineTuningEvents AsyncFunction aiId, job_id, options
listGptFineTuningJobs AsyncFunction aiId, options
listOpenAIModels AsyncFunction aiId, options
prompt AsyncFunction input, options
promptAnthropic AsyncFunction aiId, content, options
promptGemini AsyncFunction aiId, content, options
promptOpenAI AsyncFunction aiId, content, options
resetSession AsyncFunction sessionId, options
tailGptFineTuningEvents AsyncFunction aiId, job_id, options
talk AsyncFunction input, options
trimPrompt AsyncFunction getPrompt, trimFunc, contextWindow, options
uploadFile AsyncFunction aiId, input, options
uploadFileForFineTuning AsyncFunction aiId, content, options

bee

symbol type params / value
_NEED Array puppeteer
default AsyncFunction
browse AsyncFunction url, options
end AsyncFunction
init AsyncFunction

bot

symbol type params / value
_NEED Array telegraf
default AsyncFunction options
EMOJI_THINKING String 💬
MESSAGE_LENGTH_LIMIT Number 3891
end AsyncFunction async, options
init AsyncFunction options
lines Function arr, sep
paging Function message, options
parse_mode String Markdown
send AsyncFunction chatId, content, options
sendMd Function cId, cnt, opt

boxes

symbol type params / value
default Object {"topLeft":"╭","top":"─","topRight":"╮","right":"│","bottomRight":"╯","bottom":"─","bottomLeft":"╰","left":"│"}
arrow Object {"topLeft":"↘","top":"↓","topRight":"↙","right":"←","bottomRight":"↖","bottom":"↑","bottomLeft":"↗","left":"→"}
bold Object {"topLeft":"┏","top":"━","topRight":"┓","right":"┃","bottomRight":"┛","bottom":"━","bottomLeft":"┗","left":"┃"}
classic Object {"topLeft":"+","top":"-","topRight":"+","right":"
double Object {"topLeft":"╔","top":"═","topRight":"╗","right":"║","bottomRight":"╝","bottom":"═","bottomLeft":"╚","left":"║"}
doubleSingle Object {"topLeft":"╒","top":"═","topRight":"╕","right":"│","bottomRight":"╛","bottom":"═","bottomLeft":"╘","left":"│"}
round Object {"topLeft":"╭","top":"─","topRight":"╮","right":"│","bottomRight":"╯","bottom":"─","bottomLeft":"╰","left":"│"}
single Object {"topLeft":"┌","top":"─","topRight":"┐","right":"│","bottomRight":"┘","bottom":"─","bottomLeft":"└","left":"│"}
singleDouble Object {"topLeft":"╓","top":"─","topRight":"╖","right":"║","bottomRight":"╜","bottom":"─","bottomLeft":"╙","left":"║"}

cache

symbol type params / value
_NEED Array ioredis
default AsyncFunction options
del AsyncFunction
get AsyncFunction
init AsyncFunction options
set AsyncFunction key, value, options
setEx AsyncFunction key, value, ttl, options

callosum

symbol type params / value
default AsyncFunction options
assertFunc Function
assign Function k, v, o
boardcast Function action, data
call AsyncFunction func, options
del Function k, s, o
delKey AsyncFunction args, options
end AsyncFunction
engage Function worker, action, data
flush AsyncFunction k, o
get AsyncFunction ...args
getFunc Function name, options
getListeners Function i
ignore Function i
init AsyncFunction options
isPrimary Boolean true
isWorker Boolean false
on Function action, callback, options
once Function action, cbf, opts
pop AsyncFunction k, o
push Function k, v, o
queue Function k, v, o
register Function name, func, options
report Function action, data
set AsyncFunction key, value, options
shift AsyncFunction k, o
unregister Function name
unshift Function k, v, o
worker Undefined
workers Object {}

color

symbol type params / value
default Object {}

dbio

symbol type params / value
_NEED Array mysql2,pg
default AsyncFunction options
MYSQL String MYSQL
POSTGRESQL String POSTGRESQL
assembleInsert Function table, data, options
assembleQuery Function table, options
assembleSet Function data, options
assembleTail Function options
assembleUpdate Function table, data, options
cleanSql Function sql
countAll AsyncFunction table
countByKeyValue AsyncFunction table, key, value
deleteAll AsyncFunction table, options
deleteById AsyncFunction table, id, options
deleteByKeyValue AsyncFunction table, key, value, options
desc AsyncFunction table, options
drop AsyncFunction table, options
enableVector AsyncFunction
encodeVector AsyncFunction
end AsyncFunction options
execute AsyncFunction ...args
getPgvector AsyncFunction
getProvider AsyncFunction
indexes AsyncFunction table, options
init AsyncFunction options
insert AsyncFunction table, fields, options
query AsyncFunction ...args
queryAll Function table, options
queryById AsyncFunction table, id, options
queryByKeyValue AsyncFunction table, key, value, options
queryOne AsyncFunction ...args
rawAssembleKeyValue Function key, value, options
rawExecute AsyncFunction ...args
rawQuery AsyncFunction ...args
tables AsyncFunction options
updateById AsyncFunction table, id, fields, options
updateByKeyValue AsyncFunction table, key, value, fields, options
upsert Function table, fields, options
vacuum AsyncFunction table, options

email

symbol type params / value
_NEED Array form-data,mailgun.js,mailparser,node-mailjet
default AsyncFunction options
getSenderName Function
init AsyncFunction options
parse AsyncFunction input, options
rawSend AsyncFunction data
send AsyncFunction email, subject, text, html, args, options

encryption

symbol type params / value
_NEED Array @google-cloud/speech,@google-cloud/text-to-speech,@google-cloud/vision,google-gax
aesCreateIv Function options
aesCreateKey Function options
aesDecrypt Function any, options
aesEncrypt Function any, options
defaultAlgorithm String sha256
defaultEncryption String aes-256-gcm
digestObject Function object, algorithm
getApiKeyCredentials AsyncFunction options
getSortedQueryString Function obj
hash Function string, algorithm
hashFile Function filename, algorithm
hexToBigInt Function hex
md5 Function string
random Function size, callback
randomString Function length, encoding
sha256 Function string, algorithm
sha256File Function filename, algorithm
uniqueString Function any

event

symbol type params / value
default AsyncFunction func, interval, tout, delay, name, options
bulk AsyncFunction absDir, options
end AsyncFunction name
list Function
load AsyncFunction module, options
loop AsyncFunction func, interval, tout, delay, name, options

gen

symbol type params / value
_NEED Array OpenAI,@google/genai
default AsyncFunction options
image AsyncFunction prompt, options
init AsyncFunction options
video AsyncFunction prompt, options

horizon

symbol type params / value
default Object {}

media

symbol type params / value
_NEED Array fluent-ffmpeg,@ffmpeg-installer/ffmpeg,@ffprobe-installer/ffprobe
convertAudioTo16kNanoOpusOgg Function input, options
convertAudioTo16kNanoPcmWave Function input, options
createWavHeader Function dataSize, sampleRate, numChannels, bitsPerSample
getFfmpeg AsyncFunction options
packPcmToWav AsyncFunction audio, options

memory

symbol type params / value
del AsyncFunction key, options
get AsyncFunction key, options
init AsyncFunction
set AsyncFunction key, value, options

network

symbol type params / value
_NEED Array fast-geoip,ping
getCurrentPosition AsyncFunction
httping AsyncFunction url, options
isLocalhost Function host
pickFastestHost AsyncFunction hosts, options
pickFastestHttpServer AsyncFunction urls, options
ping AsyncFunction host, options

sentinel

symbol type params / value
_NEED Array @sentry/node,@sentry/profiling-node
default AsyncFunction options
init AsyncFunction options

shell

symbol type params / value
default AsyncFunction command, options
assertExist AsyncFunction bin, er, code
exec AsyncFunction command, options
exist Function bin
which AsyncFunction bin

sms

symbol type params / value
_NEED Array twilio,telesignsdk
default AsyncFunction options
init AsyncFunction options
send AsyncFunction to, body

speech

symbol type params / value
_NEED Array @google-cloud/speech,@google/genai,OpenAI,whisper-node
default AsyncFunction options
OPENAI_TTS_MAX_LENGTH Number 4096
checkSay AsyncFunction options
checkWhisper AsyncFunction options
init AsyncFunction options
stt AsyncFunction audio, options
sttGoogle AsyncFunction audio, options
sttOpenAI AsyncFunction audio, options
sttWhisper AsyncFunction audio, options
tts AsyncFunction text, options
ttsGoogle AsyncFunction contents, options
ttsOpenAI AsyncFunction input, options
ttsSay AsyncFunction text, options

ssl

symbol type params / value
_NEED Array acme-client
default AsyncFunction domain, options
SSL_RESET String SSL_RESET
createCsr AsyncFunction commonName, forge
ensureCert AsyncFunction domain, challengeCreate, challengeRemove, options
getCert AsyncFunction name
httpsServerOptions AsyncFunction options
init AsyncFunction domain, options
isLocalhost Function host

storage

symbol type params / value
_NEED Array file-type,mime-types,@google-cloud/storage
BASE64 String BASE64
BUFFER String BUFFER
DATAURL String DATAURL
FILE String FILE
MIME_AAC String audio/aac
MIME_AVI String video/avi
MIME_BINARY String application/octet-stream
MIME_FLAC String audio/flac
MIME_FLV String video/x-flv
MIME_GIF String image/gif
MIME_JPEG String image/jpeg
MIME_JSON String application/json
MIME_M4A String audio/m4a
MIME_MOV String video/mov
MIME_MP3 String audio/mp3
MIME_MP4 String video/mp4
MIME_MPEG String video/mpeg
MIME_MPEGA String audio/mpeg
MIME_MPEGPS String video/mpegps
MIME_MPG String video/mpg
MIME_MPGA String audio/mpga
MIME_OGG String audio/ogg
MIME_OPUS String audio/opus
MIME_PCM String audio/pcm
MIME_PCM16 String audio/x-wav
MIME_PDF String application/pdf
MIME_PNG String image/png
MIME_TEXT String text/plain
MIME_TGPP String video/3gpp
MIME_WAV String audio/wav
MIME_WEBM String audio/webm
MIME_WEBP String image/webp
MIME_WMV String video/wmv
STREAM String STREAM
analyzeFile AsyncFunction any, options
assertPath AsyncFunction path, type, mode, msg, code, options
blobToBuffer AsyncFunction
convert AsyncFunction any, options
decodeBase64DataURL Function
deleteFileOnCloud AsyncFunction path, options
deleteOnCloud AsyncFunction path, options
downloadFileFromCloud AsyncFunction path, options
downloadFromCloud AsyncFunction path, options
encodeBase64DataURL AsyncFunction mime, buffer
exists AsyncFunction filename
existsOnCloud AsyncFunction destination, options
formatDataURL Function mt, b64
getConfig AsyncFunction options
getConfigFilename AsyncFunction options
getGcUrlByBucket Function bucke
getIdByGs Function gs
getTempPath Function options
handleError Function err, opts
init AsyncFunction options
isTextFile AsyncFunction file, options
legalFilename Function filename
lsOnCloud AsyncFunction prefix, options
mapFilename Function
mergeFile AsyncFunction data, options
readFile AsyncFunction name, options
readJson AsyncFunction filename, options
sanitizeFilename Function s, r
setConfig AsyncFunction data, options
sliceFile AsyncFunction any, options
touchPath AsyncFunction path, options
tryRm AsyncFunction path, options
unzip AsyncFunction any, options
uploadToCloud AsyncFunction data, options
writeFile AsyncFunction filename, data, options
writeJson AsyncFunction filename, data, options
writeTempFile AsyncFunction data, options
zip AsyncFunction any, options

style

symbol type params / value
default Object {"reset":[],"bold":[],"dim":[],"italic":[],"underline":[],"inverse":[],"hidden":[],"strikethrough":[],"black":[],"red":[],"green":[],"yellow":[],"blue":[],"magenta":[],"cyan":[],"white":[],"gray":[],"grey":[],"brightRed":[],"brightGreen":[],"brightYellow":[],"brightBlue":[],"brightMagenta":[],"brightCyan":[],"brightWhite":[],"bgBlack":[],"bgRed":[],"bgGreen":[],"bgYellow":[],"bgBlue":[],"bgMagenta":[],"bgCyan":[],"bgWhite":[],"bgGray":[],"bgGrey":[],"bgBrightRed":[],"bgBrightGreen":[],"bgBrightYellow":[],"bgBrightBlue":[],"bgBrightMagenta":[],"bgBrightCyan":[],"bgBrightWhite":[],"blackBG":[],"redBG":[],"greenBG":[],"yellowBG":[],"blueBG":[],"magentaBG":[],"cyanBG":[],"whiteBG":[]}

tape

symbol type params / value
default AsyncFunction options
addChatId Function id
end AsyncFunction
init AsyncFunction options
removeChatId Function id

uoid

symbol type params / value
default Function options
bigIntToUuid Function
compactUuid Function str
create Function options
expandUuid Function
fakeUuid Function any
getRfcUrlNamespaceUuid Function url
getTimestampFromUuid Function uuid
getUuidForCurrentHost Function any
rotateUuid Function any, step, options
uuidRegTxt String [0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}
uuidToBigInt Function str

utilitas

symbol type params / value
__ Function url, r
analyzeModule Function obj
arrayEqual Function arrA, arrB
assembleApiUrl Function hst, path, args
assembleBuffer Function
assembleUrl Function url, componens
assertArray Function arr, message, status, opts
assertBuffer Function buffer, message, status, options
assertDate Function time, message, status, options
assertEmail Function email, message, status, options
assertFunction Function fn, message, status, opts
assertModule Function mdl, message, status, opts
assertObject Function obj, message, status, opts
assertSet Function value, message, status, options
assertUrl Function url, message, status, options
assertUuid Function uuid, message, status, options
asyncTimeout AsyncFunction pms, timeout, err
base64Decode Function string, toBuf
base64Encode Function object, isBuf
base64Pack Function object
base64Unpack Function string
basename Function
byteToHexString Function byteArray
call Function f, ...a
checkChance Function
checkInterval Function itv, sed
clarify Function
clone Function any
convertBase Function ipt, from, to
convertFrom16to10 Function ipt
countKeys Function any
deepCleanBigInt Function any, func
distill Function any, strict
ensureArray Function any
ensureDate Function dt, options
ensureInt Function any, options
ensureLines Function any, op
ensureString Function str, options
escapeHtml Function
exclude Function obj, keys
extError Function err, status, opt
extract Function ...path
fileURLToPath Function path, options
fullLengthLog Function string, options
getDateByUnixTimestamp Function timestamp
getFuncParams Function func
getItemFromStringOrArray Function any
getKeyByValue Function object, value
getRandomIndexInArray Function array, options
getRandomInt Function
getRandomItemInArray Function array, options
getShortestInArray Function arr
getTimeIcon Function objTime
getType Function any
getUnixTimestampByDate Function date
hexDecode Function string, toBuf
hexEncode Function object, isBuf
humanReadableBoolean Function ensureString(any
ignoreErrFunc AsyncFunction func, options
inBrowser Function
insensitiveCompare Function strA, strB, options
insensitiveHas Function list, srt, options
is Function type, any
isAscii Function str
isModule Function module, module
isNull Function object, object
isSet Function o, strict
isUndefined Function any, any
lastItem Function array
lineSplit Function string, options
locate AsyncFunction rootPack
log Function content, filename, options
makeStringByLength Function string, length
mapKeys Function any, map, strict, path
mask Function str, options
matchVersion Function curVer, tgtVer
mergeAtoB Function objA, objB, o
need AsyncFunction name, options
newError Function msg, status, opt
once Function fn, context
parseJson Function any, fallback, options
parseVersion Function verstr
prettyJson Function object, opt
purgeEmoji Function any, replace
randomArray Function array
range Function from, to, options
renderBox Function content, options
renderCode Function code, options
renderObject Function obj, options
renderText Function text, options
resolve AsyncFunction async, res
reverseKeyValues Function
rotate Function any, step, opts
shiftTime Function dif, base
split Function str, options
splitArgs Function
supportAnsiColor Function
throwError Function msg, status, opt
timeout Function
toExponential Function x, f
toString Function any, options
trim Function str, opts
tryUntil AsyncFunction fnTry, options
uniqueArray Function array
verifyEmail Function any
verifyPhone Function phone
verifyUrl Function url
verifyUuid Function uuid
voidFunc Function
which AsyncFunction any

vision

symbol type params / value
_NEED Array @google-cloud/vision,office-text-extractor,pdfjs-dist,tesseract.js
annotateImage AsyncFunction image, options
getPdfInfo AsyncFunction file, options
getPdfPage AsyncFunction doc, pageNum
getPdfPages AsyncFunction doc
init AsyncFunction options
ocrImage AsyncFunction image, options
ocrImageGoogle AsyncFunction image, options
ocrImageTesseract AsyncFunction image, options
parseOfficeFile AsyncFunction source, options
read AsyncFunction image, options
readAll AsyncFunction image, options
see AsyncFunction image, options

web

symbol type params / value
_NEED Array jsdom,youtube-transcript,@mozilla/readability
default AsyncFunction url, options
assertYoutubeUrl Function
checkSearch Function
checkVersion AsyncFunction pack
distill AsyncFunction url, options
distillHtml AsyncFunction input, options
distillPage AsyncFunction url, op
distillYoutube AsyncFunction
get AsyncFunction url, options
getCurrentIp AsyncFunction options
getCurrentPosition AsyncFunction
getExchangeRate AsyncFunction to, from, amount
getJson AsyncFunction u, o
getParsedHtml AsyncFunction u, o
getVersionOnNpm AsyncFunction packName
getYoutubeMetadata AsyncFunction
getYoutubeTranscript AsyncFunction
initDistill AsyncFunction options
initSearch AsyncFunction options
isYoutubeUrl Function
search AsyncFunction query, options

About

Just another common utility for JavaScript.

Resources

Readme

License

MIT license
Activity

Stars

4 stars

Watchers

2 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

No packages published

Languages