jtcsv 2.2.8 → 3.1.0

package/plugins/express-middleware/example.js

@@ -1,136 +0,0 @@
-/**
- * Пример использования Express middleware для JTCSV
- * 
- * Запуск: node example.js
- * Затем отправьте запросы:
- * - POST /api/convert с JSON телом → получите CSV
- * - POST /api/convert с CSV телом → получите JSON
- * - POST /api/csv-to-json → конвертация CSV в JSON
- * - POST /api/json-to-csv → конвертация JSON в CSV
- * - GET /api/health → проверка состояния
- */
-
-const express = require('express');
-const bodyParser = require('body-parser');
-const { 
-  middleware, 
-  csvToJsonRoute, 
-  jsonToCsvRoute, 
-  healthCheck 
-} = require('./index');
-
-const app = express();
-const PORT = process.env.PORT || 3000;
-
-// Middleware для парсинга JSON и текста
-app.use(bodyParser.json());
-app.use(bodyParser.text({ type: 'text/csv' }));
-
-// Добавляем время начала обработки запроса
-app.use((req, res, next) => {
-  req.startTime = Date.now();
-  next();
-});
-
-// Основное middleware для автоматической конвертации
-app.use(middleware({
-  maxSize: '50mb',
-  delimiter: ',',
-  enableFastPath: true,
-  preventCsvInjection: true
-}));
-
-// Роуты для конкретных операций
-app.post('/api/csv-to-json', csvToJsonRoute({
-  delimiter: ',',
-  parseNumbers: true,
-  parseBooleans: true
-}));
-
-app.post('/api/json-to-csv', jsonToCsvRoute({
-  delimiter: ',',
-  includeHeaders: true,
-  preventCsvInjection: true
-}));
-
-// Health check
-app.get('/api/health', healthCheck());
-
-// Пример роута, использующего автоматическую конвертацию
-app.post('/api/convert', (req, res) => {
-  if (!req.converted) {
-    return res.status(400).json({
-      success: false,
-      error: 'No data to convert'
-    });
-  }
-
-  res.json({
-    success: true,
-    conversion: req.converted.conversion,
-    data: req.converted.data,
-    stats: {
-      ...req.converted.stats,
-      totalTime: Date.now() - req.startTime
-    },
-    format: req.converted.outputFormat
-  });
-});
-
-// Пример роута для скачивания CSV
-app.post('/api/download-csv', (req, res) => {
-  if (!req.converted || req.converted.outputFormat !== 'csv') {
-    return res.status(400).json({
-      success: false,
-      error: 'CSV data not available'
-    });
-  }
-
-  res.setHeader('Content-Type', 'text/csv');
-  res.setHeader('Content-Disposition', 'attachment; filename="converted.csv"');
-  res.send(req.converted.data);
-});
-
-// Обработка ошибок
-app.use((err, req, res, next) => {
-  console.error('Server error:', err);
-  res.status(500).json({
-    success: false,
-    error: 'Internal server error',
-    message: process.env.NODE_ENV === 'development' ? err.message : undefined
-  });
-});
-
-// 404 handler
-app.use((req, res) => {
-  res.status(404).json({
-    success: false,
-    error: 'Route not found',
-    availableRoutes: [
-      'POST /api/convert',
-      'POST /api/csv-to-json',
-      'POST /api/json-to-csv',
-      'POST /api/download-csv',
-      'GET /api/health'
-    ]
-  });
-});
-
-// Запуск сервера
-app.listen(PORT, () => {
-  console.log(`🚀 JTCSV Express server запущен на порту ${PORT}`);
-  console.log(`📚 Примеры запросов:`);
-  console.log(`  curl -X POST http://localhost:${PORT}/api/convert \
-    -H "Content-Type: application/json" \
-    -d '[{"name":"John","age":30},{"name":"Jane","age":25}]'`);
-  console.log();
-  console.log(`  curl -X POST http://localhost:${PORT}/api/convert \
-    -H "Content-Type: text/csv" \
-    -d 'name,age\nJohn,30\nJane,25'`);
-  console.log();
-  console.log(`  curl -X GET http://localhost:${PORT}/api/health`);
-});
-
-module.exports = app;
-
-

