jtcsv 2.2.8 → 3.1.0

package/errors.js

@@ -1,208 +0,0 @@
-/**
- * Custom error classes for jtcsv
- */
-
-/**
- * Base error class for jtcsv
- */
-class JtcsvError extends Error {
-  constructor(message, code = 'JTCSV_ERROR') {
-    super(message);
-    this.name = 'JtcsvError';
-    this.code = code;
-    
-    // Maintains proper stack trace for where our error was thrown
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, JtcsvError);
-    }
-  }
-}
-
-/**
- * Error for invalid input data
- */
-class ValidationError extends JtcsvError {
-  constructor(message) {
-    super(message, 'VALIDATION_ERROR');
-    this.name = 'ValidationError';
-  }
-}
-
-/**
- * Error for security violations
- */
-class SecurityError extends JtcsvError {
-  constructor(message) {
-    super(message, 'SECURITY_ERROR');
-    this.name = 'SecurityError';
-  }
-}
-
-/**
- * Error for file system operations
- */
-class FileSystemError extends JtcsvError {
-  constructor(message, originalError = null) {
-    super(message, 'FILE_SYSTEM_ERROR');
-    this.name = 'FileSystemError';
-    this.originalError = originalError;
-  }
-}
-
-/**
- * Error for parsing/formatting issues
- */
-class ParsingError extends JtcsvError {
-  constructor(message, lineNumber = null, column = null) {
-    super(message, 'PARSING_ERROR');
-    this.name = 'ParsingError';
-    this.lineNumber = lineNumber;
-    this.column = column;
-  }
-}
-
-/**
- * Error for size/limit violations
- */
-class LimitError extends JtcsvError {
-  constructor(message, limit, actual) {
-    super(message, 'LIMIT_ERROR');
-    this.name = 'LimitError';
-    this.limit = limit;
-    this.actual = actual;
-  }
-}
-
-/**
- * Error for configuration issues
- */
-class ConfigurationError extends JtcsvError {
-  constructor(message) {
-    super(message, 'CONFIGURATION_ERROR');
-    this.name = 'ConfigurationError';
-  }
-}
-
-const ERROR_CODES = {
-  JTCSV_ERROR: 'JTCSV_ERROR',
-  VALIDATION_ERROR: 'VALIDATION_ERROR',
-  SECURITY_ERROR: 'SECURITY_ERROR',
-  FILE_SYSTEM_ERROR: 'FILE_SYSTEM_ERROR',
-  PARSING_ERROR: 'PARSING_ERROR',
-  LIMIT_ERROR: 'LIMIT_ERROR',
-  CONFIGURATION_ERROR: 'CONFIGURATION_ERROR',
-  INVALID_INPUT: 'INVALID_INPUT',
-  SECURITY_VIOLATION: 'SECURITY_VIOLATION',
-  FILE_NOT_FOUND: 'FILE_NOT_FOUND',
-  PARSE_FAILED: 'PARSE_FAILED',
-  SIZE_LIMIT: 'SIZE_LIMIT',
-  INVALID_CONFIG: 'INVALID_CONFIG',
-  UNKNOWN_ERROR: 'UNKNOWN_ERROR'
-};
-
-/**
- * Utility function to create standardized error messages
- */
-function createErrorMessage(type, details) {
-  const messages = {
-    INVALID_INPUT: `Invalid input: ${details}`,
-    SECURITY_VIOLATION: `Security violation: ${details}`,
-    FILE_NOT_FOUND: `File not found: ${details}`,
-    PARSE_FAILED: `Parse failed: ${details}`,
-    SIZE_LIMIT: `Size limit exceeded: ${details}`,
-    INVALID_CONFIG: `Invalid configuration: ${details}`,
-    UNKNOWN_ERROR: `Unknown error: ${details}`
-  };
-  
-  return messages[type] || messages.UNKNOWN_ERROR;
-}
-
-/**
- * Error handler utility
- */
-/* istanbul ignore next */
-function handleError(error, context = {}) {
-  // Log error in development
-  if (process.env.NODE_ENV === 'development') {
-    console.error(`[jtcsv] Error in ${context.function || 'unknown'}:`, {
-      message: error.message,
-      code: error.code,
-      stack: error.stack,
-      context
-    });
-  }
-  
-  // Re-throw the error
-  throw error;
-}
-
-/**
- * Safe execution wrapper for async functions
- */
-/* istanbul ignore next */
-async function safeExecuteAsync(fn, errorType, context = {}) {
-  try {
-    return await fn();
-  } catch (error) {
-    if (error instanceof JtcsvError) {
-      throw error;
-    }
-    
-    // Wrap unknown errors
-    const message = createErrorMessage(errorType, error.message);
-    const wrappedError = new JtcsvError(message, errorType);
-    wrappedError.originalError = error;
-    
-    handleError(wrappedError, context);
-  }
-}
-
-/**
- * Safe execution wrapper for sync functions
- */
-function safeExecuteSync(fn, errorType, context = {}) {
-  try {
-    return fn();
-  } catch (error) {
-    if (error instanceof JtcsvError) {
-      throw error;
-    }
-    
-    // Wrap unknown errors
-    const message = createErrorMessage(errorType, error.message);
-    const wrappedError = new JtcsvError(message, errorType);
-    wrappedError.originalError = error;
-    
-    handleError(wrappedError, context);
-  }
-}
-
-/**
- * Safe execution wrapper (auto-detects async/sync)
- */
-function safeExecute(fn, errorType, context = {}) {
-  const result = fn();
-  
-  // Check if function returns a promise
-  if (result && typeof result.then === 'function') {
-    return safeExecuteAsync(async () => result, errorType, context);
-  }
-  
-  return safeExecuteSync(() => result, errorType, context);
-}
-
-module.exports = {
-  JtcsvError,
-  ValidationError,
-  SecurityError,
-  FileSystemError,
-  ParsingError,
-  LimitError,
-  ConfigurationError,
-  ERROR_CODES,
-  createErrorMessage,
-  handleError,
-  safeExecute,
-  safeExecuteAsync,
-  safeExecuteSync
-};

