jtcsv 2.2.7 → 3.0.0

package/json-save.js

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * JSON Save Module - Node.js Module
  * 
@@ -21,17 +22,22 @@ const {
  */
 function validateJsonFilePath(filePath) {
   const path = require('path');
-  
+
   // Basic validation
   if (typeof filePath !== 'string' || filePath.trim() === '') {
     throw new ValidationError('File path must be a non-empty string');
   }
-  
+
   // Ensure file has .json extension
   if (!filePath.toLowerCase().endsWith('.json')) {
     throw new ValidationError('File must have .json extension');
   }
-  
+
+  // Block UNC paths BEFORE path.resolve() to avoid network lookup timeouts
+  if (filePath.startsWith('\\\\') || filePath.startsWith('//')) {
+    throw new SecurityError('UNC paths are not allowed');
+  }
+
   // Get absolute path and check for traversal
   const absolutePath = path.resolve(filePath);
   const normalizedPath = path.normalize(filePath);

package/json-to-csv.js

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * JSON to CSV Converter - Node.js Module
  * 
@@ -74,33 +75,50 @@ function validateInput(data, options) {
 
 /**
  * Converts JSON data to CSV format
- * 
+ *
  * @param {Array<Object>} data - Array of objects to convert to CSV
  * @param {Object} [options] - Configuration options
  * @param {string} [options.delimiter=';'] - CSV delimiter character
  * @param {boolean} [options.includeHeaders=true] - Whether to include headers row
  * @param {Object} [options.renameMap={}] - Map for renaming column headers (oldKey: newKey)
-* @param {Object} [options.template={}] - Template object to ensure consistent column order
+ * @param {Object} [options.template={}] - Template object to ensure consistent column order
  * @param {number} [options.maxRecords] - Maximum number of records to process (optional, no limit by default)
  * @param {boolean} [options.preventCsvInjection=true] - Prevent CSV injection attacks by escaping formulas
  * @param {boolean} [options.rfc4180Compliant=true] - Ensure RFC 4180 compliance (proper quoting, line endings)
  * @param {Object} [options.schema] - JSON schema for data validation and formatting
+ * @param {boolean} [options.flatten=false] - Whether to flatten nested objects into dot notation keys
+ * @param {string} [options.flattenSeparator='.'] - Separator for flattened keys (e.g., 'user.name' with '.')
+ * @param {number} [options.flattenMaxDepth=3] - Maximum depth for flattening nested objects
+ * @param {string} [options.arrayHandling='stringify'] - How to handle arrays ('stringify', 'join', 'expand')
  * @returns {string} CSV formatted string
- * 
+ *
  * @example
  * const jsonToCsv = require('./json-to-csv');
- * 
+ *
  * const data = [
  *   { id: 1, name: 'John', email: 'john@example.com' },
  *   { id: 2, name: 'Jane', email: 'jane@example.com' }
  * ];
- * 
+ *
  * const csv = jsonToCsv(data, {
  *   delimiter: ',',
  *   renameMap: { id: 'ID', name: 'Full Name' },
  *   preventCsvInjection: true,
  *   rfc4180Compliant: true
  * });
+ *
+ * @example
+ * // With nested object flattening
+ * const nestedData = [
+ *   { id: 1, user: { name: 'John', profile: { age: 30 } } }
+ * ];
+ * const csv = jsonToCsv(nestedData, {
+ *   flatten: true,
+ *   flattenSeparator: '_',
+ *   flattenMaxDepth: 4
+ * });
+ * // Result: id,user_name,user_profile_age
+ * //         1,John,30
  */
 function jsonToCsv(data, options = {}) {
   return safeExecute(() => {
@@ -117,7 +135,11 @@ function jsonToCsv(data, options = {}) {
       maxRecords,
       preventCsvInjection = true,
       rfc4180Compliant = true,
-      schema = null
+      schema = null,
+      flatten = false,
+      flattenSeparator = '.',
+      flattenMaxDepth = 3,
+      _arrayHandling = 'stringify'
     } = opts;
 
     // Initialize schema validators if schema is provided
@@ -150,11 +172,19 @@ function jsonToCsv(data, options = {}) {
       );
     }
 
+    // Preprocess data with flattening options if needed
+    const processedData = preprocessData(data, {
+      flatten,
+      flattenSeparator,
+      flattenMaxDepth,
+      arrayHandling: _arrayHandling
+    });
+
     // Get all unique keys from all objects with minimal allocations.
     const allKeys = new Set();
     const originalKeys = [];
-    for (let i = 0; i < data.length; i++) {
-      const item = data[i];
+    for (let i = 0; i < processedData.length; i++) {
+      const item = processedData[i];
       if (!item || typeof item !== 'object') {
         continue;
       }
@@ -231,15 +261,23 @@ function jsonToCsv(data, options = {}) {
       let stringValue = value;
       if (typeof stringValue !== 'string') {
         stringValue = String(stringValue);
-      }
-      
+      }       
       // CSV Injection protection - escape formulas if enabled
       let escapedValue = stringValue;
       if (preventCsvInjection) {
         const firstCharCode = stringValue.charCodeAt(0);
-        if (firstCharCode === 61 || firstCharCode === 43 || firstCharCode === 45 || firstCharCode === 64) {
+        // Dangerous prefixes: =, +, -, @, tab (\t), carriage return (\r)
+        if (firstCharCode === 61 || firstCharCode === 43 || firstCharCode === 45 || firstCharCode === 64 ||
+            firstCharCode === 9 || firstCharCode === 13) {
           escapedValue = "'" + stringValue;
         }
+        // Unicode Bidi override characters
+        const bidiChars = ['\u202A', '\u202B', '\u202C', '\u202D', '\u202E'];
+        for (const bidi of bidiChars) {
+          if (stringValue.includes(bidi)) {
+            escapedValue = escapedValue.replace(new RegExp(bidi, 'g'), '');
+          }
+        }
       }
 
       let needsQuoting = false;
@@ -273,8 +311,8 @@ function jsonToCsv(data, options = {}) {
 
     // Add data rows.
     const rowValues = new Array(columnCount);
-    for (let rowIndex = 0; rowIndex < data.length; rowIndex++) {
-      const item = data[rowIndex];
+    for (let rowIndex = 0; rowIndex < processedData.length; rowIndex++) {
+      const item = processedData[rowIndex];
       if (!item || typeof item !== 'object') {
         continue;
       }
@@ -317,15 +355,96 @@ function jsonToCsv(data, options = {}) {
   }, 'PARSE_FAILED', { function: 'jsonToCsv' });
 }
 
+/**
+ * Flattens nested objects into single-level objects with dot notation keys
+ *
+ * @private
+ * @param {Object} obj - Object to flatten
+ * @param {string} prefix - Current key prefix
+ * @param {string} separator - Separator for nested keys (default: '.')
+ * @param {number} maxDepth - Maximum flattening depth
+ * @param {number} currentDepth - Current recursion depth
+ * @returns {Object} Flattened object
+ *
+ * @example
+ * flattenObject({ a: 1, b: { c: 2, d: { e: 3 } } });
+ * // Returns { 'a': 1, 'b.c': 2, 'b.d.e': 3 }
+ */
+function flattenObject(obj, prefix = '', separator = '.', maxDepth = 3, currentDepth = 0) {
+  // Handle null/undefined
+  if (obj === null || obj === undefined) {
+    return { [prefix || 'value']: '' };
+  }
+  
+  // Handle primitive values
+  if (typeof obj !== 'object') {
+    return { [prefix || 'value']: obj };
+  }
+  
+  // Handle arrays
+  if (Array.isArray(obj)) {
+    if (obj.length === 0) {
+      return { [prefix || 'value']: '' };
+    }
+    
+    // For simple arrays, join with comma
+    if (obj.every(item => typeof item === 'string' || typeof item === 'number' || typeof item === 'boolean')) {
+      return { [prefix || 'value']: obj.join(', ') };
+    }
+    
+    // For complex arrays, stringify
+    try {
+      return { [prefix || 'value']: JSON.stringify(obj) };
+    } catch {
+      return { [prefix || 'value']: '[Complex Array]' };
+    }
+  }
+  
+  // Check depth limit
+  if (currentDepth >= maxDepth) {
+    try {
+      return { [prefix || 'value']: JSON.stringify(obj) };
+    } catch {
+      return { [prefix || 'value']: '[Too Deep]' };
+    }
+  }
+  
+  const result = {};
+  
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      const value = obj[key];
+      const newKey = prefix ? `${prefix}${separator}${key}` : key;
+      
+      if (value && typeof value === 'object') {
+        // Recursively flatten nested objects
+        const flattened = flattenObject(
+          value,
+          newKey,
+          separator,
+          maxDepth,
+          currentDepth + 1
+        );
+        Object.assign(result, flattened);
+      } else {
+        // Primitive values
+        result[newKey] = value === null || value === undefined ? '' : value;
+      }
+    }
+  }
+  
+  return result;
+}
+
 /**
  * Deeply unwraps nested objects and arrays to extract primitive values
- * 
+ *
  * @param {*} value - Value to unwrap
  * @param {number} [depth=0] - Current recursion depth
  * @param {number} [maxDepth=5] - Maximum recursion depth
  * @param {Set} [visited=new Set()] - Set of visited objects to detect circular references
  * @returns {string} Unwrapped string value
- * 
+ *
  * @private
  */
 function deepUnwrap(value, depth = 0, maxDepth = 5, visited = new Set()) {
@@ -386,15 +505,33 @@ function deepUnwrap(value, depth = 0, maxDepth = 5, visited = new Set()) {
 
 /**
  * Preprocesses JSON data by deeply unwrapping nested structures
- * 
+ *
  * @param {Array<Object>} data - Array of objects to preprocess
+ * @param {Object} [options] - Preprocessing options
+ * @param {boolean} [options.flatten=false] - Whether to flatten nested objects
+ * @param {string} [options.flattenSeparator='.'] - Separator for flattened keys
+ * @param {number} [options.flattenMaxDepth=3] - Maximum flattening depth
+ * @param {string} [options.arrayHandling='stringify'] - How to handle arrays ('stringify', 'join', 'expand')
  * @returns {Array<Object>} Preprocessed data with unwrapped values
- * 
+ *
  * @example
+ * // Standard preprocessing
  * const processed = preprocessData(complexJsonData);
  * const csv = jsonToCsv(processed);
+ *
+ * @example
+ * // With flattening
+ * const flattened = preprocessData(complexJsonData, { flatten: true });
+ * const csv = jsonToCsv(flattened);
  */
-function preprocessData(data) {
+function preprocessData(data, options = {}) {
+  const {
+    flatten = false,
+    flattenSeparator = '.',
+    flattenMaxDepth = 3,
+    _arrayHandling = 'stringify'
+  } = options;
+  
   if (!Array.isArray(data)) {
     return [];
   }
@@ -404,6 +541,11 @@ function preprocessData(data) {
       return {};
     }
     
+    if (flatten) {
+      return flattenObject(item, '', flattenSeparator, flattenMaxDepth);
+    }
+    
+    // Standard processing (backward compatibility)
     const processed = {};
     
     for (const key in item) {
@@ -427,17 +569,22 @@ function preprocessData(data) {
  */
 function validateFilePath(filePath) {
   const path = require('path');
-  
+
   // Basic validation
   if (typeof filePath !== 'string' || filePath.trim() === '') {
     throw new ValidationError('File path must be a non-empty string');
   }
-  
+
   // Ensure file has .csv extension
   if (!filePath.toLowerCase().endsWith('.csv')) {
     throw new ValidationError('File must have .csv extension');
   }
-  
+
+  // Block UNC paths BEFORE path.resolve() to avoid network lookup timeouts
+  if (filePath.startsWith('\\\\') || filePath.startsWith('//')) {
+    throw new SecurityError('UNC paths are not allowed');
+  }
+
   // Get absolute path and check for traversal
   const absolutePath = path.resolve(filePath);
   const normalizedPath = path.normalize(filePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jtcsv",
-  "version": "2.2.7",
+  "version": "3.0.0",
   "description": "Complete JSON<->CSV and CSV<->JSON converter for Node.js and Browser with streaming, security, Web Workers, TypeScript support, and optional ecosystem (zero-deps core)",
   "main": "index.js",
   "browser": "dist/jtcsv.umd.js",
@@ -76,11 +76,38 @@
       "require": "./plugins/trpc/index.js",
       "import": "./plugins/trpc/index.js",
       "default": "./plugins/trpc/index.js"
+    },
+    "./core": {
+      "require": "./dist/jtcsv-core.cjs.js",
+      "import": "./dist/jtcsv-core.esm.js",
+      "browser": "./dist/jtcsv-core.umd.js",
+      "default": "./dist/jtcsv-core.cjs.js"
+    },
+    "./full": {
+      "require": "./dist/jtcsv-full.cjs.js",
+      "import": "./dist/jtcsv-full.esm.js",
+      "browser": "./dist/jtcsv-full.umd.js",
+      "default": "./dist/jtcsv-full.cjs.js"
+    },
+    "./workers": {
+      "require": "./dist/jtcsv-workers.cjs.js",
+      "import": "./dist/jtcsv-workers.esm.js",
+      "browser": "./dist/jtcsv-workers.umd.js",
+      "default": "./dist/jtcsv-workers.esm.js"
+    },
+    "./optimized": {
+      "require": "./dist/jtcsv-core.cjs.js",
+      "import": "./dist/jtcsv-core.esm.js",
+      "browser": "./dist/jtcsv-core.umd.js",
+      "default": "./dist/jtcsv-core.cjs.js"
     }
   },
   "scripts": {
     "test": "jest",
-    "test:coverage": "jest --coverage",
+    "test:unit": "jest --testPathIgnorePatterns=\"(__tests__/benchmark-suite.test.js|__tests__/load-tests.test.js|__tests__/soak-memory.test.js|__tests__/security-fuzzing.test.js|__tests__/memory-profiling.test.js)\"",
+    "test:coverage": "node scripts/run-coverage.js --target=js --scope=full --strict=0",
+    "test:coverage:entry": "node scripts/run-coverage.js --target=js --scope=entry --strict=1",
+    "test:coverage:ts": "node scripts/run-coverage.js --target=ts --scope=full --strict=0",
     "test:watch": "jest --watch",
     "test:browser": "jest --testEnvironment=jsdom",
     "test:plugins": "jest __tests__/plugin-system.test.js",
@@ -102,10 +129,11 @@
     "prepublishOnly": "npm test && npm run build && eslint index.js json-to-csv.js csv-to-json.js errors.js stream-json-to-csv.js stream-csv-to-json.js json-save.js src/browser src/engines src/formats src/core",
     "tui": "node packages/jtcsv-tui/bin/jtcsv-tui.js",
     "cli": "node bin/jtcsv.js",
-    "build": "rollup -c rollup.config.mjs",
-    "build:watch": "rollup -c rollup.config.mjs -w",
-    "build:prod": "NODE_ENV=production rollup -c rollup.config.mjs",
-    "dev": "NODE_ENV=development rollup -c rollup.config.mjs -w",
+    "build": "rollup -c rollup.config.mjs",
+    "build:watch": "rollup -c rollup.config.mjs -w",
+    "build:prod": "NODE_ENV=production rollup -c rollup.config.mjs",
+    "dev": "NODE_ENV=development rollup -c rollup.config.mjs -w",
+    "verify:browser": "node scripts/verify-browser-build.js",
     "demo": "node run-demo.js",
     "demo:web": "cd demo && npm run dev",
     "demo:serve": "cd demo && npm run serve",
@@ -121,7 +149,22 @@
     "plugins:build": "npm run build && cd plugins/express-middleware && npm run build && cd ../fastify-plugin && npm run build && cd ../nextjs-api && npm run build",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch",
-    "docs:serve": "typedoc && npx serve docs/api"
+    "docs:serve": "typedoc && npx serve docs/api",
+    "tsc": "tsc",
+    "tsc:dev": "tsc --project tsconfig.dev.json",
+    "tsc:build": "tsc --project tsconfig.build.json",
+    "tsc:watch": "tsc --project tsconfig.dev.json --watch",
+    "tsc:check": "tsc --noEmit",
+    "tsc:check-strict": "tsc --noEmit --strict",
+    "tsc:types": "tsc --project tsconfig.types.json",
+    "test:ts": "jest --config jest.config.ts.js",
+    "test:ts:coverage": "jest --config jest.config.ts.js --coverage",
+    "test:ts:watch": "jest --config jest.config.ts.js --watch",
+    "test:types": "node scripts/run-type-tests.js",
+    "build:ts": "npm run tsc:build && npm run build",
+    "build:ts:watch": "npm run tsc:watch & npm run build:watch",
+    "lint:ts": "eslint --ext .ts,.tsx .",
+    "lint:ts:fix": "eslint --ext .ts,.tsx --fix ."
   },
   "keywords": [
     "json",
@@ -200,30 +243,46 @@
     "examples/",
     "plugins/"
   ],
-  "dependencies": {},
   "optionalDependencies": {
     "glob": "^11.0.0"
   },
   "devDependencies": {
     "@babel/core": "^7.26.0",
+    "@babel/plugin-proposal-nullish-coalescing-operator": "7.18.6",
+    "@babel/plugin-proposal-optional-chaining": "7.21.0",
+    "@babel/plugin-syntax-dynamic-import": "7.8.3",
+    "@babel/plugin-syntax-jsx": "7.28.6",
     "@babel/preset-env": "^7.26.0",
+    "@babel/preset-react": "7.28.5",
     "@eslint/js": "^9.18.0",
     "@rollup/plugin-babel": "^6.0.4",
     "@rollup/plugin-commonjs": "^28.0.0",
     "@rollup/plugin-node-resolve": "^16.0.0",
     "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.2",
     "@size-limit/preset-small-lib": "^11.1.0",
+    "@types/express": "5.0.6",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.6",
     "blessed": "^0.1.81",
-    "blessed-contrib": "^4.11.0",
+    "blessed-contrib": "4.11.0",
     "eslint": "^9.18.0",
+    "express": "5.2.1",
     "globals": "^15.14.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "rollup": "^4.30.0",
     "size-limit": "^11.1.0",
-    "typedoc": "^0.27.0"
+    "supertest": "7.2.2",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "tsd": "0.33.0",
+    "tslib": "^2.8.1",
+    "typedoc": "^0.27.0",
+    "typescript": "^5.7.3"
   },
   "type": "commonjs",
+  "sideEffects": false,
   "size-limit": [
     {
       "path": "dist/jtcsv.umd.js",

package/plugins/express-middleware/README.md

@@ -32,6 +32,11 @@ app.use(middleware({
   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
@@ -39,7 +44,21 @@ app.use(middleware({
 }));
 ```
 
-Note: body size limits are controlled by your body parser (for example `express.json({ limit: '10mb' })`).
+**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
@@ -61,4 +80,4 @@ const {
   "stats": { "inputSize": 0, "outputSize": 0, "processingTime": 0, "conversion": "csv->json" },
   "options": {}
 }
-```
+```

package/plugins/express-middleware/example.js

@@ -1,3 +1,4 @@
+// @ts-nocheck
 /**
  * Пример использования Express middleware для JTCSV
  * 
@@ -119,7 +120,7 @@ app.use((req, res) => {
 // Запуск сервера
 app.listen(PORT, () => {
   console.log(`🚀 JTCSV Express server запущен на порту ${PORT}`);
-  console.log(`📚 Примеры запросов:`);
+  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}]'`);
@@ -131,6 +132,4 @@ app.listen(PORT, () => {
   console.log(`  curl -X GET http://localhost:${PORT}/api/health`);
 });
 
-module.exports = app;
-
-
+module.exports = app;

package/plugins/express-middleware/example.ts

@@ -0,0 +1,135 @@
+// @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

@@ -7,7 +7,7 @@
 
 declare module '@jtcsv/express-middleware' {
   import { RequestHandler } from 'express';
-  import { CsvToJsonOptions, JsonToCsvOptions } from 'jtcsv
+  import { CsvToJsonOptions, JsonToCsvOptions } from 'jtcsv';
 
   export interface JtcsvMiddlewareOptions {
     /** Максимальный размер тела запроса */