package/plugins/express-middleware/index.d.ts

@@ -1,114 +0,0 @@
-/**
- * TypeScript definitions для JTCSV Express Middleware
- * 
- * @version 1.0.0
- * @date 2026-01-23
- */
-
-declare module '@jtcsv/express-middleware' {
-  import { RequestHandler } from 'express';
-  import { CsvToJsonOptions, JsonToCsvOptions } from 'jtcsv
-
-  export interface JtcsvMiddlewareOptions {
-    /** Максимальный размер тела запроса */
-    maxSize?: string;
-    
-    /** Автоматическое определение формата */
-    autoDetect?: boolean;
-    
-    /** Разделитель CSV */
-    delimiter?: string;
-    
-    /** Включить Fast-Path Engine */
-    enableFastPath?: boolean;
-    
-    /** Защита от CSV инъекций */
-    preventCsvInjection?: boolean;
-    
-    /** Соответствие RFC 4180 */
-    rfc4180Compliant?: boolean;
-    
-    /** Дополнительные опции конвертации */
-    conversionOptions?: CsvToJsonOptions | JsonToCsvOptions;
-  }
-
-  export interface ConversionStats {
-    /** Размер входных данных в байтах */
-    inputSize: number;
-    
-    /** Размер выходных данных в байтах */
-    outputSize: number;
-    
-    /** Время обработки в миллисекундах */
-    processingTime: number;
-    
-    /** Тип конвертации */
-    conversion: string;
-  }
-
-  export interface ConvertedData {
-    /** Конвертированные данные */
-    data: any;
-    
-    /** Формат выходных данных */
-    format: 'json' | 'csv';
-    
-    /** Формат входных данных */
-    inputFormat: 'json' | 'csv' | 'unknown';
-    
-    /** Формат выходных данных */
-    outputFormat: 'json' | 'csv';
-    
-    /** Статистика конвертации */
-    stats: ConversionStats;
-    
-    /** Использованные опции */
-    options: CsvToJsonOptions | JsonToCsvOptions;
-  }
-
-  // Расширяем интерфейс Request Express
-  declare global {
-    namespace Express {
-      interface Request {
-        /** Конвертированные данные */
-        converted?: ConvertedData;
-        
-        /** Время начала обработки запроса */
-        startTime?: number;
-      }
-    }
-  }
-
-  /**
-   * Express middleware для автоматической конвертации CSV/JSON
-   */
-  export function middleware(options?: JtcsvMiddlewareOptions): RequestHandler;
-  
-  /**
-   * Express route для конвертации CSV в JSON
-   */
-  export function csvToJsonRoute(options?: CsvToJsonOptions): RequestHandler;
-  
-  /**
-   * Express route для конвертации JSON в CSV
-   */
-  export function jsonToCsvRoute(options?: JsonToCsvOptions): RequestHandler;
-  
-  /**
-   * Express route для загрузки CSV файла
-   */
-  export function uploadCsvRoute(options?: CsvToJsonOptions): RequestHandler;
-  
-  /**
-   * Health check endpoint
-   */
-  export function healthCheck(): RequestHandler;
-  
-  // Aliases
-  export const jtcsvMiddleware: typeof middleware;
-  export const createMiddleware: typeof middleware;
-}
-
-export {};
-
-

package/plugins/express-middleware/index.js