package/examples/simple-usage.js

@@ -1,282 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Простой пример использования новых возможностей JTCSV 2.1.0
- * Демонстрация Fast-Path Engine, NDJSON и Plugin System
- * 
- * @version 1.0.0
- * @date 2026-01-22
- */
-
-;(async () => {
-console.log('🚀 JTCSV 2.1.0 - Демонстрация новых возможностей\n');
-
-// ============================================================================
-// 1. Базовое использование (обратная совместимость)
-// ============================================================================
-
-console.log('1. 📦 Базовое использование (обратная совместимость)');
-console.log('='.repeat(60));
-
-const { jsonToCsv, csvToJson } = require('jtcsv');
-
-const sampleData = [
-  { id: 1, name: 'John Doe', age: 30, city: 'New York' },
-  { id: 2, name: 'Jane Smith', age: 25, city: 'London' },
-  { id: 3, name: 'Bob Johnson', age: 35, city: 'Tokyo' }
-];
-
-// Конвертация JSON → CSV
-const csv = jsonToCsv(sampleData, { delimiter: ',' });
-console.log('📄 CSV результат:');
-console.log(csv);
-console.log();
-
-// Конвертация CSV → JSON
-const json = csvToJson(csv, { delimiter: ',' });
-console.log('📊 JSON результат:');
-console.log(JSON.stringify(json, null, 2));
-console.log();
-
-// ============================================================================
-// 2. Fast-Path Engine (оптимизированный парсинг)
-// ============================================================================
-
-console.log('\n2. ⚡ Fast-Path Engine (оптимизированный парсинг)');
-console.log('='.repeat(60));
-
-const FastPathEngine = require('../src/engines/fast-path-engine');
-const engine = new FastPathEngine();
-
-// Создаем тестовый CSV
-let testCsv = 'id,name,description\n';
-for (let i = 1; i <= 1000; i++) {
-  testCsv += `${i},User${i},"Description for user ${i}"\n`;
-}
-
-console.log('📊 Анализ структуры CSV...');
-const sample = testCsv.substring(0, 500);
-const structure = engine.analyzeStructure(sample);
-console.log('Структура:', {
-  delimiter: structure.delimiter,
-  hasQuotes: structure.hasQuotes,
-  recommendedEngine: structure.recommendedEngine,
-  complexity: structure.complexity
-});
-
-console.log('\n⚡ Парсинг 1000 строк с оптимизацией...');
-const startTime = Date.now();
-const parsed = engine.parse(testCsv);
-const duration = Date.now() - startTime;
-
-console.log(`✅ Парсинг завершен за ${duration}ms`);
-console.log(`📈 Скорость: ${Math.round(1000 / (duration / 1000))} строк/сек`);
-console.log(`📊 Результат: ${parsed.length} строк (${parsed[0].length} колонок)`);
-
-const stats = engine.getStats();
-console.log('\n📊 Статистика Fast-Path Engine:');
-console.log(`  Simple парсеры: ${stats.simpleParserCount}`);
-console.log(`  Quote-aware парсеры: ${stats.quoteAwareParserCount}`);
-console.log(`  Cache hits: ${stats.cacheHits}`);
-console.log(`  Cache miss: ${stats.cacheMisses}`);
-console.log(`  Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`);
-
-// ============================================================================
-// 3. NDJSON поддержка (потоковая обработка)
-// ============================================================================
-
-console.log('\n3. 📝 NDJSON поддержка (потоковая обработка)');
-console.log('='.repeat(60));
-
-const NdjsonParser = require('../src/formats/ndjson-parser');
-
-// Конвертация в NDJSON
-const ndjson = NdjsonParser.toNdjson(sampleData, { space: 2 });
-console.log('📄 NDJSON результат:');
-console.log(ndjson);
-console.log();
-
-// Обратная конвертация
-const fromNdjson = NdjsonParser.fromNdjson(ndjson);
-console.log('🔁 Обратная конвертация:');
-console.log(JSON.stringify(fromNdjson, null, 2));
-console.log();
-
-// Статистика
-const ndjsonStats = NdjsonParser.getStats(ndjson);
-console.log('📊 Статистика NDJSON:');
-console.log(`  Строк: ${ndjsonStats.totalLines}`);
-console.log(`  Валидных: ${ndjsonStats.validLines}`);
-console.log(`  Успешность: ${ndjsonStats.successRate}%`);
-
-// ============================================================================
-// 4. Plugin System (расширяемость)
-// ============================================================================
-
-console.log('\n4. 🔌 Plugin System (расширяемость)');
-console.log('='.repeat(60));
-
-const PluginManager = require('../src/core/plugin-system');
-
-// Создаем простой плагин для логирования
-const loggingPlugin = {
-  name: 'Logging Plugin',
-  version: '1.0.0',
-  description: 'Логирование операций конвертации',
-  
-  hooks: {
-    'before:csvToJson': (csv, context) => {
-      console.log(`  📥 Начало csvToJson (${csv.length} байт)`);
-      return csv;
-    },
-    
-    'after:csvToJson': (result, context) => {
-      console.log(`  📤 Завершение csvToJson (${result.length} записей)`);
-      return result;
-    },
-    
-    'before:jsonToCsv': (json, context) => {
-      console.log(`  📥 Начало jsonToCsv (${json.length} записей)`);
-      return json;
-    },
-    
-    'after:jsonToCsv': (csv, context) => {
-      console.log(`  📤 Завершение jsonToCsv (${csv.length} байт)`);
-      return csv;
-    }
-  },
-  
-  middlewares: [
-    async (ctx, next) => {
-      console.log(`  🔄 Middleware: ${ctx.operation} начат`);
-      const start = Date.now();
-      await next();
-      const duration = Date.now() - start;
-      console.log(`  ✅ Middleware: ${ctx.operation} завершен за ${duration}ms`);
-    }
-  ]
-};
-
-// Создаем плагин для трансформации данных
-const transformPlugin = {
-  name: 'Transform Plugin',
-  version: '1.0.0',
-  description: 'Трансформация данных перед обработкой',
-  
-  hooks: {
-    'before:jsonToCsv': (json, context) => {
-      // Добавляем timestamp к каждой записи
-      return json.map(item => ({
-        ...item,
-        processedAt: new Date().toISOString(),
-        processedBy: 'transform-plugin'
-      }));
-    }
-  }
-};
-
-// Инициализируем менеджер плагинов
-const pluginManager = new PluginManager();
-pluginManager.use('logging', loggingPlugin);
-pluginManager.use('transform', transformPlugin);
-
-console.log('📋 Зарегистрированные плагины:');
-pluginManager.listPlugins().forEach(plugin => {
-  console.log(`  • ${plugin.name} v${plugin.version} - ${plugin.description}`);
-});
-
-console.log('\n🔄 Выполнение с плагинами...');
-
-// Основная функция для демонстрации
-const processData = async () => {
-  const testJson = [
-    { id: 1, value: 'test1' },
-    { id: 2, value: 'test2' }
-  ];
-  
-  // Выполняем с плагинами
-  const result = await pluginManager.executeWithPlugins(
-    'jsonToCsv',
-    testJson,
-    { delimiter: '|' },
-    (data, options) => {
-      // Имитация основной функции
-      const headers = Object.keys(data[0]);
-      const rows = data.map(item => headers.map(h => item[h]).join(options.delimiter));
-      return [headers.join(options.delimiter), ...rows].join('\n');
-    }
-  );
-  
-  console.log('\n📄 Результат с плагинами:');
-  console.log(result);
-};
-
-await processData();
-
-// Статистика плагинов
-const pluginStats = pluginManager.getStats();
-console.log('\n📊 Статистика Plugin System:');
-console.log(`  Плагинов: ${pluginStats.plugins}`);
-console.log(`  Hooks выполнено: ${pluginStats.hookExecutions}`);
-console.log(`  Middleware выполнено: ${pluginStats.middlewareExecutions}`);
-console.log(`  Уникальных hooks: ${pluginStats.uniqueHooks}`);
-
-// ============================================================================
-// 5. JTCSV с плагинами (полная интеграция)
-// ============================================================================
-
-console.log('\n5. 🎯 JTCSV с плагинами (полная интеграция)');
-console.log('='.repeat(60));
-
-// Проверяем доступность полной интеграции
-try {
-  const JtcsvWithPlugins = require('../src/index-with-plugins');
-  
-  console.log('✅ Полная интеграция доступна');
-  console.log('Запустите для полной демонстрации:');
-  console.log('  npm run example:plugins');
-  console.log('\nИли посмотрите пример:');
-  console.log('  examples/plugin-excel-exporter.js');
-} catch (error) {
-  console.log('⚠️  Полная интеграция требует дополнительных зависимостей');
-  console.log('Установите @jtcsv/excel и exceljs для демонстрации Excel плагина:');
-  console.log('  npm install @jtcsv/excel exceljs');
-}
-
-// ============================================================================
-// Итоги
-// ============================================================================
-
-console.log('\n' + '='.repeat(60));
-console.log('🎉 ДЕМОНСТРАЦИЯ ЗАВЕРШЕНА!');
-console.log('='.repeat(60));
-
-console.log('\n📈 ИТОГИ JTCSV 2.1.0:');
-console.log('✅ Обратная совместимость с 2.0.0');
-console.log('✅ Fast-Path Engine (до 3-4x быстрее)');
-console.log('✅ NDJSON поддержка для потоковой обработки');
-console.log('✅ Plugin System для расширяемости');
-console.log('✅ Excel интеграция (через плагины)');
-console.log('✅ Детальная статистика и мониторинг');
-
-console.log('\n🚀 Следующие шаги:');
-console.log('1. Изучите README-PLUGINS.md для подробной документации');
-console.log('2. Запустите тесты: npm test');
-console.log('3. Попробуйте примеры: npm run example:plugins');
-console.log('4. Создайте свой плагин!');
-
-console.log('\n💡 Совет: Для production используйте:');
-console.log('  const jtcsv = require("jtcsv/plugins").create();');
-console.log('  jtcsv.use("your-plugin", yourPluginConfig);');
-
-console.log('\n📚 Документация: https://github.com/Linol-Hamelton/jtcsv');
-console.log('🐛 Issues: https://github.com/Linol-Hamelton/jtcsv/issues');
-console.log('⭐ Star на GitHub если понравилось!');
-
-console.log('\n' + '✨'.repeat(30));
-console.log('✨  JTCSV 2.1.0 - Next Generation JSON/CSV Converter  ✨');
-console.log('✨'.repeat(30));
-})().catch((error) => {
-  console.error('Demo failed:', error);
-  process.exitCode = 1;
-});

