README.md

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

The promise:

• ✅ 1 package: say goodbye to lodash, faker, and the other package you don't recall the name of.
• ⭕ 0 dependencies: keep it simple and lightweight.
• 🏆 Pick the best: the code is minimal and uses the best practices for max performance.
• 🤖 AI: Functions are reviewed by AI to make sure all corner cases are covered.
• 👪🏼 Typescript: use it, support it and export it.
• 🌊 Intuitive: favour always the most intuitive API and common usage, never throw error unless asked to.
• 🙈 Semantic: use simple function names that are easy to remember, no complicated options.

Contributions always welcome!

Validators

• isArray()
• isArrayIncluded()
• isBoolean()
• isBrowser() to detect if you are on the browser
• isBuffer() if it's a buffer
• isClient() same as isBrowser
• 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() checks if the array has no items
  • isEmptyObject() checks if the object has no keys
• isFile() if it's a file
• isFunction()
• isJsDate() if it's a valid javascript's Date
  • isBetweenDates() check if date falls between two other dates (left inclusive: includes start, excludes end)
  • isInDateRange() alias of isBetweenDates()
  • isFutureDate() check if date is in the future, optionally against a reference date
  • isPastDate() check if date is in the past, optionally against a reference date
  • isSameUTCDay() same calendar day in UTC
  • 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() if it's an integer
  • isEven()
  • isOdd()
  • isPositiveInt()
  • isNegativeInt()
• isBigInt() if the arg is a bigint
• isBigIntString() if the string is a valid bigint literal
• isOutsideInt4() if a number is outside PostgreSQL int4 range
• isNumeric() if string is representing a number
• isNumericId() if it's a valid numeric ID
• ⭐ isObject() if it's a js plain Object
• isPromise() if it's a promise
• isPWA() to detect if you are on a PWA
• isReactElement() if it's a valid React Element
• isRegExp() if it's a valid RegExp
• ⭐ isSame() Compare if dates, functions, arrays, objects or anything else are the same
• isSequence() if the array is a perfect sequence
• isServer() if you are on the server
• isSpacedString() if string contains spaces
• isString()
• isURL()
• isUUID() if it's a valid UUID
• isValue() if it's a defined value (not null, undefined, or empty string)

Dates

• getDateRangeSeries() generate a series of dates within a range
• getDateSeriesRange() get the smallest and biggest dates from an array of dates
• groupByDateBucket() group items into date buckets based on their dates and specified time intervals
• isOver18() check if someone is over 18 years old
• startOfDay() get the start of a specific day
• startOfNextMonth()
• startOfNextWeek()
• startOfThisWeek()
• startOfToday()
• startOfTomorrow()
• startOfYesterday()
• startOfUTCDay() get the start of a specific day in UTC
• startOfUTCTomorrow() get the start of tomorrow in UTC

Math

• average()
• countDecimals() count the number of decimal places in a number
• isBetween()
• isOutside()
• isStrictlyBetween()
• max()
• min()
• multiply()
• normaliseArray()
• normaliseNumber()
• percentageChange()
• sum()

Helpers

• array() create an arbitrary array based on a function
  • arrayDiff() get the difference of two arrays
  • arrayIntersection() get the intersection of two arrays
