deverything

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!

$3

- 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)
- 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
- 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()
- 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)

$3

- 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()
- startOfUTCDay() get the start of a specific day in UTC
- startOfUTCTomorrow() get the start of tomorrow in UTC

$3

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

$3

- 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
- 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
- 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
- objectDiff() get the difference between two objects
- omit() omit properties from object
- ⭐ parseDate() pass anything Date-Like, and get a JS Date back
- pickObjectKeys() pick specific keys from object
- pickObjectValues() pick specific values from object
- pluck() make array of value from object keys
- 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
- shuffle() shuffles elements in an array
- 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

$3

- formatCamelCase()
- formatCookies() { cookie1: "1", cookie2: "2" } => "cookie1=1; cookie2=2"
- formatNumber() 1000 => "1,000" or "1K" or 0.112 => "11.2%"
- formatPercentage() 0.11 => "11%"
- formatIndexProgress() => "[2/10]"
- stringToCSSUnicode() "hello" => "\000068\000065\00006c\00006c\00006f" use this for CSS
- stringToUnicode() "hello" => "\u0068\u0065\u006c\u006c\u006f"

$3

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()
- 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()

$3

- Coords
- DateLike
- Defined
- Dimensions
- Function
- HashMap<>
- BoolMap
- NumberMap
- StringMap
- TrueMap
- Key
- Matrix
- Maybe<>
- MaybePromise<>
- MaybePromiseOrValue<>
- MaybePromiseOrValueArray<>
- NonUndefined
- Object
- PickDefined
- PickRequired
- 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.