jtcsv 2.2.7 → 3.0.0

package/plugins/nestjs/index.ts

@@ -0,0 +1,201 @@
+/**
+ * NestJS plugin for jtcsv
+ * Provides interceptors and decorators for CSV parsing and downloading in NestJS applications
+ * @module plugins/nestjs
+ */
+
+// Note: NestJS and RxJS types are optional - users need to install @nestjs/common and rxjs
+// We use conditional imports to avoid breaking the build
+type Injectable = any;
+type UseInterceptors = any;
+type ExecutionContext = any;
+type CallHandler = any;
+type NestInterceptor = any;
+type Observable<T> = any;
+
+import { csvToJson, jsonToCsv } from '../../index-core';
+import type { CsvToJsonOptions, JsonToCsvOptions } from '../../src/types';
+
+/**
+ * Options for CSV parser interceptor
+ */
+export interface CsvParserOptions extends CsvToJsonOptions {
+  // Additional options specific to CSV parsing
+}
+
+/**
+ * Options for CSV download interceptor
+ */
+export interface CsvDownloadOptions extends JsonToCsvOptions {
+  /** Filename for the downloaded CSV file */
+  filename?: string;
+}
+
+/**
+ * Normalize filename for CSV download
+ */
+function normalizeFilename(filename?: string): string {
+  if (!filename || typeof filename !== 'string') {
+    return 'export.csv';
+  }
+  return filename.includes('.') ? filename : `${filename}.csv`;
+}
+
+/**
+ * Creates a CSV parser interceptor for NestJS
+ * Parses incoming CSV request bodies into JSON
+ */
+export function createCsvParserInterceptor(options: CsvParserOptions = {}): any {
+  class CsvParserInterceptorImpl {
+    async intercept(context: ExecutionContext, next: CallHandler): Promise<Observable<any>> {
+      const req = context.switchToHttp().getRequest();
+      const body = req && req.body;
+
+      if (typeof body === 'string' || Buffer.isBuffer(body)) {
+        const csv = Buffer.isBuffer(body) ? body.toString('utf8') : body;
+        req.body = await csvToJson(csv, options);
+      }
+
+      return next.handle();
+    }
+  }
+
+  return CsvParserInterceptorImpl;
+}
+
+/**
+ * Creates a CSV download interceptor for NestJS
+ * Converts JSON responses to CSV and sets appropriate headers
+ */
+export function createCsvDownloadInterceptor(options: CsvDownloadOptions = {}): any {
+  class CsvDownloadInterceptorImpl {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
+      const res = context.switchToHttp().getResponse();
+      const filename = normalizeFilename(options.filename);
+      const csvOptions = { ...options } as JsonToCsvOptions;
+      delete (csvOptions as any).filename;
+
+      return next.handle().pipe(
+        (async (data: any) => {
+          const rows = Array.isArray(data) ? data : [data];
+          const csv = await jsonToCsv(rows, csvOptions);
+
+          if (res && typeof res.setHeader === 'function') {
+            res.setHeader('Content-Type', 'text/csv; charset=utf-8');
+            res.setHeader(
+              'Content-Disposition',
+              `attachment; filename="${filename}"`
+            );
+          }
+
+          return csv;
+        }) as any
+      );
+    }
+  }
+
+  return CsvDownloadInterceptorImpl;
+}
+
+/**
+ * Decorator for CSV parsing interceptor
+ * Usage: @CsvParserInterceptor({ delimiter: ',' })
+ */
+export function CsvParserInterceptor(options: CsvParserOptions = {}): any {
+  const Interceptor = createCsvParserInterceptor(options);
+  return Interceptor;
+}
+
+/**
+ * Decorator for CSV download interceptor
+ * Usage: @CsvDownloadDecorator({ filename: 'data.csv' })
+ */
+export function CsvDownloadDecorator(options: CsvDownloadOptions = {}): any {
+  const Interceptor = createCsvDownloadInterceptor(options);
+  return Interceptor;
+}
+
+/**
+ * Async version of CSV parser interceptor
+ * Uses async/await for better performance with large files
+ */
+export function createAsyncCsvParserInterceptor(options: CsvParserOptions = {}): any {
+  class AsyncCsvParserInterceptorImpl {
+    async intercept(context: ExecutionContext, next: CallHandler): Promise<Observable<any>> {
+      const req = context.switchToHttp().getRequest();
+      const body = req && req.body;
+
+      if (typeof body === 'string' || Buffer.isBuffer(body)) {
+        const csv = Buffer.isBuffer(body) ? body.toString('utf8') : body;
+        req.body = await csvToJson(csv, options);
+      }
+
+      return next.handle();
+    }
+  }
+
+  return AsyncCsvParserInterceptorImpl;
+}
+
+/**
+ * Async version of CSV download interceptor
+ * Uses async/await for better performance with large files
+ */
+export function createAsyncCsvDownloadInterceptor(options: CsvDownloadOptions = {}): any {
+  class AsyncCsvDownloadInterceptorImpl {
+    async intercept(context: ExecutionContext, next: CallHandler): Promise<Observable<any>> {
+      const res = context.switchToHttp().getResponse();
+      const filename = normalizeFilename(options.filename);
+      const csvOptions = { ...options } as JsonToCsvOptions;
+      delete (csvOptions as any).filename;
+
+      return next.handle().pipe(
+        (async (data: any) => {
+          const rows = Array.isArray(data) ? data : [data];
+          const csv = await jsonToCsv(rows, csvOptions);
+
+          if (res && typeof res.setHeader === 'function') {
+            res.setHeader('Content-Type', 'text/csv; charset=utf-8');
+            res.setHeader(
+              'Content-Disposition',
+              `attachment; filename="${filename}"`
+            );
+          }
+
+          return csv;
+        }) as any
+      );
+    }
+  }
+
+  return AsyncCsvDownloadInterceptorImpl;
+}
+
+/**
+ * Async decorator for CSV parsing interceptor
+ * Usage: @AsyncCsvParserInterceptor({ delimiter: ',' })
+ */
+export function AsyncCsvParserInterceptor(options: CsvParserOptions = {}): any {
+  const Interceptor = createAsyncCsvParserInterceptor(options);
+  return Interceptor;
+}
+
+/**
+ * Async decorator for CSV download interceptor
+ * Usage: @AsyncCsvDownloadDecorator({ filename: 'data.csv' })
+ */
+export function AsyncCsvDownloadDecorator(options: CsvDownloadOptions = {}): any {
+  const Interceptor = createAsyncCsvDownloadInterceptor(options);
+  return Interceptor;
+}
+
+export default {
+  CsvParserInterceptor,
+  CsvDownloadDecorator,
+  createCsvParserInterceptor,
+  createCsvDownloadInterceptor,
+  AsyncCsvParserInterceptor,
+  AsyncCsvDownloadDecorator,
+  createAsyncCsvParserInterceptor,
+  createAsyncCsvDownloadInterceptor,
+};