package/index.js

@@ -1,68 +0,0 @@
-// Main entry point for the jtcsv module
-// Exports both JSON→CSV and CSV→JSON functions
-
-const jsonToCsvModule = require('./json-to-csv');
-const csvToJsonModule = require('./csv-to-json');
-const errorsModule = require('./errors');
-const jsonSaveModule = require('./json-save');
-const streamJsonToCsvModule = require('./stream-json-to-csv');
-const streamCsvToJsonModule = require('./stream-csv-to-json');
-const ndjsonParser = require('./src/formats/ndjson-parser');
-const tsvParser = require('./src/formats/tsv-parser');
-
-// Combine all exports
-module.exports = {
-  // JSON to CSV functions
-  jsonToCsv: jsonToCsvModule.jsonToCsv,
-  preprocessData: jsonToCsvModule.preprocessData,
-  saveAsCsv: jsonToCsvModule.saveAsCsv,
-  deepUnwrap: jsonToCsvModule.deepUnwrap,
-  validateFilePath: jsonToCsvModule.validateFilePath,
-  
-  // CSV to JSON functions
-  csvToJson: csvToJsonModule.csvToJson,
-  csvToJsonIterator: csvToJsonModule.csvToJsonIterator,
-  readCsvAsJson: csvToJsonModule.readCsvAsJson,
-  readCsvAsJsonSync: csvToJsonModule.readCsvAsJsonSync,
-  autoDetectDelimiter: csvToJsonModule.autoDetectDelimiter,
-
-  // JSON save functions
-  saveAsJson: jsonSaveModule.saveAsJson,
-  saveAsJsonSync: jsonSaveModule.saveAsJsonSync,
-
-  // Streaming JSON to CSV functions
-  createJsonToCsvStream: streamJsonToCsvModule.createJsonToCsvStream,
-  streamJsonToCsv: streamJsonToCsvModule.streamJsonToCsv,
-  saveJsonStreamAsCsv: streamJsonToCsvModule.saveJsonStreamAsCsv,
-  createJsonReadableStream: streamJsonToCsvModule.createJsonReadableStream,
-  createCsvCollectorStream: streamJsonToCsvModule.createCsvCollectorStream,
-
-  // Streaming CSV to JSON functions
-  createCsvToJsonStream: streamCsvToJsonModule.createCsvToJsonStream,
-  streamCsvToJson: streamCsvToJsonModule.streamCsvToJson,
-  createCsvFileToJsonStream: streamCsvToJsonModule.createCsvFileToJsonStream,
-  createJsonCollectorStream: streamCsvToJsonModule.createJsonCollectorStream,
-
-  // NDJSON format support
-  jsonToNdjson: ndjsonParser.toNdjson,
-  ndjsonToJson: ndjsonParser.fromNdjson,
-  parseNdjsonStream: ndjsonParser.parseStream,
-  createNdjsonToCsvStream: ndjsonParser.createNdjsonToCsvStream,
-  createCsvToNdjsonStream: ndjsonParser.createCsvToNdjsonStream,
-  getNdjsonStats: ndjsonParser.getStats,
-
-  // TSV format support
-  jsonToTsv: tsvParser.jsonToTsv,
-  tsvToJson: tsvParser.tsvToJson,
-  isTsv: tsvParser.isTsv,
-  validateTsv: tsvParser.validateTsv,
-  readTsvAsJson: tsvParser.readTsvAsJson,
-  readTsvAsJsonSync: tsvParser.readTsvAsJsonSync,
-  saveAsTsv: tsvParser.saveAsTsv,
-  saveAsTsvSync: tsvParser.saveAsTsvSync,
-  createJsonToTsvStream: tsvParser.createJsonToTsvStream,
-  createTsvToJsonStream: tsvParser.createTsvToJsonStream,
-
-  // Error classes
-  ...errorsModule
-};