jtcsv 3.0.0 → 3.1.1

package/plugins/README.md

@@ -1,91 +0,0 @@
-# JTCSV framework integrations
-
-This folder contains optional adapters published as separate packages. Each adapter depends on `jtcsv`.
-
-## Available packages
-- @jtcsv/express-middleware
-- @jtcsv/fastify
-- @jtcsv/nextjs
-- @jtcsv/nestjs
-- @jtcsv/remix
-- @jtcsv/nuxt
-- @jtcsv/sveltekit
-- @jtcsv/hono
-- @jtcsv/trpc
-
-## Main package shortcuts
-If you already depend on `jtcsv`, the adapters are also exported from the main package:
-- jtcsv/express
-- jtcsv/fastify
-- jtcsv/nextjs
-- jtcsv/nextjs/route
-- jtcsv/nestjs
-- jtcsv/remix
-- jtcsv/nuxt
-- jtcsv/sveltekit
-- jtcsv/hono
-- jtcsv/trpc
-
-## Express
-```bash
-npm install @jtcsv/express-middleware express jtcsv
-```
-```javascript
-const express = require('express');
-const { middleware } = require('@jtcsv/express-middleware');
-
-const app = express();
-app.use(express.json());
-app.use(express.text({ type: 'text/csv' }));
-app.use(middleware());
-```
-
-## Fastify
-```bash
-npm install @jtcsv/fastify fastify fastify-plugin jtcsv
-```
-```javascript
-const fastify = require('fastify')();
-await fastify.register(require('@jtcsv/fastify'), { prefix: '/api' });
-```
-
-## Next.js
-```bash
-npm install @jtcsv/nextjs jtcsv
-```
-```javascript
-import handler from '@jtcsv/nextjs/route';
-export default handler;
-```
-
-## NestJS
-```bash
-npm install @jtcsv/nestjs jtcsv
-```
-
-## Remix
-```bash
-npm install @jtcsv/remix jtcsv
-```
-
-## Nuxt
-```bash
-npm install @jtcsv/nuxt jtcsv
-```
-
-## SvelteKit
-```bash
-npm install @jtcsv/sveltekit jtcsv
-```
-
-## Hono
-```bash
-npm install @jtcsv/hono jtcsv
-```
-
-## tRPC
-```bash
-npm install @jtcsv/trpc jtcsv
-```
-
-See each package README in this folder for API details.

package/plugins/express-middleware/README.md

@@ -1,83 +0,0 @@
-# @jtcsv/express-middleware
-
-Express middleware that converts CSV/JSON payloads and exposes the converted data on `req.converted`.
-
-## Install
-```bash
-npm install @jtcsv/express-middleware express jtcsv
-```
-
-## Quick start
-```javascript
-const express = require('express');
-const { middleware } = require('@jtcsv/express-middleware');
-
-const app = express();
-app.use(express.json());
-app.use(express.text({ type: 'text/csv' }));
-app.use(middleware());
-
-app.post('/api/convert', (req, res) => {
-  res.json(req.converted);
-});
-```
-
-## Options
-The middleware detects input/output format based on `Content-Type`, `Accept`, and `?format=csv`.
-
-```javascript
-app.use(middleware({
-  autoDetect: true,
-  delimiter: ',',
-  enableFastPath: true,
-  preventCsvInjection: true,
-  rfc4180Compliant: true,
-  // Security & DoS protection
-  maxFileSize: '500MB',          // Maximum allowed file size (default: 500MB)
-  maxFieldSize: 1024 * 1024,     // Maximum field size in bytes (default: 1MB)
-  timeout: 300000,               // Processing timeout in milliseconds (default: 5 minutes)
-  // Conversion options
-  conversionOptions: {
-    parseNumbers: true,
-    parseBooleans: true
-  }
-}));
-```
-
-**Security notes**:
-- `maxFileSize` rejects requests with `Content-Length` exceeding the limit (HTTP 413).
-- `maxFieldSize` limits individual field size during parsing (helps prevent memory exhaustion).
-- `timeout` cancels long-running conversions and returns HTTP 503.
-- For additional protection, combine with `express-rate-limit` and body parser limits.
-
-**Example with rate limiting**:
-```javascript
-const rateLimit = require('express-rate-limit');
-const importLimiter = rateLimit({
-  windowMs: 15 * 60 * 1000, // 15 minutes
-  max: 10 // limit each IP to 10 requests per window
-});
-app.post('/api/import', importLimiter, middleware());
-```
-
-## Helpers
-```javascript
-const {
-  csvToJsonRoute,
-  jsonToCsvRoute,
-  uploadCsvRoute,
-  healthCheck
-} = require('@jtcsv/express-middleware');
-```
-
-## req.converted shape
-```json
-{
-  "data": "...",
-  "format": "json",
-  "inputFormat": "csv",
-  "outputFormat": "json",
-  "stats": { "inputSize": 0, "outputSize": 0, "processingTime": 0, "conversion": "csv->json" },
-  "options": {}
-}
-```

package/plugins/express-middleware/example.js

@@ -1,135 +0,0 @@
-// @ts-nocheck
-/**
- * Пример использования 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/example.ts

@@ -1,135 +0,0 @@
-// @ts-nocheck
-/**
- * Пример использования 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 → проверка состояния
- */
-
-import express from "express";
-import bodyParser from "body-parser";
-const {  
-  middleware, 
-  csvToJsonRoute, 
-  jsonToCsvRoute, 
-  healthCheck 
- } = await import("./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`);
-});
-
-export default 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 {};
-
-