@talkohavy/lodash

Lightweight, fast, useful functions that every Node.js project needs.

Features

This package exposes the following functions:

• addItemToList
• areObjectsEqual
• decodeBase64
• deepMerge
• encodeBase64
• getArrMaxValue
• isNullish
• isObjEmpty
• isObject
• removeItemFromList
• removeItemFromListByIndex
• replaceItemOnListWith
• times
• wrapInDebounce
• wrapInThrottle

Installation

Using npm:

npm install @talkohavy/lodash

Using pnpm:

pnpm add @talkohavy/lodash

Using yarn:

yarn add @talkohavy/lodash

How to use

Here's a code example of how to use the package:

import { isObject } from '@talkohavy/lodash';

const obj = {};

console.log(isObject(obj));

All functions

addItemToList

import { addItemToList } from '@talkohavy/lodash';

const oldArray = ['danny', 'lisa'];
const newItem = 'john';

const newArr = addItemToList({ list: oldArr, newItem });

console.log(newArr); // <--- ['danny', 'lisa', john]

areObjectsEqual

import { areObjectsEqual } from '@talkohavy/lodash';

const obj1 = { name: 'John', foo: 'bar' };
const obj2 = { foo: 'bar', name: 'John' };

const areEqual = areObjectsEqual(obj1, obj2);

console.log(areEqual); // <--- true

isEmpty

import { isEmpty } from '@talkohavy/lodash';

const obj1 = {};
const isItEmpty1 = isEmpty(obj1);
console.log(isItEmpty1); // <--- true

const obj2 = { name: 'John' };
const isItEmpty2 = isEmpty(obj2);
console.log(isItEmpty2); // <--- false

const arr1 = [];
const isItReally3 = isObject(arr1);
console.log(isItReally3); // <--- true

const arr2 = ['john'];
const isItReally4 = isObject(arr2);
console.log(isItReally4); // <--- true

isNullish

import { isNullish } from '@talkohavy/lodash';

const value1 = null;
const isItEmpty1 = isNullish(value1);
console.log(isItEmpty1); // <--- true

const value2 = undefined;
const isItEmpty2 = isNullish(value2);
console.log(isItEmpty2); // <--- true

const value3 = 'this could be string number boolean array function or an object';
const isItEmpty3 = isNullish(value3);
console.log(isItEmpty3); // <--- false

isObject

import { isObject } from '@talkohavy/lodash';

const obj = {};
const isItReally1 = isObject(obj);
console.log(isItReally1); // <--- true

const arr = [];
const isItReally2 = isObject(arr);
console.log(isItReally2); // <--- true

const value1 = null;
const isItReally3 = isObject(value1);
console.log(isItReally3); // <--- false

const value2 = 'i am a string';
const isItReally4 = isObject(value2);
console.log(isItReally4); // <--- false

Module Formats

This package supports both CommonJS and ESM imports:

// ESM
import { isEmpty } from '@talkohavy/lodash';

// CommonJS
const { isEmpty } = require('@talkohavy/lodash');

Notes for Contributors

• When adding imports in source files, use the .js extension (e.g., import { foo } from './foo.js') even though the actual file has a .ts extension. This is required for ESM compatibility.
• Test files import source files with .ts extension directly.

License

MIT