package/plugins/nextjs-api/examples/ConverterComponent.tsx

@@ -0,0 +1,386 @@
+/**
+ * Пример React компонента для конвертации CSV/JSON
+ * Использование в Next.js приложении
+ */
+
+import React, { useState } from 'react';
+import { useJtcsv, CsvFileUploader, downloadCsv } from '../index';
+
+/**
+ * Компонент для конвертации CSV ↔ JSON
+ */
+export default function ConverterComponent() {
+  const [input, setInput] = useState('');
+  const [output, setOutput] = useState('');
+  const [format, setFormat] = useState('csv'); // 'csv' или 'json'
+  const [delimiter, setDelimiter] = useState(',');
+  
+  const { 
+    convertCsvToJson, 
+    convertJsonToCsv, 
+    isLoading, 
+    error, 
+    stats 
+  } = useJtcsv({
+    delimiter,
+    parseNumbers: true,
+    parseBooleans: true,
+    preventCsvInjection: true
+  });
+  
+  const handleConvert = async () => {
+    if (!input.trim()) return;
+    
+    try {
+      if (format === 'csv') {
+        // Конвертируем CSV в JSON
+        const result = await convertCsvToJson(input);
+        setOutput(JSON.stringify(result, null, 2));
+      } else {
+        // Конвертируем JSON в CSV
+        const json = JSON.parse(input);
+        const result = await convertJsonToCsv(json);
+        setOutput(result);
+      }
+    } catch (err) {
+      setOutput(`Error: ${err.message}`);
+    }
+  };
+  
+  const handleFileUpload = (result, fileStats) => {
+    setInput(JSON.stringify(result, null, 2));
+    setFormat('json');
+    
+    console.log('File converted:', fileStats);
+  };
+  
+  const handleDownload = async () => {
+    if (!output) return;
+    
+    try {
+      if (format === 'csv') {
+        // Скачиваем как CSV
+        const json = JSON.parse(input);
+        await downloadCsv(json, 'converted.csv', { delimiter });
+      } else {
+        // Скачиваем как JSON
+        const blob = new Blob([output], { type: 'application/json' });
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = 'converted.json';
+        link.click();
+        URL.revokeObjectURL(url);
+      }
+    } catch (err) {
+      console.error('Download error:', err);
+    }
+  };
+  
+  const handleExample = () => {
+    if (format === 'csv') {
+      setInput('name,email,age\nJohn Doe,john@example.com,30\nJane Smith,jane@example.com,25');
+    } else {
+      setInput(JSON.stringify([
+        { name: 'John Doe', email: 'john@example.com', age: 30 },
+        { name: 'Jane Smith', email: 'jane@example.com', age: 25 }
+      ], null, 2));
+    }
+  };
+  
+  const handleClear = () => {
+    setInput('');
+    setOutput('');
+  };
+  
+  return (
+    <div style={styles.container}>
+      <h1 style={styles.title}>🔄 JTCSV Converter</h1>
+      
+      <div style={styles.controls}>
+        <div style={styles.formatSelector}>
+          <label>
+            <input
+              type="radio"
+              value="csv"
+              checked={format === 'csv'}
+              onChange={(e) => setFormat(e.target.value)}
+            />
+            CSV → JSON
+          </label>
+          <label>
+            <input
+              type="radio"
+              value="json"
+              checked={format === 'json'}
+              onChange={(e) => setFormat(e.target.value)}
+            />
+            JSON → CSV
+          </label>
+        </div>
+        
+        <div style={styles.delimiterSelector}>
+          <label>
+            Разделитель:
+            <select 
+              value={delimiter} 
+              onChange={(e) => setDelimiter(e.target.value)}
+              style={styles.select}
+            >
+              <option value=",">Запятая (,)</option>
+              <option value=";">Точка с запятой (;)</option>
+              <option value="\t">Табуляция (\t)</option>
+              <option value="|">Вертикальная черта (|)</option>
+            </select>
+          </label>
+        </div>
+      </div>
+      
+      <div style={styles.inputSection}>
+        <div style={styles.inputHeader}>
+          <h3 style={styles.sectionTitle}>
+            {format === 'csv' ? 'CSV Input' : 'JSON Input'}
+          </h3>
+          <div style={styles.inputActions}>
+            <CsvFileUploader 
+              onConvert={handleFileUpload}
+              options={{ delimiter }}
+            >
+              <button style={styles.buttonSecondary}>📁 Upload CSV</button>
+            </CsvFileUploader>
+            <button 
+              onClick={handleExample}
+              style={styles.buttonSecondary}
+            >
+              📋 Example
+            </button>
+            <button 
+              onClick={handleClear}
+              style={styles.buttonSecondary}
+            >
+              🗑️ Clear
+            </button>
+          </div>
+        </div>
+        
+        <textarea
+          value={input}
+          onChange={(e) => setInput(e.target.value)}
+          placeholder={format === 'csv' 
+            ? 'Введите CSV данные...\nПример:\nname,email,age\nJohn,john@example.com,30' 
+            : 'Введите JSON данные...\nПример:\n[{"name":"John","age":30}]'
+          }
+          style={styles.textarea}
+          rows={10}
+        />
+      </div>
+      
+      <div style={styles.convertButtonContainer}>
+        <button
+          onClick={handleConvert}
+          disabled={isLoading || !input.trim()}
+          style={{
+            ...styles.buttonPrimary,
+            opacity: isLoading || !input.trim() ? 0.6 : 1,
+            cursor: isLoading || !input.trim() ? 'not-allowed' : 'pointer'
+          }}
+        >
+          {isLoading ? '🔄 Converting...' : '🚀 Convert'}
+        </button>
+        
+        {stats && (
+          <div style={styles.stats}>
+            <span>⏱️ {stats.processingTime}ms</span>
+            <span>📊 {stats.rows || stats.size} {stats.rows ? 'rows' : 'chars'}</span>
+          </div>
+        )}
+      </div>
+      
+      {error && (
+        <div style={styles.error}>
+          ❌ Error: {error}
+        </div>
+      )}
+      
+      <div style={styles.outputSection}>
+        <div style={styles.outputHeader}>
+          <h3 style={styles.sectionTitle}>
+            {format === 'csv' ? 'JSON Output' : 'CSV Output'}
+          </h3>
+          <div style={styles.outputActions}>
+            <button
+              onClick={handleDownload}
+              disabled={!output}
+              style={styles.buttonSecondary}
+            >
+              ⬇️ Download
+            </button>
+            <button
+              onClick={() => navigator.clipboard.writeText(output)}
+              disabled={!output}
+              style={styles.buttonSecondary}
+            >
+              📋 Copy
+            </button>
+          </div>
+        </div>
+        
+        <pre style={styles.output}>
+          {output || 'Результат появится здесь...'}
+        </pre>
+      </div>
+      
+      <div style={styles.info}>
+        <p>💡 <strong>Подсказки:</strong></p>
+        <ul style={styles.tipsList}>
+          <li>Используйте кнопку "Example" для быстрого заполнения</li>
+          <li>Загружайте CSV файлы через кнопку "Upload CSV"</li>
+          <li>Выберите разделитель соответствующий вашим данным</li>
+          <li>Скачивайте результат в нужном формате</li>
+        </ul>
+      </div>
+    </div>
+  );
+}
+
+const styles = {
+  container: {
+    maxWidth: '1200px',
+    margin: '0 auto',
+    padding: '20px',
+    fontFamily: 'system-ui, -apple-system, sans-serif'
+  },
+  title: {
+    color: '#333',
+    textAlign: 'center',
+    marginBottom: '30px'
+  },
+  controls: {
+    display: 'flex',
+    justifyContent: 'space-between',
+    alignItems: 'center',
+    marginBottom: '20px',
+    flexWrap: 'wrap',
+    gap: '20px'
+  },
+  formatSelector: {
+    display: 'flex',
+    gap: '20px'
+  },
+  delimiterSelector: {
+    display: 'flex',
+    alignItems: 'center',
+    gap: '10px'
+  },
+  select: {
+    padding: '5px 10px',
+    marginLeft: '10px',
+    borderRadius: '4px',
+    border: '1px solid #ccc'
+  },
+  inputSection: {
+    marginBottom: '20px'
+  },
+  inputHeader: {
+    display: 'flex',
+    justifyContent: 'space-between',
+    alignItems: 'center',
+    marginBottom: '10px'
+  },
+  inputActions: {
+    display: 'flex',
+    gap: '10px'
+  },
+  sectionTitle: {
+    margin: '0',
+    color: '#555'
+  },
+  textarea: {
+    width: '100%',
+    padding: '15px',
+    border: '1px solid #ddd',
+    borderRadius: '8px',
+    fontFamily: 'monospace',
+    fontSize: '14px',
+    resize: 'vertical',
+    boxSizing: 'border-box'
+  },
+  convertButtonContainer: {
+    display: 'flex',
+    flexDirection: 'column',
+    alignItems: 'center',
+    gap: '10px',
+    margin: '20px 0'
+  },
+  buttonPrimary: {
+    padding: '12px 30px',
+    background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+    color: 'white',
+    border: 'none',
+    borderRadius: '25px',
+    fontSize: '16px',
+    fontWeight: 'bold',
+    cursor: 'pointer',
+    transition: 'transform 0.2s'
+  },
+  buttonSecondary: {
+    padding: '8px 16px',
+    background: '#f0f0f0',
+    color: '#333',
+    border: '1px solid #ddd',
+    borderRadius: '4px',
+    cursor: 'pointer',
+    transition: 'background 0.2s'
+  },
+  stats: {
+    display: 'flex',
+    gap: '20px',
+    color: '#666',
+    fontSize: '14px'
+  },
+  error: {
+    padding: '15px',
+    background: '#fee',
+    border: '1px solid #f99',
+    borderRadius: '8px',
+    color: '#c00',
+    marginBottom: '20px'
+  },
+  outputSection: {
+    marginTop: '20px'
+  },
+  outputHeader: {
+    display: 'flex',
+    justifyContent: 'space-between',
+    alignItems: 'center',
+    marginBottom: '10px'
+  },
+  outputActions: {
+    display: 'flex',
+    gap: '10px'
+  },
+  output: {
+    padding: '15px',
+    background: '#f8f8f8',
+    border: '1px solid #ddd',
+    borderRadius: '8px',
+    minHeight: '200px',
+    overflow: 'auto',
+    whiteSpace: 'pre-wrap',
+    wordBreak: 'break-all',
+    fontFamily: 'monospace',
+    fontSize: '14px'
+  },
+  info: {
+    marginTop: '30px',
+    padding: '20px',
+    background: '#f0f8ff',
+    border: '1px solid #cce5ff',
+    borderRadius: '8px'
+  },
+  tipsList: {
+    margin: '10px 0 0 20px',
+    color: '#555'
+  }
+};
+