@@ -1,360 +0,0 @@
-/**
- * Express middleware для JTCSV
- * Автоматическая конвертация CSV/JSON в HTTP запросах
- * 
- * @version 1.0.0
- * @date 2026-01-23
- */
-
-const { csvToJson, jsonToCsv } = require('../../index.js');
-
-/**
- * Express middleware для обработки CSV/JSON конвертации
- * 
- * @param {Object} options - Опции middleware
- * @param {string} options.maxSize - Максимальный размер тела запроса (default: '10mb')
- * @param {boolean} options.autoDetect - Автоматическое определение формата (default: true)
- * @param {string} options.delimiter - Разделитель CSV (default: ',')
- * @param {boolean} options.enableFastPath - Включить Fast-Path Engine (default: true)
- * @param {boolean} options.preventCsvInjection - Защита от CSV инъекций (default: true)
- * 
- * @returns {Function} Express middleware
- * 
- * @example
- * // Базовое использование
- * const app = express();
- * app.use(express.json());
- * app.use(express.text({ type: 'text/csv' }));
- * app.use(jtcsvMiddleware());
- * 
- * @example
- * // С кастомными опциями
- * app.use(jtcsvMiddleware({
- *   maxSize: '50mb',
- *   delimiter: ';',
- *   enableFastPath: true
- * }));
- * 
- * @example
- * // Использование в роуте
- * app.post('/api/convert', (req, res) => {
- *   // Конвертированные данные доступны в req.converted
- *   res.json({
- *     success: true,
- *     data: req.converted.data,
- *     format: req.converted.format
- *   });
- * });
- */
-function jtcsvExpressMiddleware(options = {}) {
-  const {
-    maxSize = '10mb',
-    autoDetect = true,
-    delimiter = ',',
-    enableFastPath = true,
-    preventCsvInjection = true,
-    rfc4180Compliant = true
-  } = options;
-
-  return async (req, res, next) => {
-    // Пропускаем запросы без тела
-    if (!req.body || (typeof req.body !== 'string' && typeof req.body !== 'object')) {
-      return next();
-    }
-
-    const contentType = req.get('content-type') || '';
-    const acceptHeader = req.get('accept') || 'application/json';
-    
-    try {
-      // Определяем формат входных данных
-      let inputFormat = 'unknown';
-      let inputData = req.body;
-      
-      if (autoDetect) {
-        if (contentType.includes('application/json') || 
-            (typeof req.body === 'object' && !Array.isArray(req.body))) {
-          inputFormat = 'json';
-        } else if (contentType.includes('text/csv') || 
-                  contentType.includes('text/plain') ||
-                  (typeof req.body === 'string' && req.body.includes(','))) {
-          inputFormat = 'csv';
-        }
-      } else {
-        // Ручное определение на основе content-type
-        if (contentType.includes('application/json')) {
-          inputFormat = 'json';
-        } else if (contentType.includes('text/csv')) {
-          inputFormat = 'csv';
-        }
-      }
-
-      // Если формат не определен, пропускаем
-      if (inputFormat === 'unknown') {
-        return next();
-      }
-
-      // Определяем желаемый формат вывода на основе Accept header
-      let outputFormat = 'json';
-      if (acceptHeader.includes('text/csv')) {
-        outputFormat = 'csv';
-      } else if (req.query.format === 'csv') {
-        outputFormat = 'csv';
-      } else if (req.body.format === 'csv') {
-        outputFormat = 'csv';
-      }
-
-      // Опции конвертации
-      const conversionOptions = {
-        delimiter,
-        preventCsvInjection,
-        rfc4180Compliant,
-        useFastPath: enableFastPath,
-        ...req.query,
-        ...options.conversionOptions
-      };
-
-      // Удаляем параметры, которые не относятся к конвертации
-      delete conversionOptions.maxSize;
-      delete conversionOptions.autoDetect;
-      delete conversionOptions.enableFastPath;
-
-      let result;
-      let stats = {
-        inputSize: 0,
-        outputSize: 0,
-        processingTime: 0,
-        conversion: `${inputFormat}→${outputFormat}`
-      };
-
-      const startTime = Date.now();
-
-      // Выполняем конвертацию
-      if (inputFormat === 'json' && outputFormat === 'csv') {
-        const jsonData = typeof inputData === 'string' ? JSON.parse(inputData) : inputData;
-        stats.inputSize = Buffer.byteLength(JSON.stringify(jsonData));
-        
-        result = await jsonToCsv(jsonData, conversionOptions);
-        stats.outputSize = Buffer.byteLength(result);
-        
-      } else if (inputFormat === 'csv' && outputFormat === 'json') {
-        const csvData = typeof inputData === 'string' ? inputData : String(inputData);
-        stats.inputSize = Buffer.byteLength(csvData);
-        
-        result = await csvToJson(csvData, conversionOptions);
-        stats.outputSize = Buffer.byteLength(JSON.stringify(result));
-        
-      } else {
-        // Нет необходимости в конвертации
-        result = inputData;
-        stats.conversion = 'none';
-      }
-
-      stats.processingTime = Date.now() - startTime;
-
-      // Сохраняем результат в request object
-      req.converted = {
-        data: result,
-        format: outputFormat,
-        inputFormat,
-        outputFormat,
-        stats,
-        options: conversionOptions
-      };
-
-      // Устанавливаем соответствующий Content-Type для ответа
-      if (outputFormat === 'csv') {
-        res.set('Content-Type', 'text/csv; charset=utf-8');
-      } else {
-        res.set('Content-Type', 'application/json; charset=utf-8');
-      }
-
-      next();
-
-    } catch (error) {
-      // Обработка ошибок конвертации
-      const errorResponse = {
-        success: false,
-        error: error.message,
-        code: error.code || 'CONVERSION_ERROR',
-        timestamp: new Date().toISOString()
-      };
-
-      // Добавляем дополнительную информацию для отладки
-      if (process.env.NODE_ENV === 'development') {
-        errorResponse.stack = error.stack;
-        errorResponse.details = {
-          contentType: req.get('content-type'),
-          contentLength: req.get('content-length'),
-          method: req.method,
-          url: req.url
-        };
-      }
-
-      res.status(400).json(errorResponse);
-    }
-  };
-}
-
-/**
- * Express route для конвертации CSV в JSON
- * 
- * @param {Object} options - Опции конвертации
- * @returns {Function} Express route handler
- * 
- * @example
- * app.post('/api/csv-to-json', jtcsvCsvToJsonRoute());
- */
-function jtcsvCsvToJsonRoute(options = {}) {
-  return async (req, res) => {
-    try {
-      const csvData = req.body;
-      
-      if (!csvData || (typeof csvData !== 'string' && !Buffer.isBuffer(csvData))) {
-        return res.status(400).json({
-          success: false,
-          error: 'CSV data is required'
-        });
-      }
-
-      const result = await csvToJson(csvData, options);
-      
-      res.json({
-        success: true,
-        data: result,
-        stats: {
-          rows: result.length,
-          processingTime: Date.now() - req.startTime
-        }
-      });
-    } catch (error) {
-      res.status(400).json({
-        success: false,
-        error: error.message
-      });
-    }
-  };
-}
-
-/**
- * Express route для конвертации JSON в CSV
- * 
- * @param {Object} options - Опции конвертации
- * @returns {Function} Express route handler
- * 
- * @example
- * app.post('/api/json-to-csv', jtcsvJsonToCsvRoute());
- */
-function jtcsvJsonToCsvRoute(options = {}) {
-  return async (req, res) => {
-    try {
-      const jsonData = req.body;
-      
-      if (!jsonData || (typeof jsonData !== 'object' && typeof jsonData !== 'string')) {
-        return res.status(400).json({
-          success: false,
-          error: 'JSON data is required'
-        });
-      }
-
-      const data = typeof jsonData === 'string' ? JSON.parse(jsonData) : jsonData;
-      const result = await jsonToCsv(data, options);
-      
-      res.set('Content-Type', 'text/csv; charset=utf-8');
-      res.set('Content-Disposition', 'attachment; filename="data.csv"');
-      
-      res.send(result);
-    } catch (error) {
-      res.status(400).json({
-        success: false,
-        error: error.message
-      });
-    }
-  };
-}
-
-/**
- * Express route для загрузки CSV файла
- * 
- * @param {Object} options - Опции конвертации
- * @returns {Function} Express route handler
- * 
- * @example
- * const multer = require('multer');
- * const upload = multer({ dest: 'uploads/' });
- * app.post('/api/upload-csv', upload.single('file'), jtcsvUploadCsvRoute());
- */
-function jtcsvUploadCsvRoute(options = {}) {
-  return async (req, res) => {
-    try {
-      if (!req.file) {
-        return res.status(400).json({
-          success: false,
-          error: 'CSV file is required'
-        });
-      }
-
-      const fs = require('fs').promises;
-      const csvData = await fs.readFile(req.file.path, 'utf8');
-      
-      const result = await csvToJson(csvData, options);
-      
-      // Очищаем временный файл
-      await fs.unlink(req.file.path);
-      
-      res.json({
-        success: true,
-        data: result,
-        stats: {
-          rows: result.length,
-          fileSize: req.file.size,
-          processingTime: Date.now() - req.startTime
-        }
-      });
-    } catch (error) {
-      res.status(400).json({
-        success: false,
-        error: error.message
-      });
-    }
-  };
-}
-
-/**
- * Health check endpoint для JTCSV
- * 
- * @returns {Function} Express route handler
- * 
- * @example
- * app.get('/api/health', jtcsvHealthCheck());
- */
-function jtcsvHealthCheck() {
-  return (req, res) => {
-    res.json({
-      service: 'jtcsv-express-middleware',
-      status: 'healthy',
-      version: '1.0.0',
-      timestamp: new Date().toISOString(),
-      features: {
-        csvToJson: true,
-        jsonToCsv: true,
-        fastPathEngine: true,
-        csvInjectionProtection: true,
-        streaming: true
-      }
-    });
-  };
-}
-
-module.exports = {
-  middleware: jtcsvExpressMiddleware,
-  csvToJsonRoute: jtcsvCsvToJsonRoute,
-  jsonToCsvRoute: jtcsvJsonToCsvRoute,
-  uploadCsvRoute: jtcsvUploadCsvRoute,
-  healthCheck: jtcsvHealthCheck,
-  
-  // Aliases для удобства
-  jtcsvMiddleware: jtcsvExpressMiddleware,
-  createMiddleware: jtcsvExpressMiddleware
-};
-
-

