A collection of utilities used to streamline common programming tasks/useful utilities, to help improve code readability and maintainability.
npm install @lawlzer/utilsA collection of TypeScript utilities designed to streamline common programming tasks. This package provides over 50 well-tested utility functions covering everything from async operations to data manipulation.
These utilities are focused on being useful for [me], so I wouldn't necessarily recommend using them. Feel free to steal any of my utilities or use the package if you'd like, though! It is designed to be simple-to-use :)
- 🚀 50+ Utility Functions - Comprehensive collection for common tasks
- 📦 Tree-shakeable - Import only what you need
- 🔧 TypeScript First - Full TypeScript support with proper types
- 🎯 Zero Dependencies - Minimal footprint (only essential deps)
- ✅ Well Tested - Extensive test coverage
- 🏗️ ESM & CommonJS - Works everywhere
``bash`
npm install @lawlzer/utils
`bash`
yarn add @lawlzer/utils
`bash`
pnpm add @lawlzer/utils
`typescript
import { sleep, retry, deepCompare, clamp, getRandomCharacters, shuffleArray, getUniques } from '@lawlzer/utils';
// Wait for 2 seconds
await sleep('2s'); // Also accepts numbers: sleep(2000)
// Retry an async operation with timeout
const result = await retry(5000, async () => {
return await fetchSomeData();
});
// Deep compare objects
const isEqual = deepCompare({ a: 1, b: { c: 2 } }, { a: 1, b: { c: 2 } }); // true
// Clamp a number between min and max
const clamped = clamp(150, 0, 100); // 100
// Generate random string with letters and numbers
const randomStr = getRandomCharacters(10, { letters: true, numbers: true }); // e.g. "a7Bc9Ef2Gh"
// Shuffle an array
const shuffled = shuffleArray([1, 2, 3, 4, 5]); // e.g. [3, 1, 5, 2, 4]
// Get unique values from array
const unique = getUniques([1, 2, 2, 3, 3, 4]); // [1, 2, 3, 4]
`
`bashBuild for production
npm run build
The build process:
- Generates both ESM (
) and CommonJS (.cjs) outputs (so the code can be used in /any/ codebase?)
- Creates TypeScript declarations (.d.ts) (TypeScript!!!)
- Includes source maps for debugging (can read source code for easier debugging)
- Tree-shakes unused code
- Minifies in production mode$3
`bash
Run unit tests
npm testRun integration tests
npm run test:integration:consumer
`$3
bash
Run all linters
npm run lint:allRun ESLint
npm run lint:eslintRun Prettier
npm run lint:prettier
``Contributions are welcome! Please feel free to submit a Pull Request. Make sure to:
1. Add tests for new utilities
2. Update TypeScript types
3. Add documentation for new functions
Lawlzer
MIT © Kevin Porter