@ooneex/utils 0.1.0 → 0.2.0

package/README.md

@@ -1,90 +1,90 @@
 # @ooneex/utils
 
-A comprehensive TypeScript/JavaScript utility library providing essential helper functions for string manipulation, time formatting, data parsing, and more. This package offers a collection of lightweight, type-safe utilities designed to streamline common development tasks across web applications.
+General-purpose utility functions including unique ID generation with nanoid, type guards, and common helper methods.
 
 ![Browser](https://img.shields.io/badge/Browser-Compatible-green?style=flat-square&logo=googlechrome)
 ![Bun](https://img.shields.io/badge/Bun-Compatible-orange?style=flat-square&logo=bun)
-![Deno](https://img.shields.io/badge/Deno-Compatible-blue?style=flat-square&logo=deno)
-![Node.js](https://img.shields.io/badge/Node.js-Compatible-green?style=flat-square&logo=node.js)
 ![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square&logo=typescript)
 ![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=flat-square)
 
 ## Features
 
-✅ **String Manipulation** - Case conversion utilities (camelCase, PascalCase, kebab-case)
+✅ **ID Generation** - Generate unique IDs using nanoid with configurable length
 
-✅ **Time Formatting** - Convert seconds/milliseconds to human-readable formats
+✅ **String Case Conversion** - Convert between camelCase, kebab-case, snake_case, and PascalCase
 
-✅ **Data Parsing** - Intelligent string parsing with type inference
+✅ **String Utilities** - `trim`, `splitToWords`, `capitalizeWord` for common string operations
 
-✅ **Type-Safe** - Full TypeScript support with proper type definitions
+✅ **Value Parsing** - `parseString` to convert string values to boolean, number, or string types
 
-✅ **Lightweight** - Minimal dependencies and optimized bundle size
+✅ **Time Formatting** - `secondsToHMS`, `secondsToMS`, and `millisecondsToHMS` for duration display
 
-✅ **Cross-Platform** - Works in Browser, Node.js, Bun, and Deno
+✅ **Number Formatting** - `formatRelativeNumber` for human-readable numbers with K, M, B suffixes
 
-✅ **Environment Variables** - Parse and transform environment variables
+✅ **Data Conversion** - `dataURLtoFile` to convert data URLs to File objects
 
-✅ **File Utilities** - Convert data URLs to File objects
+✅ **Environment Variables** - `parseEnvVars` to parse .env file content into key-value pairs
 
-✅ **Random Generation** - Generate random IDs and strings
+✅ **Async Utilities** - `sleep` function for async/await workflows
 
-✅ **Number Formatting** - Format numbers with locale-aware compact notation
-
-✅ **Zero Dependencies** - Only one small dependency (nanoid) for random generation
+✅ **Zero Config** - Simple, pure functions with no configuration needed
 
 ## Installation
 
-### Bun
 ```bash
 bun add @ooneex/utils
 ```
 
-### pnpm
-```bash
-pnpm add @ooneex/utils
-```
+## Usage
 
-### Yarn
-```bash
-yarn add @ooneex/utils
-```
+### Unique ID Generation
 
-### npm
-```bash
-npm install @ooneex/utils
-```
+```typescript
+import { random } from '@ooneex/utils';
 
-## Usage
+// Generate a unique ID (default length: 21)
+const id = random();
+console.log(id); // "V1StGXR8_Z5jdHi6B-myT"
+
+// Generate with custom length
+const shortId = random(10);
+console.log(shortId); // "V1StGXR8_Z"
+```
 
-### String Manipulation
+### String Case Conversion
 
 ```typescript
 import {
-  capitalizeWord,
   toCamelCase,
-  toPascalCase,
   toKebabCase,
-  splitToWords,
-  trim
+  toSnakeCase,
+  toPascalCase,
+  capitalizeWord
 } from '@ooneex/utils';
 
-// Capitalize words
-console.log(capitalizeWord('hello')); // 'Hello'
-console.log(capitalizeWord('WORLD')); // 'World'
-
-// Case conversions
-console.log(toCamelCase('hello world')); // 'helloWorld'
-console.log(toPascalCase('hello world')); // 'HelloWorld'
-console.log(toKebabCase('Hello World')); // 'hello-world'
-
-// Split strings to words
-console.log(splitToWords('HelloWorldExample')); // ['Hello', 'World', 'Example']
-console.log(splitToWords('hello-world_example')); // ['hello', 'world', 'example']
-
-// Advanced trimming
-console.log(trim('...hello...', '\\.')); // 'hello'
-console.log(trim('[test]', '\\[|\\]')); // 'test'
+// Convert to camelCase
+toCamelCase('hello world');        // "helloWorld"
+toCamelCase('hello-world');        // "helloWorld"
+toCamelCase('hello_world');        // "helloWorld"
+
+// Convert to kebab-case
+toKebabCase('helloWorld');         // "hello-world"
+toKebabCase('HelloWorld');         // "hello-world"
+toKebabCase('hello_world');        // "hello-world"
+
+// Convert to snake_case
+toSnakeCase('helloWorld');         // "hello_world"
+toSnakeCase('HelloWorld');         // "hello_world"
+toSnakeCase('hello-world');        // "hello_world"
+
+// Convert to PascalCase
+toPascalCase('hello world');       // "HelloWorld"
+toPascalCase('hello-world');       // "HelloWorld"
+toPascalCase('hello_world');       // "HelloWorld"
+
+// Capitalize first letter
+capitalizeWord('hello');           // "Hello"
+capitalizeWord('hello world');     // "Hello world"
 ```
 
 ### Time Formatting
@@ -93,555 +93,391 @@ console.log(trim('[test]', '\\[|\\]')); // 'test'
 import {
   secondsToHMS,
   secondsToMS,
-  millisecondsToHMS,
-  sleep
+  millisecondsToHMS
 } from '@ooneex/utils';
 
-// Convert seconds to time formats
-console.log(secondsToHMS(3661)); // '1:01:01'
-console.log(secondsToHMS(125)); // '2:05'
-console.log(secondsToHMS(45)); // '45'
+// Seconds to Hours:Minutes:Seconds
+secondsToHMS(3661);     // "1:01:01"
+secondsToHMS(125);      // "0:02:05"
+
+// Seconds to Minutes:Seconds
+secondsToMS(125);       // "2:05"
+secondsToMS(65);        // "1:05"
+
+// Milliseconds to Hours:Minutes:Seconds
+millisecondsToHMS(3661000);  // "1:01:01"
+millisecondsToHMS(125000);   // "0:02:05"
+```
 
-console.log(secondsToMS(125)); // '2:05'
-console.log(secondsToMS(45)); // '0:45'
+### Number Formatting
 
-// Convert milliseconds to time format
-console.log(millisecondsToHMS(3661000)); // '1:01:01'
-console.log(millisecondsToHMS(125000)); // '2:05'
+```typescript
+import { formatRelativeNumber } from '@ooneex/utils';
 
-// Async sleep utility
-await sleep(1000); // Wait 1 second
+// Format large numbers with suffixes
+formatRelativeNumber(1000);        // "1K"
+formatRelativeNumber(1500);        // "1.5K"
+formatRelativeNumber(1000000);     // "1M"
+formatRelativeNumber(1500000);     // "1.5M"
+formatRelativeNumber(1000000000);  // "1B"
+formatRelativeNumber(999);         // "999"
 ```
 
-### Data Parsing
+### Async Sleep
 
 ```typescript
-import { parseString, parseEnvVars } from '@ooneex/utils';
-
-// Intelligent string parsing with type inference
-console.log(parseString('123')); // 123 (number)
-console.log(parseString('12.34')); // 12.34 (number)
-console.log(parseString('true')); // true (boolean)
-console.log(parseString('false')); // false (boolean)
-console.log(parseString('null')); // null
-console.log(parseString('[1,2,3]')); // [1, 2, 3] (array)
-console.log(parseString('{"name":"John"}')); // {name: "John"} (object)
-console.log(parseString('1e5')); // 100000 (scientific notation)
-console.log(parseString('hello')); // 'hello' (string fallback)
-
-// Parse environment variables
-const envs = {
-  'API_PORT': '3000',
-  'DEBUG_MODE': 'true',
-  'ALLOWED_HOSTS': '["localhost", "127.0.0.1"]'
-};
-
-const parsed = parseEnvVars(envs);
-// Result: { apiPort: 3000, debugMode: true, allowedHosts: ['localhost', '127.0.0.1'] }
+import { sleep } from '@ooneex/utils';
+
+async function example() {
+  console.log('Starting...');
+  
+  // Wait for 2 seconds
+  await sleep(2000);
+  
+  console.log('2 seconds later...');
+}
 ```
 
-### Number Formatting
+### String Utilities
 
 ```typescript
-import { formatRelativeNumber } from '@ooneex/utils';
+import { trim, splitToWords, parseString } from '@ooneex/utils';
 
-// Format numbers with compact notation
-console.log(formatRelativeNumber(1000)); // '1K'
-console.log(formatRelativeNumber(1500)); // '1.5K'
-console.log(formatRelativeNumber(1000000)); // '1M'
-console.log(formatRelativeNumber(2500000)); // '2.5M'
-console.log(formatRelativeNumber(1000000000)); // '1B'
-
-// Custom precision
-console.log(formatRelativeNumber(1234, { precision: 2 })); // '1.23K'
-console.log(formatRelativeNumber(1234, { precision: 0 })); // '1K'
-
-// Different locales
-console.log(formatRelativeNumber(1500, { lang: 'de-DE' })); // '1500'
-console.log(formatRelativeNumber(1500000, { lang: 'de-DE' })); // '1,5 Mio.'
-console.log(formatRelativeNumber(1500, { lang: 'fr-FR' })); // '1,5 k'
+// Trim whitespace and normalize
+trim('  hello   world  ');  // "hello world"
+
+// Split string into words
+splitToWords('helloWorld');    // ["hello", "World"]
+splitToWords('hello-world');   // ["hello", "world"]
+splitToWords('hello_world');   // ["hello", "world"]
+
+// Parse string values
+parseString('true');    // true (boolean)
+parseString('false');   // false (boolean)
+parseString('123');     // 123 (number)
+parseString('hello');   // "hello" (string)
 ```
 
-### File Utilities
+### Data URL Conversion
 
 ```typescript
 import { dataURLtoFile } from '@ooneex/utils';
 
-// Convert data URL to File object
-const dataUrl = 'data:text/plain;base64,SGVsbG8gV29ybGQ=';
-const file = dataURLtoFile(dataUrl, 'hello.txt');
+// Convert a data URL to a File object
+const dataUrl = 'data:image/png;base64,iVBORw0KGgo...';
+const file = dataURLtoFile(dataUrl, 'image.png');
 
-console.log(file.name); // 'hello.txt'
-console.log(file.type); // 'text/plain'
-console.log(file.size); // 11
+console.log(file.name); // "image.png"
+console.log(file.type); // "image/png"
 ```
 
-### Random Generation
+### Environment Variable Parsing
 
 ```typescript
-import { random } from '@ooneex/utils';
-
-// Generate random hex strings
-console.log(random.nanoid()); // 'a1b2c3d4e5' (10 chars default)
-console.log(random.nanoid(8)); // 'f6e5d4c3' (8 chars)
+import { parseEnvVars } from '@ooneex/utils';
 
-// Generate numeric strings
-console.log(random.stringInt()); // '1234567890' (10 digits default)
-console.log(random.stringInt(6)); // '123456' (6 digits)
+// Parse environment variable content
+const envContent = `
+DATABASE_URL=postgresql://localhost:5432/mydb
+API_KEY=secret-key-123
+DEBUG=true
+PORT=3000
+`;
 
-// Create a factory function
-const generateId = random.nanoidFactory(12);
-console.log(generateId()); // 12-character hex string
-console.log(generateId(8)); // 8-character hex string (overrides factory size)
+const vars = parseEnvVars(envContent);
+// {
+//   DATABASE_URL: 'postgresql://localhost:5432/mydb',
+//   API_KEY: 'secret-key-123',
+//   DEBUG: 'true',
+//   PORT: '3000'
+// }
 ```
 
 ## API Reference
 
-### String Utilities
+### Functions
 
-#### `capitalizeWord(word: string): string`
-Capitalizes the first letter and lowercases the rest.
+#### `random(size?: number): string`
+
+Generates a unique ID using nanoid.
 
 **Parameters:**
-- `word` - The word to capitalize
+- `size` - Optional length of the ID (default: 21)
 
-**Returns:** Capitalized word
+**Returns:** A unique string ID
 
 **Example:**
 ```typescript
-capitalizeWord('hello'); // 'Hello'
-capitalizeWord('WORLD'); // 'World'
-capitalizeWord(''); // ''
+const id = random();      // "V1StGXR8_Z5jdHi6B-myT"
+const short = random(8);  // "V1StGXR8"
 ```
 
-#### `toCamelCase(input: string): string`
-Converts string to camelCase.
+---
+
+#### `toCamelCase(str: string): string`
+
+Converts a string to camelCase.
 
 **Parameters:**
-- `input` - The string to convert
+- `str` - The input string
 
-**Returns:** camelCase string
+**Returns:** camelCase formatted string
 
-**Example:**
-```typescript
-toCamelCase('hello world'); // 'helloWorld'
-toCamelCase('Hello-World_Example'); // 'helloWorldExample'
-toCamelCase('API_KEY'); // 'apiKey'
-```
+---
+
+#### `toKebabCase(str: string): string`
 
-#### `toPascalCase(input: string): string`
-Converts string to PascalCase.
+Converts a string to kebab-case.
 
 **Parameters:**
-- `input` - The string to convert
+- `str` - The input string
 
-**Returns:** PascalCase string
+**Returns:** kebab-case formatted string
 
-**Example:**
-```typescript
-toPascalCase('hello world'); // 'HelloWorld'
-toPascalCase('api-key'); // 'ApiKey'
-toPascalCase('user_name'); // 'UserName'
-```
+---
+
+#### `toSnakeCase(str: string): string`
 
-#### `toKebabCase(input: string): string`
-Converts string to kebab-case.
+Converts a string to snake_case.
 
 **Parameters:**
-- `input` - The string to convert
+- `str` - The input string
 
-**Returns:** kebab-case string
+**Returns:** snake_case formatted string
 
-**Example:**
-```typescript
-toKebabCase('Hello World'); // 'hello-world'
-toKebabCase('camelCaseString'); // 'camel-case-string'
-toKebabCase('PascalCaseString'); // 'pascal-case-string'
-```
+---
+
+#### `toPascalCase(str: string): string`
 
-#### `splitToWords(input: string): string[]`
-Splits a string into individual words, handling various naming conventions.
+Converts a string to PascalCase.
 
 **Parameters:**
-- `input` - The string to split
+- `str` - The input string
 
-**Returns:** Array of words
+**Returns:** PascalCase formatted string
 
-**Example:**
-```typescript
-splitToWords('HelloWorld'); // ['Hello', 'World']
-splitToWords('hello-world_example'); // ['hello', 'world', 'example']
-splitToWords('XMLHttpRequest'); // ['XML', 'Http', 'Request']
-splitToWords('user123Name'); // ['user', '123', 'Name']
-```
+---
+
+#### `capitalizeWord(str: string): string`
 
-#### `trim(text: string, char?: string): string`
-Trims specified characters from the beginning and end of a string.
+Capitalizes the first letter of a string.
 
 **Parameters:**
-- `text` - The string to trim
-- `char` - Characters to trim (default: space). Supports regex patterns.
+- `str` - The input string
 
-**Returns:** Trimmed string
+**Returns:** String with first letter capitalized
 
-**Example:**
-```typescript
-trim('  hello  '); // 'hello'
-trim('...hello...', '\\.'); // 'hello'
-trim('[test]', '\\[|\\]'); // 'test'
-trim('!!hello!!', '!'); // 'hello'
-```
+---
 
-### Time Utilities
+#### `splitToWords(str: string): string[]`
 
-#### `secondsToHMS(seconds: number): string`
-Converts seconds to HH:MM:SS or MM:SS or SS format.
+Splits a string into an array of words.
 
 **Parameters:**
-- `seconds` - Number of seconds
+- `str` - The input string (camelCase, kebab-case, snake_case, or space-separated)
 
-**Returns:** Formatted time string
+**Returns:** Array of words
 
-**Example:**
-```typescript
-secondsToHMS(3661); // '1:01:01' (1 hour, 1 minute, 1 second)
-secondsToHMS(125); // '2:05' (2 minutes, 5 seconds)
-secondsToHMS(45); // '45' (45 seconds)
-secondsToHMS(0); // '0'
-```
+---
 
-#### `secondsToMS(seconds: number): string`
-Converts seconds to MM:SS format.
+#### `trim(str: string): string`
+
+Trims whitespace and normalizes internal spacing.
 
 **Parameters:**
-- `seconds` - Number of seconds
+- `str` - The input string
 
-**Returns:** MM:SS formatted string
+**Returns:** Trimmed and normalized string
 
-**Example:**
-```typescript
-secondsToMS(125); // '2:05'
-secondsToMS(45); // '0:45'
-secondsToMS(3661); // '61:01'
-```
+---
+
+#### `secondsToHMS(seconds: number): string`
 
-#### `millisecondsToHMS(ms: number): string`
-Converts milliseconds to HH:MM:SS or MM:SS or SS format.
+Converts seconds to H:MM:SS format.
 
 **Parameters:**
-- `ms` - Number of milliseconds
+- `seconds` - Number of seconds
 
 **Returns:** Formatted time string
 
-**Example:**
-```typescript
-millisecondsToHMS(3661000); // '1:01:01'
-millisecondsToHMS(125000); // '2:05'
-millisecondsToHMS(45000); // '45'
-millisecondsToHMS(500); // '0'
-```
+---
 
-#### `sleep(ms: number): Promise<void>`
-Creates a promise that resolves after the specified number of milliseconds.
+#### `secondsToMS(seconds: number): string`
 
-**Parameters:**
-- `ms` - Number of milliseconds to wait
+Converts seconds to M:SS format.
 
-**Returns:** Promise that resolves after the delay
+**Parameters:**
+- `seconds` - Number of seconds
 
-**Example:**
-```typescript
-await sleep(1000); // Wait 1 second
-await sleep(500); // Wait 0.5 seconds
+**Returns:** Formatted time string
 
-// Usage in async function
-async function delayedLog() {
-  console.log('First');
-  await sleep(2000);
-  console.log('Second (2 seconds later)');
-}
-```
+---
 
-### Data Parsing
+#### `millisecondsToHMS(milliseconds: number): string`
 
-#### `parseString<T>(text: string): T`
-Intelligently parses a string and returns the appropriate type.
+Converts milliseconds to H:MM:SS format.
 
 **Parameters:**
-- `text` - The string to parse
+- `milliseconds` - Number of milliseconds
 
-**Returns:** Parsed value with inferred type
+**Returns:** Formatted time string
 
-**Supported Formats:**
-- Integers: `"123"` → `123`
-- Floats: `"12.34"` → `12.34`
-- Scientific notation: `"1e5"` → `100000`
-- Booleans: `"true"`, `"false"` (case insensitive)
-- Null: `"null"` (case insensitive)
-- Arrays: `"[1,2,3]"` → `[1, 2, 3]`
-- Objects: `'{"key":"value"}'` → `{key: "value"}`
-- JSON strings: `'"hello"'` → `"hello"`
+---
 
-**Example:**
-```typescript
-parseString('123'); // 123 (number)
-parseString('12.34'); // 12.34 (number)
-parseString('1e3'); // 1000 (number)
-parseString('true'); // true (boolean)
-parseString('null'); // null
-parseString('[1,2,3]'); // [1, 2, 3] (array)
-parseString('{"name":"John"}'); // {name: "John"} (object)
-parseString('hello'); // 'hello' (string fallback)
-
-// With type annotation
-const num = parseString<number>('123'); // TypeScript knows it's a number
-const arr = parseString<number[]>('[1,2,3]'); // TypeScript knows it's number[]
-```
+#### `formatRelativeNumber(num: number): string`
 
-#### `parseEnvVars<T>(envs: Record<string, string>): T`
-Parses environment variables, converting keys to camelCase and values using `parseString`.
+Formats a number with K, M, or B suffix.
 
 **Parameters:**
-- `envs` - Object with environment variable key-value pairs
+- `num` - The number to format
 
-**Returns:** Object with camelCase keys and parsed values
+**Returns:** Formatted number string with suffix
 
-**Example:**
-```typescript
-const envVars = {
-  'API_PORT': '3000',
-  'DEBUG_MODE': 'true',
-  'ALLOWED_HOSTS': '["localhost", "127.0.0.1"]',
-  'MAX_CONNECTIONS': '100',
-  'ENABLE_SSL': 'false'
-};
-
-const config = parseEnvVars(envVars);
-// Result:
-// {
-//   apiPort: 3000,
-//   debugMode: true,
-//   allowedHosts: ['localhost', '127.0.0.1'],
-//   maxConnections: 100,
-//   enableSsl: false
-// }
-
-// With type annotation
-interface Config {
-  apiPort: number;
-  debugMode: boolean;
-  allowedHosts: string[];
-}
-const typedConfig = parseEnvVars<Config>(envVars);
-```
+---
 
-### Number Utilities
+#### `sleep(ms: number): Promise<void>`
 
-#### `formatRelativeNumber(num: number, config?: { precision?: number; lang?: string }): string`
-Formats numbers using compact notation with locale support.
+Pauses execution for the specified duration.
 
 **Parameters:**
-- `num` - The number to format
-- `config.precision` - Maximum decimal places (default: 1)
-- `config.lang` - Locale code (default: 'en-GB')
+- `ms` - Duration in milliseconds
 
-**Returns:** Formatted number string
+**Returns:** Promise that resolves after the duration
 
-**Example:**
-```typescript
-formatRelativeNumber(1000); // '1K'
-formatRelativeNumber(1500); // '1.5K'
-formatRelativeNumber(1000000); // '1M'
-formatRelativeNumber(1000000000); // '1B'
-
-// Custom precision
-formatRelativeNumber(1234, { precision: 2 }); // '1.23K'
-formatRelativeNumber(1234, { precision: 0 }); // '1K'
-
-// Different locales
-formatRelativeNumber(1500, { lang: 'de-DE' }); // '1500'
-formatRelativeNumber(1500000, { lang: 'de-DE' }); // '1,5 Mio.'
-formatRelativeNumber(1500, { lang: 'fr-FR' }); // '1,5 k'
-formatRelativeNumber(1500, { lang: 'es-ES' }); // '1,5 mil'
-```
+---
 
-### File Utilities
+#### `dataURLtoFile(dataUrl: string, filename: string): File`
 
-#### `dataURLtoFile(dataurl: string, filename: string): File`
 Converts a data URL to a File object.
 
 **Parameters:**
-- `dataurl` - The data URL string
-- `filename` - The desired filename for the File object
+- `dataUrl` - The data URL string
+- `filename` - Name for the resulting file
 
 **Returns:** File object
 
-**Example:**
-```typescript
-// Text file
-const textDataUrl = 'data:text/plain;base64,SGVsbG8gV29ybGQ=';
-const textFile = dataURLtoFile(textDataUrl, 'hello.txt');
-console.log(textFile.name); // 'hello.txt'
-console.log(textFile.type); // 'text/plain'
-console.log(textFile.size); // 11
-
-// Image file
-const imgDataUrl = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==';
-const imgFile = dataURLtoFile(imgDataUrl, 'pixel.png');
-console.log(imgFile.type); // 'image/png'
-
-// Usage with FileReader
-const reader = new FileReader();
-reader.onload = (e) => console.log(e.target?.result);
-reader.readAsText(textFile);
-```
+---
 
-### Random Generation
+#### `parseString(value: string): string | number | boolean`
 
-#### `random.nanoid(size?: number): string`
-Generates a random hexadecimal string.
+Parses a string value to its appropriate type.
 
 **Parameters:**
-- `size` - Length of the generated string (default: 10)
-
-**Returns:** Random hex string
-
-**Example:**
-```typescript
-random.nanoid(); // 'a1b2c3d4e5' (10 characters)
-random.nanoid(8); // 'f6e5d4c3' (8 characters)
-random.nanoid(16); // '1a2b3c4d5e6f7890' (16 characters)
-```
+- `value` - The string to parse
 
-#### `random.stringInt(size?: number): string`
-Generates a random numeric string.
+**Returns:** Parsed value (boolean, number, or string)
 
-**Parameters:**
-- `size` - Length of the generated string (default: 10)
-
-**Returns:** Random numeric string
+---
 
-**Example:**
-```typescript
-random.stringInt(); // '1234567890' (10 digits)
-random.stringInt(6); // '123456' (6 digits)
-random.stringInt(4); // '9876' (4 digits)
-```
+#### `parseEnvVars(content: string): Record<string, string>`
 
-#### `random.nanoidFactory(size?: number): (size?: number) => string`
-Creates a factory function for generating random hex strings.
+Parses environment variable content.
 
 **Parameters:**
-- `size` - Default length for the factory (default: 10)
+- `content` - Raw environment variable content
 
-**Returns:** Factory function that accepts optional size parameter
-
-**Example:**
-```typescript
-const generateId = random.nanoidFactory(12);
-generateId(); // 12-character hex string
-generateId(8); // 8-character hex string (overrides factory default)
-generateId(16); // 16-character hex string
-
-const generateShortId = random.nanoidFactory(6);
-generateShortId(); // 6-character hex string
-```
+**Returns:** Object with key-value pairs
 
 ## Advanced Usage
 
-### Environment Configuration
+### Building File Names
 
 ```typescript
-import { parseEnvVars } from '@ooneex/utils';
+import { toKebabCase, random } from '@ooneex/utils';
 
-// Define your configuration interface
-interface AppConfig {
-  port: number;
-  host: string;
-  debug: boolean;
-  features: string[];
-  dbConfig: {
-    host: string;
-    port: number;
-  };
+function generateFileName(title: string, extension: string): string {
+  const slug = toKebabCase(title);
+  const uniqueId = random(8);
+  return `${slug}-${uniqueId}.${extension}`;
 }
 
-// Parse environment variables
-const envConfig = parseEnvVars<Partial<AppConfig>>(process.env);
-
-// Merge with defaults
-const config: AppConfig = {
-  port: 3000,
-  host: 'localhost',
-  debug: false,
-  features: [],
-  dbConfig: { host: 'localhost', port: 5432 },
-  ...envConfig
-};
+const fileName = generateFileName('My Awesome Photo', 'jpg');
+// "my-awesome-photo-V1StGXR8.jpg"
 ```
 
-### String Processing Pipeline
+### Formatting Display Values
 
 ```typescript
-import { splitToWords, toCamelCase, capitalizeWord } from '@ooneex/utils';
+import { formatRelativeNumber, capitalizeWord } from '@ooneex/utils';
 
-function processUserInput(input: string): {
-  words: string[];
-  camelCase: string;
-  title: string;
-  kebabCase: string;
-} {
-  const words = splitToWords(input);
+interface SocialStats {
+  followers: number;
+  likes: number;
+  views: number;
+}
 
+function formatStats(stats: SocialStats): Record<string, string> {
   return {
-    words,
-    camelCase: toCamelCase(input),
-    title: words.map(capitalizeWord).join(' '),
-    kebabCase: toKebabCase(input)
+    followers: formatRelativeNumber(stats.followers),
+    likes: formatRelativeNumber(stats.likes),
+    views: formatRelativeNumber(stats.views)
   };
 }
 
-const result = processUserInput('user-profile_settings');
-// {
-//   words: ['user', 'profile', 'settings'],
-//   camelCase: 'userProfileSettings',
-//   title: 'User Profile Settings',
-//   kebabCase: 'user-profile-settings'
-// }
+const stats = formatStats({
+  followers: 15600,
+  likes: 1200000,
+  views: 45000
+});
+// { followers: "15.6K", likes: "1.2M", views: "45K" }
 ```
 
-### Time-based Progress Tracking
+### Video Duration Display
 
 ```typescript
-import { millisecondsToHMS, formatRelativeNumber } from '@ooneex/utils';
+import { secondsToHMS, secondsToMS } from '@ooneex/utils';
 
-class ProgressTracker {
-  private startTime: number;
-  private itemsProcessed: number = 0;
-  private totalItems: number;
+function formatDuration(seconds: number): string {
+  // Use H:MM:SS for videos over an hour, otherwise M:SS
+  return seconds >= 3600 
+    ? secondsToHMS(seconds)
+    : secondsToMS(seconds);
+}
 
-  constructor(totalItems: number) {
-    this.startTime = Date.now();
-    this.totalItems = totalItems;
-  }
+console.log(formatDuration(90));    // "1:30"
+console.log(formatDuration(3700));  // "1:01:40"
+```
+
+### Retry with Delay
 
-  update(processed: number): string {
-    this.itemsProcessed = processed;
-    const elapsed = Date.now() - this.startTime;
-    const rate = processed / (elapsed / 1000);
-    const remaining = (this.totalItems - processed) / rate * 1000;
-
-    return [
-      `Processed: ${formatRelativeNumber(processed)}/${formatRelativeNumber(this.totalItems)}`,
-      `Elapsed: ${millisecondsToHMS(elapsed)}`,
-      `ETA: ${millisecondsToHMS(remaining)}`
-    ].join(' | ');
+```typescript
+import { sleep } from '@ooneex/utils';
+
+async function retryWithBackoff<T>(
+  fn: () => Promise<T>,
+  maxRetries: number = 3,
+  baseDelay: number = 1000
+): Promise<T> {
+  let lastError: Error;
+  
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error as Error;
+      const delay = baseDelay * Math.pow(2, attempt);
+      console.log(`Attempt ${attempt + 1} failed, retrying in ${delay}ms...`);
+      await sleep(delay);
+    }
   }
+  
+  throw lastError!;
+}
+```
+
+### API Route Slug Generation
+
+```typescript
+import { toKebabCase } from '@ooneex/utils';
+
+function generateApiSlug(resourceName: string, action: string): string {
+  const resource = toKebabCase(resourceName);
+  const actionSlug = toKebabCase(action);
+  return `/api/${resource}/${actionSlug}`;
 }
 
-const tracker = new ProgressTracker(100000);
-console.log(tracker.update(15000));
-// "Processed: 15K/100K | Elapsed: 2:30 | ETA: 14:10"
+generateApiSlug('UserProfile', 'getById');  // "/api/user-profile/get-by-id"
+generateApiSlug('BlogPost', 'create');       // "/api/blog-post/create"
 ```
 
 ## License

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 declare const capitalizeWord: (word: string) => string;
-declare const dataURLtoFile: (dataurl: string, filename: string) => File;
+declare const dataURLtoFile: (dataUrl: string, filename: string) => File;
 declare const formatRelativeNumber: (num: number, config?: {
 	precision?: number;
 	lang?: string;

package/dist/index.js.map

@@ -3,7 +3,7 @@
   "sources": ["src/capitalizeWord.ts", "src/dataURLtoFile.ts", "src/formatRelativeNumber.ts", "src/millisecondsToHMS.ts", "src/trim.ts", "src/parseString.ts", "src/splitToWords.ts", "src/toCamelCase.ts", "src/parseEnvVars.ts", "src/random.ts", "src/secondsToHMS.ts", "src/secondsToMS.ts", "src/sleep.ts", "src/toKebabCase.ts", "src/toPascalCase.ts", "src/toSnakeCase.ts"],
   "sourcesContent": [
     "export const capitalizeWord = (word: string): string =>\n  word ? word[0]?.toUpperCase() + word.slice(1).toLowerCase() : word;\n",
-    "export const dataURLtoFile = (dataurl: string, filename: string): File => {\n  const arr = dataurl.split(\",\");\n  const mimeMatch = arr[0]?.match(/:(.*?);/);\n  const mime = mimeMatch?.[1] || \"\";\n  const bstr = atob(arr[1] as string);\n  let n = bstr.length;\n  const u8arr = new Uint8Array(n);\n  while (n--) {\n    u8arr[n] = bstr.charCodeAt(n);\n  }\n  return new File([u8arr], filename, { type: mime });\n};\n",
+    "export const dataURLtoFile = (dataUrl: string, filename: string): File => {\n  const arr = dataUrl.split(\",\");\n  const mimeMatch = arr[0]?.match(/:(.*?);/);\n  const mime = mimeMatch?.[1] || \"\";\n  const bstr = atob(arr[1] as string);\n  let n = bstr.length;\n  const u8arr = new Uint8Array(n);\n  while (n--) {\n    u8arr[n] = bstr.charCodeAt(n);\n  }\n  return new File([u8arr], filename, { type: mime });\n};\n",
     "export const formatRelativeNumber = (num: number, config?: { precision?: number; lang?: string }): string =>\n  new Intl.NumberFormat(config?.lang ?? \"en-GB\", {\n    notation: \"compact\",\n    compactDisplay: \"short\",\n    maximumFractionDigits: config?.precision ?? 1,\n  }).format(num);\n",
     "export const millisecondsToHMS = (ms: number): string => {\n  const totalSeconds = Math.floor(ms / 1000);\n  const hours = Math.floor(totalSeconds / 3600);\n  const minutes = Math.floor((totalSeconds % 3600) / 60);\n  const seconds = totalSeconds % 60;\n\n  if (hours > 0) {\n    return `${hours}:${minutes.toString().padStart(2, \"0\")}:${seconds.toString().padStart(2, \"0\")}`;\n  }\n\n  if (minutes > 0) {\n    return `${minutes}:${seconds.toString().padStart(2, \"0\")}`;\n  }\n\n  return seconds.toString();\n};\n",
     "export const trim = (text: string, char = \" \"): string => {\n  if ([\".\", \"[\", \"]\", \"(\", \")\", \"+\", \"*\", \"^\", \"$\", \"?\", \"/\", \"\\\\\"].includes(char)) {\n    char = `\\\\${char}`;\n  }\n\n  const reg = new RegExp(`^${char}+|${char}+$`, \"g\");\n  return text.replace(reg, \"\");\n};\n",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ooneex/utils",
-  "description": "Common utility functions including unique ID generation with nanoid and helper methods",
-  "version": "0.1.0",
+  "description": "General-purpose utility functions including unique ID generation with nanoid, type guards, and common helper methods",
+  "version": "0.2.0",
   "type": "module",
   "files": [
     "dist",
@@ -25,10 +25,20 @@
     "test": "bun test tests",
     "build": "bunup",
     "lint": "tsgo --noEmit && bunx biome lint",
-    "publish": "bun publish --tolerate-republish --access public"
+    "npm:publish": "bun publish --tolerate-republish --force --production --access public"
   },
   "dependencies": {
     "nanoid": "^5.1.6"
   },
-  "devDependencies": {}
+  "devDependencies": {},
+  "keywords": [
+    "bun",
+    "helpers",
+    "nanoid",
+    "ooneex",
+    "tools",
+    "typescript",
+    "utilities",
+    "utils"
+  ]
 }