package/plugins/express-middleware/package.json

@@ -1,52 +0,0 @@
-{
-  "name": "@jtcsv/express-middleware",
-  "version": "1.0.0",
-  "description": "Express middleware для автоматической конвертации CSV/JSON в HTTP запросах",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "scripts": {
-    "test": "jest",
-    "lint": "eslint index.js",
-    "example": "node example.js"
-  },
-  "keywords": [
-    "express",
-    "middleware",
-    "csv",
-    "json",
-    "converter",
-    "jtcsv",
-    "api",
-    "rest",
-    "http"
-  ],
-  "author": "Ruslan Fomenko",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Linol-Hamelton/jtcsv.git",
-    "directory": "plugins/express-middleware"
-  },
-  "bugs": {
-    "url": "https://github.com/Linol-Hamelton/jtcsv/issues"
-  },
-  "homepage": "https://github.com/Linol-Hamelton/jtcsv/tree/main/plugins/express-middleware#readme",
-  "peerDependencies": {
-    "express": "^4.18.0",
-    "jtcsv": "^2.1.0"
-  },
-  "devDependencies": {
-    "express": "^4.18.0",
-    "jest": "^29.0.0",
-    "eslint": "^8.57.0",
-    "supertest": "^6.3.0"
-  },
-  "files": [
-    "index.js",
-    "index.d.ts",
-    "README.md",
-    "example.js"
-  ]
-}
-
-