@go-corp/utils


A comprehensive collection of utility functions for TypeScript/JavaScript projects.

Installation

``bash
npm install @go-corp/utils


or

yarn add @go-corp/utils

or

bun add @go-corp/utils
`

Usage

`typescript
import { deepClone, formatDate, toCamelCase } from '@go-corp/utils'

// String utilities
const camelCased = toCamelCase('hello world') // 'helloWorld'

// Date utilities
const formatted = formatDate(new Date(), 'medium') // 'Jan 1, 2024'

// Object utilities
const cloned = deepClone({ a: { b: 1 } })
`

API Documentation

$3

- toCamelCase(str: string): string - Converts string to camelCase
- toKebabCase(str: string): string - Converts string to kebab-case
- toSnakeCase(str: string): string - Converts string to snake_case
- toPascalCase(str: string): string - Converts string to PascalCase
- truncate(str: string, length: number, suffix?: string): string - Truncates string to specified length
- capitalize(str: string): string - Capitalizes first letter
- slugify(str: string): string - Creates URL-friendly slugs
- generateRandomString(length: number, charset?: string): string - Generates random string
- removeWhitespace(str: string): string - Removes all whitespace

$3

- formatDate(date: Date, format?: 'short' | 'medium' | 'long' | 'iso'): string - Formats date
- daysBetween(date1: Date, date2: Date): number - Days between two dates
- isToday(date: Date): boolean - Checks if date is today
- isThisWeek(date: Date): boolean - Checks if date is this week
- addDays(date: Date, days: number): Date - Adds days to date
- addMonths(date: Date, months: number): Date - Adds months to date
- startOfDay(date: Date): Date - Gets start of day
- endOfDay(date: Date): Date - Gets end of day
- getRelativeTime(date: Date, baseDate?: Date): string - Gets relative time string

$3

- deepClone(obj: T): T - Deep clones object
- omit(obj: T, keys: K[]): Omit - Omits keys from object
- pick(obj: T, keys: K[]): Pick - Picks keys from object
- isEmpty(obj: any): boolean - Checks if object is empty

$3

- unique(array: T[]): T[] - Removes duplicate values
- groupBy(array: T[], keyFn: (item: T) => K): Record - Groups array items by key
- chunk(array: T[], size: number): T[][] - Chunks array into smaller arrays
- shuffle(array: T[]): T[] - Shuffles array randomly

$3

- isValidEmail(email: string): boolean - Validates email address
- isValidUrl(url: string): boolean - Validates URL
- isValidPhone(phone: string): boolean - Validates phone number (US format)
- isValidUUID(uuid: string): boolean - Validates UUID

$3

- delay(ms: number): Promise - Creates a delay/sleep function
- debounce(func: T, wait: number): (...args: Parameters) => void - Debounces function
- throttle(func: T, wait: number): (...args: Parameters) => void - Throttles function
- retry(fn: () => Promise, maxAttempts?: number, baseDelay?: number): Promise - Retries async function with exponential backoff

$3

- isNotNull(value: T | null | undefined): value is T - Type guard for non-null values
- isString(value: unknown): value is string - Type guard for strings
- isNumber(value: unknown): value is number - Type guard for numbers
- isBoolean(value: unknown): value is boolean - Type guard for booleans
- isArray(value: unknown): value is T[] - Type guard for arrays
- isObject(value: unknown): value is Record - Type guard for plain objects
- isFunction(value: unknown): value is Function - Type guard for functions

$3

- clamp(value: number, min: number, max: number): number - Clamps number between min/max
- randomBetween(min: number, max: number): number - Random number between min/max
- roundTo(value: number, decimals: number): number - Rounds to specified decimals
- percentage(value: number, total: number): number - Calculates percentage
- degToRad(degrees: number): number - Converts degrees to radians
- radToDeg(radians: number): number - Converts radians to degrees

$3

- getQueryParams(url: string): Record - Gets URL query parameters
- formatBytes(bytes: number, decimals?: number): string - Formats bytes to human readable
- copyToClipboard(text: string): Promise - Copies text to clipboard

$3

- createTimer(label?: string) - Creates a performance timer
- logWithTime(message: string, ...args: any[]): void - Logs with timestamp
- prettyPrint(obj: any, indent?: number): void - Pretty prints object
- measureTime(fn: () => T | Promise, label?: string): Promise<{ result: T; duration: number }> - Measures function execution time

$3

#### Git & Repository Management
- getCurrentBranch(): string - Get current Git branch
- hasUncommittedChanges(): boolean - Check for uncommitted changes
- getChangedFiles(): string[] - Get list of changed files
- getRecentCommits(count?: number): string[] - Get recent commit messages
- incrementVersion(version: string, type: 'major' | 'minor' | 'patch'): string - Increment version string
- getCurrentVersion(packagePath?: string): string - Get version from package.json
- updatePackageVersion(newVersion: string, packagePath?: string): void - Update package.json version
- analyzeChangesForVersionBump(): VersionAnalysis - Analyze changes for version bump
- updateChangelog(version: string, changeType: string, changesList: string[]): void - Update CHANGELOG.md
- commitAndPush(message: string, push?: boolean): void - Create and push git commit
- isGitRepository(): boolean - Check if in a git repository
- exec(command: string, options?: ExecOptions): string - Execute shell command
- log(message: string, color?: string): void - Log with color
- COLORS - Terminal color constants

#### CLI Prompts & Interaction
- text(options: PromptOptions): Promise - Simple text prompt
- confirm(options: ConfirmOptions): Promise - Yes/no confirmation
- select(options: SelectOptions): Promise - Select from options
- multiselect(options: MultiSelectOptions): Promise - Multi-select from options
- password(options: PromptOptions): Promise - Hidden password input
- ProgressIndicator - Animated progress indicator class

Development

`bash


Install dependencies

bun install

Run tests

bun run test

Build

bun run build

Type check

bun run type-check

Lint

bun run lint
`

MCP Server Integration

@go-corp/utils includes an MCP (Model Context Protocol) server that automatically provides AI assistants with context about your utilities.

$3

1. Install the package:
`bash
npm install @go-corp/utils
`

2. Configure Warp MCP in your terminal settings:
`json
{
"mcpServers": {
"go-utils": {
"command": "go-utils-mcp"
}
}
}
`

3. The AI will now automatically know when @go-corp/utils is available and suggest relevant utilities!

$3

- ✅ Which utilities are available in your project
- 📋 Detailed function signatures and usage examples
- 🎯 When to suggest specific utilities
- 🚀 Import statements and code examples
- 💡 Perfect use cases for different scenarios

See mcp-server/README.md for detailed setup instructions.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature`)
5. Open a Pull Request

License

MIT © Go Corp