Promises or raw string support

[iuccio]

🚀 Promise-based Async API for csvToJson

Overview

Add Promise-based async API to support modern JavaScript patterns while maintaining full backward compatibility with the existing sync API.

Key Features

• ✨ Promise-based async methods (getJsonFromCsvAsync, generateJsonFileFromCsvAsync)
• 🔄 Full compatibility with existing sync API
• 📈 Improved memory handling for large files
• 🎯 TypeScript support with updated type definitions

Implementation Details

New Files

• src/csvToJsonAsync.js - Core async implementation
• MIGRATION.md - Migration guide
• test/async.spec.js - Async API tests

Updates

• README.md: Added async documentation & examples
• index.js: Added async API exports
• index.d.ts: Added TypeScript definitions
• src/util/fileUtils.js: Added async operations

Usage Examples

// Async/Await
const json = await csvToJson
  .formatValueByType()
  .getJsonFromCsvAsync('input.csv');

// Promise Chain
csvToJson
  .fieldDelimiter(',')
  .getJsonFromCsvAsync('input.csv')
  .then(json => console.log(json))
  .catch(err => console.error(err));

---

And here's a refined version of the release notes:

# 🎉 New Release: Async Support

## ✨ Highlights
- Promise-based async API for modern JavaScript applications
- Improved memory handling for large files
- Full backward compatibility maintained
- Comprehensive documentation and migration guide

## 📦 Added
- `getJsonFromCsvAsync()` - Promise-based CSV parsing
- `generateJsonFileFromCsvAsync()` - Async file generation
- Migration guide with best practices
- TypeScript definitions for async API
- Performance optimization examples

## 🔧 Enhanced
- Documentation structure and examples
- Large file processing capabilities
- Error handling and recovery patterns
- TypeScript support

## 📝 Notes
- Zero breaking changes
- Existing sync API remains unchanged
- Gradual migration path available