package/plugins/nextjs-api/examples/api-convert.js

@@ -65,5 +65,3 @@ export const config = {
  *   return jtcsvHandler(req, res);
  * }
  */
-
-

package/plugins/nextjs-api/examples/api-convert.ts

@@ -0,0 +1,67 @@
+/**
+ * Пример API route для Next.js
+ * Сохраните этот файл как pages/api/convert.js
+ * 
+ * @example
+ * // Запросы к API:
+ * // POST /api/convert с JSON телом → получите CSV
+ * // POST /api/convert с CSV телом → получите JSON
+ * // GET /api/convert/health → проверка состояния
+ */
+
+import { 
+  handler as jtcsvHandler,
+  csvToJsonHandler,
+  jsonToCsvHandler,
+  healthCheckHandler 
+} from '../../route';
+
+// Основной endpoint для автоматической конвертации
+export default jtcsvHandler;
+
+// Специализированные endpoints
+export const config = {
+  api: {
+    bodyParser: {
+      sizeLimit: '50mb'
+    }
+  }
+};
+
+// Альтернативная реализация с отдельными путями
+// export default async function handler(req, res) {
+//   const { path } = req.query;
+//   
+//   switch (path) {
+//     case 'csv-to-json':
+//       return csvToJsonHandler(req, res);
+//     case 'json-to-csv':
+//       return jsonToCsvHandler(req, res);
+//     case 'health':
+//       return healthCheckHandler(req, res);
+//     default:
+//       return jtcsvHandler(req, res);
+//   }
+// }
+
+/**
+ * Пример использования с кастомной логикой
+ * 
+ * export default async function handler(req, res) {
+ *   // Добавляем логирование
+ *   console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);
+ *   
+ *   // Проверяем аутентификацию
+ *   const apiKey = req.headers['x-api-key'];
+ *   if (!apiKey || apiKey !== process.env.API_KEY) {
+ *     return res.status(401).json({ error: 'Unauthorized' });
+ *   }
+ *   
+ *   // Ограничение по частоте запросов
+ *   const ip = req.headers['x-forwarded-for'] || req.connection.remoteAddress;
+ *   // ... rate limiting logic
+ *   
+ *   // Вызываем основной обработчик
+ *   return jtcsvHandler(req, res);
+ * }
+ */