humanity-lost-utils

A comprehensive collection of useful string utility functions for JavaScript and TypeScript applications.

Installation

npm install humanity-lost-utils

Usage

import { camelCase, truncate, isEmail, parseQueryString } from 'humanity-lost-utils';

// Case transformations
camelCase('hello world'); // 'helloWorld'

// String manipulation
truncate('Hello World', 8); // 'Hello...'

// Validation
isEmail('[email protected]'); // true

// Parsing
parseQueryString('?name=John&age=30'); // { name: 'John', age: '30' }

Available Functions

Case Transformations

• camelCase(str: string): string - Convert to camelCase
• pascalCase(str: string): string - Convert to PascalCase
• kebabCase(str: string): string - Convert to kebab-case
• snakeCase(str: string): string - Convert to snake_case
• titleCase(str: string): string - Convert to Title Case

String Manipulation

• truncate(str: string, maxLength: number, ellipsis?: string): string - Truncate string with ellipsis
• padStart(str: string, targetLength: number, padChar?: string): string - Pad start of string
• padEnd(str: string, targetLength: number, padChar?: string): string - Pad end of string
• repeat(str: string, count: number): string - Repeat string n times
• reverse(str: string): string - Reverse a string
• capitalize(str: string): string - Capitalize first letter
• uncapitalize(str: string): string - Uncapitalize first letter

String Validation

• isEmail(str: string): boolean - Check if string is valid email
• isURL(str: string): boolean - Check if string is valid URL
• isAlpha(str: string): boolean - Check if string contains only letters
• isNumeric(str: string): boolean - Check if string contains only numbers
• isAlphanumeric(str: string): boolean - Check if string contains only letters and numbers
• isEmpty(str: string): boolean - Check if string is empty
• isWhitespace(str: string): boolean - Check if string contains only whitespace

String Parsing

• parseQueryString(queryString: string): Record<string, string | string[]> - Parse URL query string
• stringifyQueryString(params: Record<string, any>): string - Convert object to query string
• extractNumbers(str: string): number[] - Extract all numbers from string
• extractEmails(str: string): string[] - Extract all email addresses
• extractURLs(str: string): string[] - Extract all URLs

String Encoding/Decoding

• encodeBase64(str: string): string - Encode string to Base64
• decodeBase64(str: string): string - Decode Base64 string
• escapeHTML(str: string): string - Escape HTML special characters
• unescapeHTML(str: string): string - Unescape HTML entities
• escapeRegExp(str: string): string - Escape RegExp special characters

String Comparison

• levenshteinDistance(str1: string, str2: string): number - Calculate Levenshtein distance
• similarity(str1: string, str2: string): number - Calculate similarity score (0-1)
• fuzzyMatch(str: string, pattern: string, caseSensitive?: boolean): boolean - Fuzzy string matching

Development

# Install dependencies
npm install

# Run tests
npm test

# Build the package
npm run build

# Run tests with coverage
npm run test:coverage

License

MIT # humanity-lost-utils