• capitalize() word => Word
• chunkArray() split array into chunks
• chunkText() split text into chunks of a given character size, optionally preserving sentence boundaries via Intl.Segmenter
• chunkedAll() process all items in chunks
• chunkedAsync() process async operations in chunks
• chunkedDynamic() process with dynamic chunk sizes
• clamp() clamp number in a range
• cleanSpaces() trims and turns double spaces into single space
• copyToClipboard() copy a string to the system clipboard (browser only)
• cyclicalItem() get item from array with cyclical indexing
• dir() get directory listing
• enumKeys() enum FRUIT { APPLE, PEAR } => ["APPLE", "PEAR"]
• enumValues() enum FRUIT { APPLE = 1, PEAR = 3 } => [1, 3]
• filterAlphanumeric() remove non-alphanumeric characters
• first() get the first element of an array
• firstKey() get the first key of an object
• firstValue() get the first value of an object
• getCookieByName() get cookie value by name
• getKeys() get all keys from an object
• getUrlSearchParam() get URL search param
• getUrlSearchParams() get URL search params
• groupByKey()
• incrementalId() autoincremental SQL-like, process-unique numeric id
• keysLength() get the length of keys in an object
• last() get the last element of an array
• lastIndex() get the last index of an array
• mapByKey()
• ⭐ merge() deep merge objects
• mergeArrays() merge multiple arrays
• 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
• normalizeString() trim, strip diacritics (Unicode NFD), lowercase
• noop() no-op function
• omit() omit properties from object
• ⭐ parseDate() pass anything Date-Like, and get a JS Date back
• parseArray() split a string into parsed primitives (comma-separated by default)
• parsePrimitive() coerce a string to boolean, number, null, undefined, or trimmed string
• pickObjectKeys() pick specific keys from object
• pickObjectValues() pick specific values from object
• pluck() make array of value from object keys
• prismaDateRange() { gte, lt } window from a start/end range for Prisma filters
• 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.
• removeUndefinedValues() remove undefined values from object
• scrambleText() replace alpha chars with random chars
• serialize() serialize object to string
• seriesAsync() executes promises in series, and returns all results
• setObjectPath() set a value in an object by path
• setUrlSearchParams() set URL search params
• formatTrpcInputQueryString() serialize a tRPC procedure input to URLSearchParams
• shuffle() shuffles elements in an array
• singleton() lazily-initialized singleton from a factory (sync or async)
• sleep() promise-based sleep
• stringify() stringify anything, without breaking on circular dependencies
• toggleArrayValue() remove/add value in array
• truncate() truncate text, does not break emojis
• uniqueValues() gets unique values in an array

Formatters

• formatCamelCase() "hello-world" => "helloWorld"
• formatCookies() { cookie1: "1", cookie2: "2" } => "cookie1=1; cookie2=2"
• formatCount() "#items: 3, #users: 5"
• formatDateRange() "2026-02-09T00:00... ⮕ 2026-02-10T00:00..."
• formatIndexProgress() => "[2/10]"
• formatProgress() progress string with optional id prefix
• formatNumber() 1000 => "1,000" or "1K" or 0.112 => "11.2%"
• formatPascalCase() "hello-world" => "HelloWorld"
• formatPercentage() 0.11 => "11%"
• formatPercentageNumber() numeric percentage (e.g. 0.123 => 12.35) before formatting as string
• stringToCSSUnicode() "hello" => "\000068\000065\00006c\00006c\00006f" use this for CSS
• 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()
• randomArray()
• ⭐ 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()
• randomEmptyValue() random empty value (null, undefined, empty string)
• randomEnumKey() enum FRUIT { APPLE, PEAR } => APPLE
• randomEnumValue() enum FRUIT { APPLE = 1, PEAR = 3 } => 3
• randomFile()
• randomFloat()
• randomFormattedPercentage() random percentage string for tests
• randomObject()
• randomObjectKey() get a random key from an object
• randomObjectValue() get a random value from an object
• randomHandle() useful for social identifiers, or slugs
• randomHexColor()
• randomHexValue()
• randomHtmlColorName()
• randomIBAN()
• randomInt()
  • randomBigInt()
  • randomMaxInt() Range within the Maximum integer supported by js
  • randomMaxSafeInt() Range of very BIG integers, which are still safe to use tho
  • randomNegativeInt() < 0
  • randomPositiveInt() > 0
• randomIP()
• randomName()
  • randomFirstName()
  • randomLastName()
  • randomFullName()
• randomNumericCode()
• randomObject()
• randomParagraph()
• randomPassword()
• randomPath() /path/to/something
• randomPhoneNumber()
• randomString()
• randomSymbol()
• randomUUID() lightweight uuid generation, passing UUID validation
• randomValue()
• randomWord()
• randomNoun()
• randomVerb()

TypeScript Helpers & Generics

• Coords
• DateLike
• Defined<T>
• Dimensions
• Function
• HashMap<>
  • BoolMap
  • NumberMap
  • StringMap
  • TrueMap
• Key
• Matrix
• Maybe<>
  • MaybePromise<>
  • MaybePromiseOrValue<>
  • MaybePromiseOrValueArray<>
• NonUndefined
• Object
• PickDefined<T, K>
• PickRequired<T, K>
• PlainKey
• Point
• PrismaSelect
• Serialized
• Tuple

Development

After changes, run

pnpm release

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