
Security News
Open Source CAI Framework Handles Pen Testing Tasks up to 3,600× Faster Than Humans
CAI is a new open source AI framework that automates penetration testing tasks like scanning and exploitation up to 3,600× faster than humans.
utils-stuff
Advanced tools
v5.0.0
This is a package i made for myself but can surely be helpful to others, feel free to contribute if you like it.
npm install utils-stuff
You can import the class GenericUtils and the function autobind
(it is this exact code).
GenericUtils has some generic utils and a logger that better format the logs (with color too if you want).
autobind lets you bind all your class methods to its original instance (allowing both override and correct heritage)
At the moment, the interface of the class is as it follows:
export interface IGenericUtils {
date: (date?:string, format?:string, locale?:DateLocales) => string
resOk: <T>(response:T) => CatchedResponse<T>
resError:(err:any) => CatchedResponse<any>
getErrorMessage: (err:any) => string;
catchReturn<T>(cb: () => Promise<T>, errorCb?:() => void): Promise<CatchedResponse<T>>;
catchReturn<T>(cb: () => T, errorCb?:() => void): CatchedResponse<T>;
isAxiosOk: (res:{ status:number, [Key:string]: GenericType} /* pass an AxiosResponse */) => boolean;
isStringValid: (str?:string) => boolean;
arrayDiff: <T = string | number>(originalArray:T[], currentArray:T[]) => ArrayDifference<T>;
isNumeric: (str:string) => boolean;
capitalize: (str:string, all?:boolean) => string;
fromLetterToNumber: (char:string) => number;
isEmptyObject: (obj:Record<string, any>) => boolean;
getRandomColor: () => string;
flattenObject: (obj:Record<string, any>) => Record<string, any>;
sortObjects: <T = any>(arr:Array<Record<string, T>>, key:string | number) => Array<Record<string, T>>;
keepTrying: <T = void>(finalError:string, methods: Array<() => Promise<T>>) => Promise<T>;
sleep: (ms:number) => Promise<void>
random: <T = any>(arr:Array<T>) => T
fromStringToColor: (input:string, brightness:number) => string
}
import { GenericUtils } from "utils-stuff"
The constructor of GenericUtils follows this interface:
protected readonly dateLocale:DateLocales = "en-US";
protected readonly isNumericRegex:RegExp = /^-?\d+(\.\d+)?$/
constructor(constructor?:GenericUtilsConstructor)
export interface GenericUtilsConstructor {
locale?:DateLocales,
numericValidation?:RegExp,
defaultDateFormat?:string // for date parsing, default is "YYYY-MM-DD hh:mm:ss"
}
I suggest you to create a generic utils class extending mine if you want a solid way to store all your utils functions or whatever.
import { GenericUtils } from "utils-stuff";
// Create a class extending mine if you want to store other utils
class MyGenericUtils extends GenericUtils {
myCustomMethod = (name:string):string => {
return `Hello ${name}`
}
}
const mgu = new MyGenericUtils(/*{ locale: "it-IT" }*/)
// Or simply export mine directly
const gu = new GenericUtils(/*{ locale: "it-IT" }*/)
Export it however you want but i raccomand you to init a single object and use it through all the project.
export default new GenericUtils(/*{ locale: "it-IT" }*/)
// Or destruct the single functions
const { resOk, resError, isStringValid } = new GenericUtils();
export { resOk, resError, isStringValid }
The related methods are really simple and can be easily read in the realted /package/src/GenericUtils.ts
file in this repo.
The only methods not-so-easy to read are the date
method and the isNumeric
RegExp wich will return true if the passed string is any int, float, double or negative number. You can override the default regex in the constructor.
date: (date?:string|number|Date|null, format?:string, locale?:DateLocales) => string
This method takes a string or number that you would normally pass to a Date()
constructor and an additional string param that let you format the date object into the string you want.
If no locale parameter is passed, it will be used the one specified in the constructor of the class GenericUtils({ locale:"..." })
.
If no locale is passed in the class constructor it will be used "en-US"
See the related locale options in
./package/types/dater.types.ts
export type FormatUnit =
| "YYYY" // Year 4 digits (1996)
| "YYY" // Year 3 digits (996)
| "YY" // Year 2 digits (96)
| "M" // Month of year (1-12)
| "MM" // Month of year (01-12)
| "MMM" // Month of year (May) (set locale option)
| "D" // Day of month (1-31)
| "DD" // Day of month (01-31)
| "DDD" // Day of month (Monday-Sunday) (set locale option)
| "H" // Hour of day (0-23:59)
| "HH" // Hour of day (00-23:59)
| "h" // Hour of day (0-11:59)
| "hh" // Hour of day (00-11:59)
| "tt" // AM or PM (AM - PM)
| "m" // Minute (0-59)
| "mm" // Minute (00-59)
| "s" // Second (0-59)
| "ss" // Second (00-59)
| "f" // Milliseconds (0000-999)
// --- Null or undefined is gonna be the current time
gu.date()
gu.date(null, "DDD DD, MMM YYYY")
gu.date(null, "DDD DD, MMM YYYY", "ru-RU")
gu.date(null, "hh:mm:ss:f")
gu.date(null, "MMM DD h.tt")
gu.date(1221732346340, "YYYY-MM-DD HH:mm:ss")
gu.date(new Date("2023/01/01"), "DD/MM/YY h:mm tt")
gu.date('2023-11-12T19:37:14.157Z', "DDD DD-MM-YYYY, h:mm tt")
keepTrying: <T = void>(finalError:string, methods: Array<() => Promise<T>>) => Promise<T>;
This methods helps use assign a variable by trying/catching multiple functions that return the same value type (you can set two datatypes in | with typescript). It takes two parameters:
If everything will go wrong it'll throw an error with your string as a message.
A list of methods that possibly (encouraged) return the same datatype.
This is a random example
let compressedImageBytes = await keepTrying<Buffer>(`IMAGE == ${imagePath} == IS NOT JPG OR PNG`, [
async () => await sharp(imagePath).jpeg({ quality:this.jpgCompression }).toBuffer(),
async () => await sharp(imagePath).png({ compressionLevel: this.pngCompression }).toBuffer()
]);
FAQs
Generic utils, both for server or client uses
The npm package utils-stuff receives a total of 3 weekly downloads. As such, utils-stuff popularity was classified as not popular.
We found that utils-stuff demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
CAI is a new open source AI framework that automates penetration testing tasks like scanning and exploitation up to 3,600× faster than humans.
Security News
Deno 2.4 brings back bundling, improves dependency updates and telemetry, and makes the runtime more practical for real-world JavaScript projects.
Security News
CVEForecast.org uses machine learning to project a record-breaking surge in vulnerability disclosures in 2025.