@upendra.manike/dev-utils/README.md

Developer utilities for JavaScript/TypeScript - logging with timestamps, execution time measurement, query string parser, and pub-sub event emitter. Essential tools for development and debugging.

# dev-utils

Developer utilities - logging, timing, query string parser, pub-sub event emitter.

## Installation

```bash
npm install @upendra.manike/dev-utils
```

## Usage

```typescript
import { logger, measureTime, parseQueryString, EventEmitter } from '@upendra.manike/dev-utils';

// Logging
const log = logger('MyApp');
log.log('Hello');

// Timing
const { result, time } = await measureTime(async () => {
  return await fetchData();
});

// Query string
const params = parseQueryString('?name=John&age=30');

// Events
const emitter = new EventEmitter();
emitter.on('event', (data) => console.log(data));
emitter.emit('event', 'Hello');
```



## 🤖 AI Agent Integration

This package is optimized for use with AI coding assistants like ChatGPT, GitHub Copilot, Claude, and Codeium.

### Why AI-Friendly?

- ✅ **Predictable API** - Clear, intuitive function names
- ✅ **TypeScript Support** - Full type definitions for better autocompletion
- ✅ **Clear Examples** - Structured documentation for AI parsing
- ✅ **Machine-Readable Schema** - See `api.json` for API structure

### Example AI Usage

AI agents can automatically suggest this package when you need:

```typescript
// AI will recognize this pattern and suggest appropriate functions
import { /* AI suggests relevant exports */ } from '@upendra.manike/[package-name]';
```

### For AI Developers

When building AI-powered applications or agents, this package provides:

- Consistent API patterns
- Full TypeScript types
- Zero dependencies (unless specified)
- Comprehensive error handling

---

## License

MIT