dnsweeper/docs/technical/csv-library-comparison.md

Advanced CLI tool for DNS record risk analysis and cleanup. Features CSV import for Cloudflare/Route53, automated risk assessment, and parallel DNS validation.

# CSV処理ライブラリ選定: Papaparse vs alternatives

## 📋 要件分析

DNSweeperプロジェクトに必要なCSV機能：

### 必要なCSV処理機能
1. **CSV読み込み**: 大容量ファイル対応
2. **形式対応**: Cloudflare, Route53, 汎用CSV
3. **ストリーミング**: メモリ効率的な処理
4. **エラーハンドリング**: 不正データの処理
5. **TypeScript対応**: 型安全性
6. **パフォーマンス**: 高速処理

### 対応必要なCSVフォーマット

#### Cloudflare CSV形式
```csv
Name,Type,Content,TTL,Priority
example.com,A,192.168.1.1,3600,
www.example.com,CNAME,example.com,3600,
mail.example.com,MX,mail.example.com,3600,10
```

#### Route53 CSV形式
```csv
Name,Type,Value,TTL,Weight,SetIdentifier
example.com,A,192.168.1.1,300,,
www.example.com,CNAME,example.com,300,,
example.com,MX,"10 mail.example.com",300,,
```

#### 汎用CSV形式
```csv
domain,record_type,value,ttl,priority,weight,port
example.com,A,192.168.1.1,3600,,,
www.example.com,CNAME,example.com,3600,,,
example.com,MX,mail.example.com,3600,10,,
```

## 🔍 Papaparse 分析

### 概要
- **Package**: `papaparse`
- **Version**: 5.4.1 (latest)
- **Size**: 96.4 KB (unpacked)
- **Downloads**: 2M+ weekly
- **TypeScript**: @types/papaparse

### メリット
- **ストリーミング対応**: 大容量ファイル処理可能
- **高パフォーマンス**: Worker threads対応
- **豊富な機能**: CSVパース・生成両対応
- **エラーハンドリング**: 詳細なエラー情報
- **ブラウザ/Node.js**: 両対応
- **活発メンテナンス**: 定期更新

### 機能詳細
```typescript
import Papa from 'papaparse';

// ファイル読み込み
Papa.parse(file, {
  header: true,           // ヘッダー行を使用
  skipEmptyLines: true,   // 空行スキップ
  transform: (value) => value.trim(), // データ変換
  step: (row) => {        // ストリーミング処理
    console.log(row.data);
  },
  complete: (results) => {
    console.log('Complete:', results);
  },
  error: (error) => {
    console.log('Error:', error);
  }
});
```

### デメリット
- **依存関係**: 追加パッケージ必要
- **学習コスト**: API理解が必要
- **TypeScript**: 型定義が別パッケージ

## 🔍 代替選択肢比較

### 1. csv-parser
```typescript
// 軽量だがストリーミングのみ
import csvParser from 'csv-parser';
import fs from 'fs';

fs.createReadStream('data.csv')
  .pipe(csvParser())
  .on('data', (row) => console.log(row));
```

**評価**: 軽量だが機能制限あり

### 2. fast-csv
```typescript
// 高速だがAPI複雑
import csv from 'fast-csv';

csv.parseFile('data.csv', { headers: true })
   .on('data', row => console.log(row));
```

**評価**: 高速だがAPIが複雑

### 3. node:fs + 手動実装
```typescript
// Node.js標準のみ
import fs from 'fs';

const content = fs.readFileSync('data.csv', 'utf8');
const lines = content.split('\n');
const headers = lines[0].split(',');
```

**評価**: 依存なしだが機能不足

## 📊 比較マトリックス

| 項目 | Papaparse | csv-parser | fast-csv | 手動実装 |
|------|-----------|------------|----------|----------|
| **ストリーミング** | ✅ 優秀 | ✅ 良好 | ✅ 良好 | ❌ なし |
| **エラーハンドリング** | ✅ 詳細 | 🔶 基本 | 🔶 基本 | ❌ 手動 |
| **TypeScript対応** | ✅ 型定義 | 🔶 型定義 | 🔶 型定義 | ✅ 自前 |
| **API簡潔性** | ✅ 直感的 | 🔶 普通 | 🔶 複雑 | ✅ シンプル |
| **パフォーマンス** | ✅ 高速 | ✅ 高速 | ✅ 最高速 | 🔶 普通 |
| **メンテナンス** | ✅ 活発 | 🔶 安定 | 🔶 安定 | ✅ 不要 |
| **依存関係** | 🔶 あり | 🔶 あり | 🔶 あり | ✅ なし |
| **学習コスト** | 🔶 中 | ✅ 低 | 🔶 高 | ✅ 低 |

## 🎯 推奨決定

### **選択: Papaparse**

#### 理由
1. **機能完全性**: ストリーミング・エラーハンドリング・変換すべて対応
2. **実績**: 2M+週間DL、多数のプロダクションで使用
3. **開発効率**: 直感的API、豊富なドキュメント
4. **将来性**: CSV出力機能も必要になる予定（マイルストーン対応）

#### 実装戦略
```typescript
// 1. CSVProcessorクラス設計
class CSVProcessor {
  async parseCloudflare(file: string): Promise<DNSRecord[]>
  async parseRoute53(file: string): Promise<DNSRecord[]>
  async parseGeneric(file: string): Promise<DNSRecord[]>
}

// 2. ストリーミング処理
const processor = new CSVProcessor();
await processor.parseCloudflare('dns-records.csv');
```

## 📝 実装計画

### Phase 1: Papaparse導入・基本設定
- [ ] Papaparse + @types/papaparse インストール
- [ ] CSVProcessorクラス基本構造作成
- [ ] 型定義整備

### Phase 2: フォーマット別実装
- [ ] Cloudflare CSV形式対応
- [ ] Route53 CSV形式対応
- [ ] 汎用CSV形式対応

### Phase 3: 高度機能実装
- [ ] ストリーミング処理対応
- [ ] エラーハンドリング強化
- [ ] 大容量ファイル最適化

### Phase 4: テスト・統合
- [ ] 単体テスト作成
- [ ] サンプルCSVファイルでテスト
- [ ] CLI統合

## 🔗 参考資料
- [Papaparse Documentation](https://www.papaparse.com/docs)
- [Cloudflare DNS API](https://developers.cloudflare.com/api/)
- [Route53 Record Sets](https://docs.aws.amazon.com/route53/)