deverything

Everything you constantly need for development (and probably still copy-pasting from other projects)

The promise:

• ✅ 1 package: say goodbye to lodash, faker, this and that and the other package.
• ⭕ 0 dependencies: keep it simple and lightweight.
• 🏆 Pick the best: the code is minimal and uses the best current practices and is optimized for max performance.
• 👪🏼 Typescript: use it, support it and export it.
• 🌊 Intuitive: favour always the most intuitive API and common usage, never throw errors unless asked.
• 🙈 Semantic: use simple function names that are easy to remember, no complicated options.

Contributions always welcome!

Validators

• isArray()
• isBoolean()
• isBrowser() to detect if you are on the browser
• isClient() to detect if you are ont the browser/client
• isEmail() this is a relaxed check, use your own validation if you need to be strict
• ⭐ isEmpty() to check for empty object, empty array, empty string, null or undefined
  • isEmptyString() trims the string and checks if something is left
  • isEmptyArray()
  • isEmptyObject()
• isFunction()
• isJsDate() if it's a valid javascript's Date
  • isFutureDate()
  • isPastDate()
  • isStringDate() also checks if the string passed is a valid date
• isKey() is a real key of an object
• isLastIndex() is the index is the last item of array
• isNotEmptyString() must have some text, checks for spaces-only
• isNumber() if the arg is number, and also usable (no infinity)
  • isInt()
  • isEven()
  • isOdd()
  • isPositiveInt()
  • isNegativeInt()
• isNumeric()
• ⭐ isObject() if it's a js plain Object
• isPromise()
• isPWA()
• isReactElement()
• isRegExp()
• ⭐ isSame() Compare if dates, functions, arrays, objects or anything else are the same
• isServer() if you are on the server
• isString()
• isURL()
• isUUID()

Math

• average() numbers of an array
• max() numbers of an array
• min() numbers of an array
• multiply() numbers of an array
• sum() numbers an array

Helpers

• array() create an arbitrary array based on a function
  • arrayDiff()
  • arrayIntersection()
• capitalize() word => Word
• cleanSpaces() trims and turns double spaces into single space
• clamp() clamp number in a range
• first() get the first element of an array
• firstKey()
• firstValue()
• getKeys() get the keys of an object, includes symbols
• getUrlSearchParam()
• getUrlSearchParams()
• incrementalId() autoincremental SQL-like, process-unique numeric id
• keysLength()
• last() get the last element of an array
• lastIndex() get the last index of an array
• ⭐ merge() deep merge objects
• moveToFirst() move array element to first
• moveToIndex() move array element to desired index
• moveToLast() move array element to last
• normalizeNumber() normalizes between 0 and 1
• objectDiff()
• ⭐ parseDate() pass anything Date-Like, and get a JS Date back
• pretty() stringify anything, without breaking on circular dependencies
• promiseWithTimeout() takes a promise, a timeoutMs, and an option error as arguments. Returns a new Promise that either resolves with the value of the input promise or rejects with the provided error or a default error message if the input promise does not resolve or reject within the specified timeoutMs.
• scrambleText() replace alpha chars with random chars
• seriesAll() executes promises in series, and returns all results
• setUrlSearchParams()
• shuffle() shuffles elements in an array
• sleep() promise-based sleep
• toggleArrayValue() remove/add value in array
• truncate() truncate text, does not break emojis
• uniqueValues() gets unique values in an array

Formatters

• formatNumber() 1000 => "1,000" or "1K"
• stringToUnicode() "hello" => "\u0068\u0065\u006c\u006c\u006f"

Random data generators

These functions are optimized for low entropy random data generation useful for Unit Testing, Storybook, Pass real validations, Reverse hacking, Penetration testing...

• randomAddress()
• randomAlphaNumericCode()
• ⭐ randomArrayItem() now supporting non-uniform distribution
• randomBankAccount()
• randomBool()
• randomChar()
• randomCompany()
• ⭐ randomCoords()
  • randomLat()
  • randomLng()
• randomDate() a safe range in decade
  • randomMaxDate() a range in the Max dates allowed by JS
  • randomFutureDate()
  • randomPastDate()
  • randomDateRange() => { startDate, endDate }
• randomEmail()
• randomEmoji()
• randomEnumKey() enum FRUIT { APPLE, PEAR } => APPLE
• randomEnumValue() enum FRUIT { APPLE = 1, PEAR = 3 } => 3
• randomFile()
• randomFloat()
• randomHandle() useful for social identifiers, or slugs
• randomHexColor()
• randomHexValue()
• randomHtmlColorName()
• randomIBAN()
• randomInt()
  • randomPositiveInt() > 0
  • randomNegativeInt() < 0
  • randomMaxSafeInt() Range of very BIG integers, which are still safe to use tho
  • randomMaxInt() Range within the Maximum integer supported by js
• randomIP()
• randomName()
  • randomFirstName()
  • randomLastName()
  • randomFullName()
• randomNumericCode()
• randomParagraph()
• randomPassword()
• randomPath() /path/to/something
• randomPhoneNumber()
• randomString()
• randomUUID() lightweight uuid generation, passing UUID validation
• randomWord()

Checks

Checks are functions that throw an error, if the validation fails

• ⭐ checkEnvVars() Make sure env vars are set per-environment

TypeScript Helpers & Generics

• Coords
• DateLike
• Dimensions
• Maybe<>
  • MaybePromise<>
  • MaybePromiseOrValue<>
  • MaybePromiseOrValueArray<>
• NonUndefined
• ObjectKey<>
• ObjectKeys<>
• ObjectValue<>
• ObjectValues<>
• ObjectEntries<>
• ⭐ PlainObject use this instead of Record<,> or extends object, also makes sure it's not an array
• Point
• PrismaSelect<>
• HashMap<>
• HashMapKey
• NumberMap
• StringMap
• BoolMap
• TrueMap

Development

After changes, run

pnpm bump

To bump the version. CI will take care of publishing the package when merged.

Changelog

0.41.0

Minor Changes

• pick object and array include