jtcsv 2.2.8 → 3.1.0

package/dist/src/formats/tsv-parser.js

@@ -0,0 +1,230 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const csv_to_json_1 = require("../../csv-to-json");
+const json_to_csv_1 = require("../../json-to-csv");
+const errors_1 = require("../../errors");
+const stream_json_to_csv_1 = require("../../stream-json-to-csv");
+const stream_csv_to_json_1 = require("../../stream-csv-to-json");
+function validateTsvFilePath(filePath) {
+    if (typeof filePath !== 'string' || filePath.trim() === '') {
+        throw new errors_1.ValidationError('File path must be a non-empty string');
+    }
+    if (!filePath.toLowerCase().endsWith('.tsv')) {
+        throw new errors_1.ValidationError('File must have .tsv extension');
+    }
+    const normalizedPath = path_1.default.normalize(filePath);
+    if (normalizedPath.includes('..') ||
+        /\\\.\.\\|\/\.\.\//.test(filePath) ||
+        filePath.startsWith('..') ||
+        filePath.includes('/..')) {
+        throw new errors_1.SecurityError('Directory traversal detected in file path');
+    }
+    return path_1.default.resolve(filePath);
+}
+class TsvParser {
+    static jsonToTsv(data, options = {}) {
+        const defaultOptions = {
+            delimiter: '\t',
+            includeHeaders: true,
+            ...options
+        };
+        return (0, json_to_csv_1.jsonToCsv)(data, defaultOptions);
+    }
+    static tsvToJson(tsvString, options = {}) {
+        const defaultOptions = {
+            delimiter: '\t',
+            autoDetect: false,
+            hasHeaders: true,
+            ...options
+        };
+        return (0, csv_to_json_1.csvToJson)(tsvString, defaultOptions);
+    }
+    static isTsv(sample) {
+        if (!sample || typeof sample !== 'string') {
+            return false;
+        }
+        const lines = sample.split('\n').slice(0, 10);
+        let tabCount = 0;
+        let commaCount = 0;
+        let semicolonCount = 0;
+        for (const line of lines) {
+            if (line.trim() === '') {
+                continue;
+            }
+            tabCount += (line.match(/\t/g) || []).length;
+            commaCount += (line.match(/,/g) || []).length;
+            semicolonCount += (line.match(/;/g) || []).length;
+        }
+        return tabCount > commaCount && tabCount > semicolonCount;
+    }
+    static createJsonToTsvStream(options = {}) {
+        return (0, stream_json_to_csv_1.createJsonToCsvStream)({
+            delimiter: '\t',
+            ...options
+        });
+    }
+    static createTsvToJsonStream(options = {}) {
+        return (0, stream_csv_to_json_1.createCsvToJsonStream)({
+            delimiter: '\t',
+            autoDetect: false,
+            ...options
+        });
+    }
+    static async readTsvAsJson(filePath, options = {}) {
+        const safePath = validateTsvFilePath(filePath);
+        try {
+            const tsvContent = await fs_1.default.promises.readFile(safePath, 'utf8');
+            return (0, csv_to_json_1.csvToJson)(tsvContent, {
+                delimiter: '\t',
+                autoDetect: false,
+                ...options
+            });
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError || error instanceof errors_1.SecurityError) {
+                throw error;
+            }
+            if (error.code === 'ENOENT') {
+                throw new errors_1.FileSystemError(`File not found: ${safePath}`, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new errors_1.FileSystemError(`Permission denied: ${safePath}`, error);
+            }
+            if (error.code === 'EISDIR') {
+                throw new errors_1.FileSystemError(`Path is a directory: ${safePath}`, error);
+            }
+            throw new errors_1.FileSystemError(`Failed to read TSV file: ${error.message}`, error);
+        }
+    }
+    static readTsvAsJsonSync(filePath, options = {}) {
+        const safePath = validateTsvFilePath(filePath);
+        try {
+            const tsvContent = fs_1.default.readFileSync(safePath, 'utf8');
+            return (0, csv_to_json_1.csvToJson)(tsvContent, {
+                delimiter: '\t',
+                autoDetect: false,
+                ...options
+            });
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError || error instanceof errors_1.SecurityError) {
+                throw error;
+            }
+            if (error.code === 'ENOENT') {
+                throw new errors_1.FileSystemError(`File not found: ${safePath}`, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new errors_1.FileSystemError(`Permission denied: ${safePath}`, error);
+            }
+            if (error.code === 'EISDIR') {
+                throw new errors_1.FileSystemError(`Path is a directory: ${safePath}`, error);
+            }
+            throw new errors_1.FileSystemError(`Failed to read TSV file: ${error.message}`, error);
+        }
+    }
+    static async saveAsTsv(data, filePath, options = {}) {
+        const safePath = validateTsvFilePath(filePath);
+        const tsvContent = this.jsonToTsv(data, options);
+        const dir = path_1.default.dirname(safePath);
+        try {
+            await fs_1.default.promises.mkdir(dir, { recursive: true });
+            await fs_1.default.promises.writeFile(safePath, tsvContent, 'utf8');
+            return safePath;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new errors_1.FileSystemError(`Directory does not exist: ${dir}`, error);
+            }
+            if (error.code === 'EACCES') {
+                throw new errors_1.FileSystemError(`Permission denied: ${safePath}`, error);
+            }
+            if (error.code === 'ENOSPC') {
+                throw new errors_1.FileSystemError(`No space left on device: ${safePath}`, error);
+            }
+            throw new errors_1.FileSystemError(`Failed to save TSV file: ${error.message}`, error);
+        }
+    }
+    static saveAsTsvSync(data, filePath, options = {}) {
+        const safePath = validateTsvFilePath(filePath);
+        const tsvContent = this.jsonToTsv(data, options);
+        fs_1.default.mkdirSync(path_1.default.dirname(safePath), { recursive: true });
+        fs_1.default.writeFileSync(safePath, tsvContent, 'utf8');
+    }
+    static validateTsv(tsvString, options = {}) {
+        const { requireConsistentColumns = true } = options;
+        if (!tsvString || typeof tsvString !== 'string') {
+            return {
+                valid: false,
+                error: 'Input must be a non-empty string',
+                details: { inputType: typeof tsvString }
+            };
+        }
+        const lines = tsvString.split('\n').filter(line => line.trim() !== '');
+        if (lines.length === 0) {
+            return {
+                valid: false,
+                error: 'No data found in TSV',
+                details: { lineCount: 0 }
+            };
+        }
+        const columnCounts = [];
+        const errors = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const columns = line.split('\t');
+            columnCounts.push(columns.length);
+            if (options.disallowEmptyFields) {
+                const emptyFields = columns.filter(field => field.trim() === '');
+                if (emptyFields.length > 0) {
+                    errors.push({
+                        line: i + 1,
+                        error: `Found ${emptyFields.length} empty field(s)`,
+                        fields: emptyFields.map((_, idx) => idx + 1)
+                    });
+                }
+            }
+        }
+        if (requireConsistentColumns && columnCounts.length > 1) {
+            const firstCount = columnCounts[0];
+            const inconsistentLines = [];
+            for (let i = 1; i < columnCounts.length; i++) {
+                if (columnCounts[i] !== firstCount) {
+                    inconsistentLines.push({
+                        line: i + 1,
+                        expected: firstCount,
+                        actual: columnCounts[i]
+                    });
+                }
+            }
+            if (inconsistentLines.length > 0) {
+                errors.push({
+                    error: 'Inconsistent column count',
+                    details: inconsistentLines
+                });
+            }
+        }
+        const totalColumns = columnCounts[0] || 0;
+        return {
+            valid: errors.length === 0,
+            stats: {
+                totalLines: lines.length,
+                totalColumns,
+                minColumns: Math.min(...columnCounts),
+                maxColumns: Math.max(...columnCounts),
+                consistentColumns: new Set(columnCounts).size === 1
+            },
+            errors: errors.length > 0 ? errors : undefined
+        };
+    }
+}
+exports.default = TsvParser;
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = TsvParser;
+    module.exports.default = TsvParser;
+}
+//# sourceMappingURL=tsv-parser.js.map

package/dist/src/formats/tsv-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsv-parser.js","sourceRoot":"","sources":["../../../src/formats/tsv-parser.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TSV (Tab-Separated Values) парсер\n * Специализированная поддержка TSV формата\n * \n * @version 1.0.0\n * @date 2026-01-23\n */\n\nimport fs from \"fs\";\nimport path from \"path\";\nimport { csvToJson } from \"../../csv-to-json\";\nimport { jsonToCsv } from \"../../json-to-csv\";\nimport { ValidationError, SecurityError, FileSystemError } from \"../../errors\";\nimport { createJsonToCsvStream } from \"../../stream-json-to-csv\";\nimport { createCsvToJsonStream } from \"../../stream-csv-to-json\";\n\nfunction validateTsvFilePath(filePath) {\n  if (typeof filePath !== 'string' || filePath.trim() === '') {\n    throw new ValidationError('File path must be a non-empty string');\n  }\n\n  if (!filePath.toLowerCase().endsWith('.tsv')) {\n    throw new ValidationError('File must have .tsv extension');\n  }\n\n  const normalizedPath = path.normalize(filePath);\n  if (normalizedPath.includes('..') ||\n      /\\\\\\.\\.\\\\|\\/\\.\\.\\//.test(filePath) ||\n      filePath.startsWith('..') ||\n      filePath.includes('/..')) {\n    throw new SecurityError('Directory traversal detected in file path');\n  }\n\n  return path.resolve(filePath);\n}\n\nclass TsvParser {\n  /**\n   * Конвертирует массив объектов в TSV строку\n   * @param {Array} data - Массив объектов\n   * @param {Object} options - Опции форматирования\n   * @returns {string} TSV строка\n   * \n   * @example\n   * const data = [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }];\n   * const tsv = TsvParser.jsonToTsv(data);\n   * // Результат: \"id\\tname\\n1\\tJohn\\n2\\tJane\"\n   */\n  static jsonToTsv(data, options = {}) {\n    const defaultOptions = {\n      delimiter: '\\t',\n      includeHeaders: true,\n      ...options\n    };\n    \n    return jsonToCsv(data, defaultOptions);\n  }\n\n  /**\n   * Конвертирует TSV строку в массив объектов\n   * @param {string} tsvString - TSV строка\n   * @param {Object} options - Опции парсинга\n   * @returns {Array} Массив объектов\n   * \n   * @example\n   * const tsv = \"id\\tname\\n1\\tJohn\\n2\\tJane\";\n   * const data = TsvParser.tsvToJson(tsv);\n   * // Результат: [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]\n   */\n  static tsvToJson(tsvString, options = {}) {\n    const defaultOptions = {\n      delimiter: '\\t',\n      autoDetect: false,\n      hasHeaders: true,\n      ...options\n    };\n    \n    return csvToJson(tsvString, defaultOptions);\n  }\n\n  /**\n   * Автоматически определяет является ли строка TSV\n   * @param {string} sample - Образец данных\n   * @returns {boolean} True если это TSV\n   */\n  static isTsv(sample) {\n    if (!sample || typeof sample !== 'string') {\n      return false;\n    }\n\n    const lines = sample.split('\\n').slice(0, 10);\n    let tabCount = 0;\n    let commaCount = 0;\n    let semicolonCount = 0;\n\n    for (const line of lines) {\n      if (line.trim() === '') {\n        continue;\n      }\n      \n      // Считаем разделители\n      tabCount += (line.match(/\\t/g) || []).length;\n      commaCount += (line.match(/,/g) || []).length;\n      semicolonCount += (line.match(/;/g) || []).length;\n    }\n\n    // Если табуляций больше чем других разделителей, считаем это TSV\n    return tabCount > commaCount && tabCount > semicolonCount;\n  }\n\n  /**\n   * Создает TransformStream для конвертации JSON в TSV\n   * @param {Object} options - Опции конвертации\n   * @returns {TransformStream} Transform stream\n   */\n  static createJsonToTsvStream(options = {}) {\n    return createJsonToCsvStream({\n      delimiter: '\\t',\n      ...options\n    });\n  }\n\n  /**\n   * Создает TransformStream для конвертации TSV в JSON\n   * @param {Object} options - Опции конвертации\n   * @returns {TransformStream} Transform stream\n   */\n  static createTsvToJsonStream(options = {}) {\n    return createCsvToJsonStream({\n      delimiter: '\\t',\n      autoDetect: false,\n      ...options\n    });\n  }\n\n  /**\n   * Читает TSV файл и конвертирует в JSON\n   * @param {string} filePath - Путь к TSV файлу\n   * @param {Object} options - Опции парсинга\n   * @returns {Promise<Array>} Promise с массивом объектов\n   */\n  static async readTsvAsJson(filePath, options = {}) {\n    const safePath = validateTsvFilePath(filePath);\n\n    try {\n      const tsvContent = await fs.promises.readFile(safePath, 'utf8');\n      return csvToJson(tsvContent, {\n        delimiter: '\\t',\n        autoDetect: false,\n        ...options\n      });\n    } catch (error) {\n      if (error instanceof ValidationError || error instanceof SecurityError) {\n        throw error;\n      }\n      if (error.code === 'ENOENT') {\n        throw new FileSystemError(`File not found: ${safePath}`, error);\n      }\n      if (error.code === 'EACCES') {\n        throw new FileSystemError(`Permission denied: ${safePath}`, error);\n      }\n      if (error.code === 'EISDIR') {\n        throw new FileSystemError(`Path is a directory: ${safePath}`, error);\n      }\n      throw new FileSystemError(`Failed to read TSV file: ${error.message}`, error);\n    }\n  }\n\n  /**\n   * Синхронно читает TSV файл и конвертирует в JSON\n   * @param {string} filePath - Путь к TSV файлу\n   * @param {Object} options - Опции парсинга\n   * @returns {Array} Массив объектов\n   */\n  static readTsvAsJsonSync(filePath, options = {}) {\n    const safePath = validateTsvFilePath(filePath);\n\n    try {\n      const tsvContent = fs.readFileSync(safePath, 'utf8');\n      return csvToJson(tsvContent, {\n        delimiter: '\\t',\n        autoDetect: false,\n        ...options\n      });\n    } catch (error) {\n      if (error instanceof ValidationError || error instanceof SecurityError) {\n        throw error;\n      }\n      if (error.code === 'ENOENT') {\n        throw new FileSystemError(`File not found: ${safePath}`, error);\n      }\n      if (error.code === 'EACCES') {\n        throw new FileSystemError(`Permission denied: ${safePath}`, error);\n      }\n      if (error.code === 'EISDIR') {\n        throw new FileSystemError(`Path is a directory: ${safePath}`, error);\n      }\n      throw new FileSystemError(`Failed to read TSV file: ${error.message}`, error);\n    }\n  }\n\n  /**\n   * Сохраняет массив объектов как TSV файл\n   * @param {Array} data - Массив объектов\n   * @param {string} filePath - Путь для сохранения\n   * @param {Object} options - Опции сохранения\n   * @returns {Promise<void>}\n   */\n  static async saveAsTsv(data, filePath, options = {}) {\n    const safePath = validateTsvFilePath(filePath);\n    const tsvContent = this.jsonToTsv(data, options);\n    const dir = path.dirname(safePath);\n\n    try {\n      await fs.promises.mkdir(dir, { recursive: true });\n      await fs.promises.writeFile(safePath, tsvContent, 'utf8');\n      return safePath;\n    } catch (error) {\n      if (error.code === 'ENOENT') {\n        throw new FileSystemError(`Directory does not exist: ${dir}`, error);\n      }\n      if (error.code === 'EACCES') {\n        throw new FileSystemError(`Permission denied: ${safePath}`, error);\n      }\n      if (error.code === 'ENOSPC') {\n        throw new FileSystemError(`No space left on device: ${safePath}`, error);\n      }\n      throw new FileSystemError(`Failed to save TSV file: ${error.message}`, error);\n    }\n  }\n\n  /**\n   * Синхронно сохраняет массив объектов как TSV файл\n   * @param {Array} data - Массив объектов\n   * @param {string} filePath - Путь для сохранения\n   * @param {Object} options - Опции сохранения\n   */\n  static saveAsTsvSync(data, filePath, options = {}) {\n    const safePath = validateTsvFilePath(filePath);\n    const tsvContent = this.jsonToTsv(data, options);\n\n    fs.mkdirSync(path.dirname(safePath), { recursive: true });\n    fs.writeFileSync(safePath, tsvContent, 'utf8');\n  }\n\n  /**\n   * Валидирует TSV строку\n   * @param {string} tsvString - TSV строка для валидации\n   * @param {Object} options - Опции валидации\n   * @returns {Object} Результат валидации\n   */\n  static validateTsv(tsvString, options: any = {}) {\n    const { requireConsistentColumns = true } = options;\n    \n    if (!tsvString || typeof tsvString !== 'string') {\n      return {\n        valid: false,\n        error: 'Input must be a non-empty string',\n        details: { inputType: typeof tsvString }\n      };\n    }\n\n    const lines = tsvString.split('\\n').filter(line => line.trim() !== '');\n    \n    if (lines.length === 0) {\n      return {\n        valid: false,\n        error: 'No data found in TSV',\n        details: { lineCount: 0 }\n      };\n    }\n\n    const columnCounts = [];\n    const errors = [];\n\n    for (let i = 0; i < lines.length; i++) {\n      const line = lines[i];\n      const columns = line.split('\\t');\n      columnCounts.push(columns.length);\n\n      // Проверяем наличие пустых полей (если требуется)\n      if (options.disallowEmptyFields) {\n        const emptyFields = columns.filter(field => field.trim() === '');\n        if (emptyFields.length > 0) {\n          errors.push({\n            line: i + 1,\n            error: `Found ${emptyFields.length} empty field(s)`,\n            fields: emptyFields.map((_, idx) => idx + 1)\n          });\n        }\n      }\n    }\n\n    // Проверяем консистентность колонки\n    if (requireConsistentColumns && columnCounts.length > 1) {\n      const firstCount = columnCounts[0];\n      const inconsistentLines = [];\n      \n      for (let i = 1; i < columnCounts.length; i++) {\n        if (columnCounts[i] !== firstCount) {\n          inconsistentLines.push({\n            line: i + 1,\n            expected: firstCount,\n            actual: columnCounts[i]\n          });\n        }\n      }\n\n      if (inconsistentLines.length > 0) {\n        errors.push({\n          error: 'Inconsistent column count',\n          details: inconsistentLines\n        });\n      }\n    }\n\n    /* istanbul ignore next */\n    const totalColumns = columnCounts[0] || 0;\n\n    return {\n      valid: errors.length === 0,\n      stats: {\n        totalLines: lines.length,\n        totalColumns,\n        minColumns: Math.min(...columnCounts),\n        maxColumns: Math.max(...columnCounts),\n        consistentColumns: new Set(columnCounts).size === 1\n      },\n      errors: errors.length > 0 ? errors : undefined\n    };\n  }\n}\n\nexport default TsvParser;\n\n// CommonJS compatibility\nif (typeof module !== 'undefined' && module.exports) {\n  module.exports = TsvParser;\n  module.exports.default = TsvParser;\n}\n"]}

package/dist/src/index-with-plugins.js

@@ -0,0 +1,259 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.create = exports.NdjsonParser = exports.FastPathEngine = exports.PluginManager = exports.JtcsvWithPlugins = void 0;
+const plugin_system_1 = require("./core/plugin-system");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return plugin_system_1.PluginManager; } });
+const fast_path_engine_1 = __importDefault(require("./engines/fast-path-engine"));
+exports.FastPathEngine = fast_path_engine_1.default;
+const ndjson_parser_1 = __importDefault(require("./formats/ndjson-parser"));
+exports.NdjsonParser = ndjson_parser_1.default;
+const json_to_csv_1 = require("../json-to-csv");
+const csv_to_json_1 = require("../csv-to-json");
+const json_to_csv_2 = require("../json-to-csv");
+const csv_to_json_2 = require("../csv-to-json");
+class JtcsvWithPlugins {
+    constructor(options = {}) {
+        this.pluginManager = new plugin_system_1.PluginManager();
+        this.fastPathEngine = new fast_path_engine_1.default();
+        this.options = {
+            enableFastPath: true,
+            enablePlugins: true,
+            ...options
+        };
+        this._registerBuiltinPlugins();
+    }
+    _registerBuiltinPlugins() {
+        this.pluginManager.use('fast-path-engine', {
+            name: 'Fast Path Engine',
+            version: '1.0.0',
+            description: 'Оптимизированный парсер CSV с автоматическим выбором стратегии',
+            hooks: {
+                'before:csvToJson': (csv, context) => {
+                    if (this.options.enableFastPath && context.options?.useFastPath !== false) {
+                        const sample = csv.substring(0, Math.min(1000, csv.length));
+                        const structure = this.fastPathEngine.analyzeStructure(sample, context.options);
+                        context.metadata = context.metadata || {};
+                        context.metadata.fastPathStructure = structure;
+                        if (process.env.NODE_ENV === 'development') {
+                            console.log(`🚀 Используется ${structure.recommendedEngine} парсер`);
+                        }
+                    }
+                    return csv;
+                },
+                'after:csvToJson': (result, context) => {
+                    if (context.metadata?.fastPathStructure) {
+                        context.metadata.fastPathStats = this.fastPathEngine.getStats();
+                    }
+                    return result;
+                }
+            }
+        });
+        this.pluginManager.use('ndjson-support', {
+            name: 'NDJSON Support',
+            version: '1.0.0',
+            description: 'Поддержка Newline Delimited JSON формата',
+            hooks: {
+                'before:parse': (input, context) => {
+                    if (context.options?.format === 'ndjson') {
+                        return ndjson_parser_1.default.fromNdjson(input, context.options);
+                    }
+                    return input;
+                },
+                'after:serialize': (output, context) => {
+                    if (context.options?.format === 'ndjson') {
+                        return ndjson_parser_1.default.toNdjson(output, context.options);
+                    }
+                    return output;
+                }
+            }
+        });
+        this.pluginManager.use('data-validation', {
+            name: 'Data Validation',
+            version: '1.0.0',
+            description: 'Валидация входных и выходных данных',
+            hooks: {
+                'validation': (data, context) => {
+                    if (!data) {
+                        throw new Error('Данные не могут быть пустыми');
+                    }
+                    if (context.operation === 'jsonToCsv' && !Array.isArray(data)) {
+                        throw new Error('Для конвертации в CSV данные должны быть массивом');
+                    }
+                    return data;
+                }
+            },
+            middlewares: [
+                async (ctx, next) => {
+                    await this.pluginManager.executeHooks('validation', ctx.input, ctx);
+                    await next();
+                    await this.pluginManager.executeHooks('validation', ctx.result, ctx);
+                }
+            ]
+        });
+        this.pluginManager.use('logging', {
+            name: 'Logging',
+            version: '1.0.0',
+            description: 'Логирование операций',
+            hooks: {
+                'before:csvToJson': (csv, context) => {
+                    if (process.env.NODE_ENV === 'development') {
+                        console.log(`📥 Начало csvToJson, размер: ${csv.length} байт`);
+                    }
+                    return csv;
+                },
+                'after:csvToJson': (result, context) => {
+                    if (process.env.NODE_ENV === 'development') {
+                        console.log(`📤 Завершение csvToJson, результат: ${result.length} записей`);
+                    }
+                    return result;
+                },
+                'before:jsonToCsv': (json, context) => {
+                    if (process.env.NODE_ENV === 'development') {
+                        console.log(`📥 Начало jsonToCsv, записей: ${json.length}`);
+                    }
+                    return json;
+                },
+                'after:jsonToCsv': (csv, context) => {
+                    if (process.env.NODE_ENV === 'development') {
+                        console.log(`📤 Завершение jsonToCsv, размер: ${csv.length} байт`);
+                    }
+                    return csv;
+                }
+            }
+        });
+    }
+    async csvToJson(csv, options = {}) {
+        if (!this.options.enablePlugins) {
+            return (0, csv_to_json_1.csvToJson)(csv, options);
+        }
+        return this.pluginManager.executeWithPlugins('csvToJson', csv, options, (input, opts) => {
+            if (this.options.enableFastPath && opts?.useFastPath !== false) {
+                return (0, csv_to_json_1.csvToJson)(input, { ...opts, useFastPath: true });
+            }
+            return (0, csv_to_json_1.csvToJson)(input, opts);
+        });
+    }
+    async *csvToJsonIterator(csv, options = {}) {
+        if (!this.options.enablePlugins) {
+            for await (const row of (0, csv_to_json_1.csvToJsonIterator)(csv, options)) {
+                yield row;
+            }
+            return;
+        }
+        const iterator = await this.pluginManager.executeWithPlugins('csvToJson', csv, options, (input, opts) => {
+            if (this.options.enableFastPath && opts?.useFastPath !== false) {
+                return (0, csv_to_json_1.csvToJsonIterator)(input, { ...opts, useFastPath: true });
+            }
+            return (0, csv_to_json_1.csvToJsonIterator)(input, opts);
+        });
+        for await (const row of iterator) {
+            yield row;
+        }
+    }
+    async jsonToCsv(json, options = {}) {
+        if (!this.options.enablePlugins) {
+            return (0, json_to_csv_1.jsonToCsv)(json, options);
+        }
+        return this.pluginManager.executeWithPlugins('jsonToCsv', json, options, json_to_csv_1.jsonToCsv);
+    }
+    async saveAsCsv(data, filePath, options = {}) {
+        if (!this.options.enablePlugins) {
+            (0, json_to_csv_2.saveAsCsv)(data, filePath, options);
+            return;
+        }
+        const csv = await this.jsonToCsv(data, options);
+        await this.pluginManager.executeWithPlugins('saveAsCsv', { data: csv, filePath }, options, async (input) => {
+            const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+            await fs.writeFile(input.filePath, input.data, 'utf8');
+            return input.filePath;
+        });
+    }
+    async readCsvAsJson(filePath, options = {}) {
+        if (!this.options.enablePlugins) {
+            return (0, csv_to_json_2.readCsvAsJson)(filePath, options);
+        }
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        const csv = await fs.readFile(filePath, 'utf8');
+        return this.csvToJson(csv, options);
+    }
+    async parseNdjson(input, options = {}) {
+        if (typeof input === 'string') {
+            return ndjson_parser_1.default.fromNdjson(input, options);
+        }
+        const result = [];
+        for await (const obj of ndjson_parser_1.default.parseStream(input, options)) {
+            result.push(obj);
+        }
+        return result;
+    }
+    toNdjson(data, options = {}) {
+        return ndjson_parser_1.default.toNdjson(data, options);
+    }
+    use(name, plugin) {
+        this.pluginManager.use(name, plugin);
+        return this;
+    }
+    getPluginManager() {
+        return this.pluginManager;
+    }
+    getFastPathEngine() {
+        return this.fastPathEngine;
+    }
+    listPlugins() {
+        return this.pluginManager.listPlugins();
+    }
+    getStats() {
+        return {
+            plugins: this.pluginManager.getStats(),
+            fastPath: this.fastPathEngine.getStats(),
+            options: this.options
+        };
+    }
+    configure(newOptions) {
+        this.options = { ...this.options, ...newOptions };
+        return this;
+    }
+    static create(options = {}) {
+        return new JtcsvWithPlugins(options);
+    }
+}
+exports.JtcsvWithPlugins = JtcsvWithPlugins;
+exports.default = JtcsvWithPlugins;
+exports.create = JtcsvWithPlugins.create;
+//# sourceMappingURL=index-with-plugins.js.map

package/dist/src/index-with-plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-with-plugins.js","sourceRoot":"","sources":["../../src/index-with-plugins.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * JTCSV с поддержкой плагинов\r\n * Расширяемая версия основного API с plugin system\r\n * \r\n * @version 1.0.0\r\n * @date 2026-01-22\r\n */\r\n\r\nimport { PluginManager } from './core/plugin-system';\r\nimport FastPathEngine from './engines/fast-path-engine';\r\nimport NdjsonParser from './formats/ndjson-parser';\r\n\r\n// Импортируем основные функции\r\nimport { jsonToCsv as coreJsonToCsv } from '../json-to-csv';\r\nimport { csvToJson as coreCsvToJson, csvToJsonIterator as coreCsvToJsonIterator } from '../csv-to-json';\r\nimport { saveAsCsv as coreSaveAsCsv } from '../json-to-csv';\r\nimport { readCsvAsJson as coreReadCsvAsJson } from '../csv-to-json';\r\n\r\nimport type { CsvToJsonOptions, JsonToCsvOptions, SaveAsCsvOptions } from './types';\n\r\nexport interface JtcsvWithPluginsOptions {\r\n  enableFastPath?: boolean;\r\n  enablePlugins?: boolean;\r\n  [key: string]: any;\r\n}\r\n\r\nexport interface PluginHookContext {\r\n  operation: string;\r\n  options?: any;\r\n  metadata?: Record<string, any>;\r\n}\r\n\r\nexport class JtcsvWithPlugins {\r\n  private pluginManager: PluginManager;\r\n  private fastPathEngine: FastPathEngine;\r\n  private options: JtcsvWithPluginsOptions;\r\n\r\n  constructor(options: JtcsvWithPluginsOptions = {}) {\r\n    this.pluginManager = new PluginManager();\r\n    this.fastPathEngine = new FastPathEngine();\r\n    this.options = {\r\n      enableFastPath: true,\r\n      enablePlugins: true,\r\n      ...options\r\n    };\r\n\r\n    // Регистрируем встроенные плагины\r\n    this._registerBuiltinPlugins();\r\n  }\r\n\r\n  /**\r\n   * Регистрирует встроенные плагины\r\n   */\r\n  private _registerBuiltinPlugins(): void {\r\n    // Fast Path Engine плагин\r\n    this.pluginManager.use('fast-path-engine', {\r\n      name: 'Fast Path Engine',\r\n      version: '1.0.0',\r\n      description: 'Оптимизированный парсер CSV с автоматическим выбором стратегии',\r\n      hooks: {\r\n        'before:csvToJson': (csv: string, context: PluginHookContext) => {\r\n          if (this.options.enableFastPath && context.options?.useFastPath !== false) {\r\n            // Используем fast path engine для анализа\r\n            const sample = csv.substring(0, Math.min(1000, csv.length));\r\n            const structure = this.fastPathEngine.analyzeStructure(sample, context.options);\r\n            \r\n            context.metadata = context.metadata || {};\r\n            context.metadata.fastPathStructure = structure;\r\n            if (process.env.NODE_ENV === 'development') {\r\n              console.log(`🚀 Используется ${structure.recommendedEngine} парсер`);\r\n            }\r\n          }\r\n          return csv;\r\n        },\r\n        'after:csvToJson': (result: any[], context: PluginHookContext) => {\r\n          if (context.metadata?.fastPathStructure) {\r\n            context.metadata.fastPathStats = this.fastPathEngine.getStats();\r\n          }\r\n          return result;\r\n        }\r\n      }\r\n    });\r\n\r\n    // NDJSON плагин\r\n    this.pluginManager.use('ndjson-support', {\r\n      name: 'NDJSON Support',\r\n      version: '1.0.0',\r\n      description: 'Поддержка Newline Delimited JSON формата',\r\n      hooks: {\r\n        'before:parse': (input: any, context: PluginHookContext) => {\r\n          if (context.options?.format === 'ndjson') {\r\n            // Парсим NDJSON\r\n            return NdjsonParser.fromNdjson(input as string, context.options);\r\n          }\r\n          return input;\r\n        },\r\n        'after:serialize': (output: any, context: PluginHookContext) => {\r\n          if (context.options?.format === 'ndjson') {\r\n            // Сериализуем в NDJSON\r\n            return NdjsonParser.toNdjson(output, context.options);\r\n          }\r\n          return output;\r\n        }\r\n      }\r\n    });\r\n\r\n    // Валидация данных плагин\r\n    this.pluginManager.use('data-validation', {\r\n      name: 'Data Validation',\r\n      version: '1.0.0',\r\n      description: 'Валидация входных и выходных данных',\r\n      hooks: {\r\n        'validation': (data: any, context: PluginHookContext) => {\r\n          if (!data) {\r\n            throw new Error('Данные не могут быть пустыми');\r\n          }\r\n          \r\n          if (context.operation === 'jsonToCsv' && !Array.isArray(data)) {\r\n            throw new Error('Для конвертации в CSV данные должны быть массивом');\r\n          }\r\n          \r\n          return data;\r\n        }\r\n      },\r\n      middlewares: [\r\n        async (ctx: any, next: () => Promise<void>) => {\r\n          // Валидация перед выполнением\r\n          await this.pluginManager.executeHooks('validation', ctx.input, ctx);\r\n          await next();\r\n          // Валидация после выполнения\r\n          await this.pluginManager.executeHooks('validation', ctx.result, ctx);\r\n        }\r\n      ]\r\n    });\r\n\r\n    // Логирование плагин\r\n    this.pluginManager.use('logging', {\r\n      name: 'Logging',\r\n      version: '1.0.0',\r\n      description: 'Логирование операций',\r\n      hooks: {\r\n        'before:csvToJson': (csv: string, context: PluginHookContext) => {\r\n          if (process.env.NODE_ENV === 'development') {\r\n            console.log(`📥 Начало csvToJson, размер: ${csv.length} байт`);\r\n          }\r\n          return csv;\r\n        },\r\n        'after:csvToJson': (result: any[], context: PluginHookContext) => {\r\n          if (process.env.NODE_ENV === 'development') {\r\n            console.log(`📤 Завершение csvToJson, результат: ${result.length} записей`);\r\n          }\r\n          return result;\r\n        },\r\n        'before:jsonToCsv': (json: any[], context: PluginHookContext) => {\r\n          if (process.env.NODE_ENV === 'development') {\r\n            console.log(`📥 Начало jsonToCsv, записей: ${json.length}`);\r\n          }\r\n          return json;\r\n        },\r\n        'after:jsonToCsv': (csv: string, context: PluginHookContext) => {\r\n          if (process.env.NODE_ENV === 'development') {\r\n            console.log(`📤 Завершение jsonToCsv, размер: ${csv.length} байт`);\r\n          }\r\n          return csv;\r\n        }\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Конвертирует CSV в JSON с поддержкой плагинов\r\n   * @param csv - CSV данные\r\n   * @param options - Опции парсинга\r\n   * @returns JSON данные\r\n   */\r\n  async csvToJson(csv: string, options: CsvToJsonOptions = {}): Promise<any[]> {\r\n    if (!this.options.enablePlugins) {\r\n      return coreCsvToJson(csv, options);\r\n    }\r\n\r\n    return this.pluginManager.executeWithPlugins(\r\n      'csvToJson',\r\n      csv,\r\n      options,\r\n      (input: string, opts: CsvToJsonOptions) => {\r\n        if (this.options.enableFastPath && opts?.useFastPath !== false) {\r\n          return coreCsvToJson(input, { ...opts, useFastPath: true });\r\n        }\r\n\r\n        return coreCsvToJson(input, opts);\r\n      }\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Convert CSV to JSON rows as async iterator with plugin hooks.\r\n   * @param csv - CSV input\r\n   * @param options - Conversion options\r\n   * @returns Async iterator of rows\r\n   */\r\n  async *csvToJsonIterator(csv: string, options: CsvToJsonOptions = {}): AsyncGenerator<any, void, unknown> {\r\n    if (!this.options.enablePlugins) {\r\n      for await (const row of coreCsvToJsonIterator(csv, options)) {\r\n        yield row;\r\n      }\r\n      return;\r\n    }\r\n\r\n    const iterator = await this.pluginManager.executeWithPlugins(\r\n      'csvToJson',\r\n      csv,\r\n      options,\r\n      (input: string, opts: CsvToJsonOptions) => {\r\n        if (this.options.enableFastPath && opts?.useFastPath !== false) {\r\n          return coreCsvToJsonIterator(input, { ...opts, useFastPath: true });\r\n        }\r\n\r\n        return coreCsvToJsonIterator(input, opts);\r\n      }\r\n    );\r\n\r\n    for await (const row of iterator) {\r\n      yield row;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Конвертирует JSON в CSV с поддержкой плагинов\r\n   * @param json - JSON данные\r\n   * @param options - Опции сериализации\r\n   * @returns CSV данные\r\n   */\r\n  async jsonToCsv(json: any[], options: JsonToCsvOptions = {}): Promise<string> {\r\n    if (!this.options.enablePlugins) {\r\n      return coreJsonToCsv(json, options);\r\n    }\r\n\r\n    return this.pluginManager.executeWithPlugins(\r\n      'jsonToCsv',\r\n      json,\r\n      options,\r\n      coreJsonToCsv\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Сохраняет JSON как CSV файл\r\n   * @param data - JSON данные\r\n   * @param filePath - Путь к файлу\r\n   * @param options - Опции\r\n   * @returns Promise<void>\r\n   */\r\n  async saveAsCsv(data: any[], filePath: string, options: SaveAsCsvOptions = {}): Promise<void> {\n    if (!this.options.enablePlugins) {\n      coreSaveAsCsv(data, filePath, options);\n      return;\n    }\n\r\n    const csv = await this.jsonToCsv(data, options);\r\n    \r\n    // Используем плагины для сохранения\r\n    await this.pluginManager.executeWithPlugins(\n      'saveAsCsv',\n      { data: csv, filePath },\n      options,\n      async (input: { data: string; filePath: string }) => {\n        const fs = await import('fs/promises');\n        await fs.writeFile(input.filePath, input.data, 'utf8');\n        return input.filePath;\n      }\n    );\n  }\n\r\n  /**\r\n   * Читает CSV файл и конвертирует в JSON\r\n   * @param filePath - Путь к файлу\r\n   * @param options - Опции\r\n   * @returns JSON данные\r\n   */\r\n  async readCsvAsJson(filePath: string, options: CsvToJsonOptions = {}): Promise<any[]> {\r\n    if (!this.options.enablePlugins) {\r\n      return coreReadCsvAsJson(filePath, options);\r\n    }\r\n\r\n    // Читаем файл\r\n    const fs = await import('fs/promises');\r\n    const csv = await fs.readFile(filePath, 'utf8');\r\n    \r\n    // Конвертируем с использованием плагинов\r\n    return this.csvToJson(csv, options);\r\n  }\r\n\r\n  /**\r\n   * Парсит NDJSON данные\r\n   * @param input - NDJSON данные\r\n   * @param options - Опции\r\n   * @returns JSON данные\r\n   */\r\n  async parseNdjson(input: string | ReadableStream, options: any = {}): Promise<any[]> {\r\n    if (typeof input === 'string') {\r\n      return NdjsonParser.fromNdjson(input, options);\r\n    }\r\n    \r\n    // Для потоков\r\n    const result: any[] = [];\r\n    for await (const obj of NdjsonParser.parseStream(input, options)) {\r\n      result.push(obj);\r\n    }\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Конвертирует JSON в NDJSON\r\n   * @param data - JSON данные\r\n   * @param options - Опции\r\n   * @returns NDJSON строка\r\n   */\r\n  toNdjson(data: any[], options: any = {}): string {\r\n    return NdjsonParser.toNdjson(data, options);\r\n  }\r\n\r\n  /**\r\n   * Регистрирует плагин\r\n   * @param name - Имя плагина\r\n   * @param plugin - Конфигурация плагина\r\n   * @returns this для chaining\r\n   */\r\n  use(name: string, plugin: any): this {\r\n    this.pluginManager.use(name, plugin);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Возвращает менеджер плагинов\r\n   * @returns PluginManager\r\n   */\r\n  getPluginManager(): PluginManager {\r\n    return this.pluginManager;\r\n  }\r\n\r\n  /**\r\n   * Возвращает fast path engine\r\n   * @returns FastPathEngine\r\n   */\r\n  getFastPathEngine(): FastPathEngine {\r\n    return this.fastPathEngine;\r\n  }\r\n\r\n  /**\r\n   * Возвращает список плагинов\r\n   * @returns Array\r\n   */\r\n  listPlugins(): any[] {\r\n    return this.pluginManager.listPlugins();\r\n  }\r\n\r\n  /**\r\n   * Возвращает статистику\r\n   * @returns Object\r\n   */\r\n  getStats(): any {\r\n    return {\r\n      plugins: this.pluginManager.getStats(),\r\n      fastPath: this.fastPathEngine.getStats(),\r\n      options: this.options\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Настраивает опции\r\n   * @param newOptions - Новые опции\r\n   */\r\n  configure(newOptions: JtcsvWithPluginsOptions): this {\r\n    this.options = { ...this.options, ...newOptions };\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Создает экземпляр с настройками по умолчанию\r\n   * @param options - Опции\r\n   * @returns JtcsvWithPlugins\r\n   */\r\n  static create(options: JtcsvWithPluginsOptions = {}): JtcsvWithPlugins {\r\n    return new JtcsvWithPlugins(options);\r\n  }\r\n}\r\n\r\n// Экспортируем основной класс\r\nexport default JtcsvWithPlugins;\r\n\r\n// Экспортируем утилиты\r\nexport { PluginManager, FastPathEngine, NdjsonParser };\r\n\r\n// Экспортируем фабричный метод\r\nexport const create = JtcsvWithPlugins.create;\n"]}

package/dist/src/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"","sourcesContent":["/**\r\n * TypeScript интерфейсы для проекта jtcsv\r\n */\r\n\r\n// Базовые типы\r\nexport type AnyObject = Record<string, any>;\r\nexport type AnyArray = any[];\r\n\r\n// JSON to CSV интерфейсы\r\nexport interface JsonToCsvOptions {\r\n  /** CSV delimiter (default: ';') */\r\n  delimiter?: string;\r\n  /** Include headers row (default: true) */\r\n  includeHeaders?: boolean;\r\n  /** Rename column headers { oldKey: newKey } */\r\n  renameMap?: Record<string, string>;\r\n  /** Template for guaranteed column order */\r\n  template?: Record<string, any>;\r\n  /** Maximum number of records to process (optional, no limit by default) */\r\n  maxRecords?: number;\r\n  /** Prevent CSV injection attacks by escaping formulas (default: true) */\r\n  preventCsvInjection?: boolean;\r\n  /** Ensure RFC 4180 compliance (proper quoting, line endings) (default: true) */\r\n  rfc4180Compliant?: boolean;\r\n  /** Normalize excessive quotes in JSON string values before CSV export (default: true) */\r\n  normalizeQuotes?: boolean;\r\n  /** JSON schema for data validation and formatting */\r\n  schema?: Record<string, any>;\r\n  /** Whether to flatten nested objects into dot notation keys */\r\n  flatten?: boolean;\r\n  /** Separator for flattened keys (e.g., 'user.name' with '.') */\r\n  flattenSeparator?: string;\r\n  /** Maximum depth for flattening nested objects */\r\n  flattenMaxDepth?: number;\r\n  /** How to handle arrays ('stringify', 'join', 'expand') */\r\n  arrayHandling?: 'stringify' | 'join' | 'expand';\r\n  /** Warn when record count exceeds this threshold (default: 1000000) */\r\n  memoryWarningThreshold?: number;\r\n  /** Safety limit for in-memory conversion (default: 5000000). Set to Infinity to disable. */\r\n  memoryLimit?: number;\r\n}\r\n\r\nexport interface SaveAsCsvOptions extends JsonToCsvOptions {\r\n  /** Validate file path security (default: true) */\r\n  validatePath?: boolean;\r\n}\r\n\r\n// CSV to JSON интерфейсы\r\nexport interface CsvToJsonOptions {\r\n  /** CSV delimiter (default: auto-detected) */\r\n  delimiter?: string;\r\n  /** Auto-detect delimiter if not specified (default: true) */\r\n  autoDetect?: boolean;\r\n  /** Candidate delimiters for auto-detection (default: [';', ',', '\\t', '|']) */\r\n  candidates?: string[];\r\n  /** Whether CSV has headers row (default: true) */\r\n  hasHeaders?: boolean;\r\n  /** Map for renaming column headers { newKey: oldKey } */\r\n  renameMap?: Record<string, string>;\r\n  /** Trim whitespace from values (default: true) */\r\n  trim?: boolean;\r\n  /** Parse numeric values (default: false) */\r\n  parseNumbers?: boolean;\r\n  /** Parse boolean values (default: false) */\r\n  parseBooleans?: boolean;\r\n  /** Maximum number of rows to process (optional, no limit by default) */\r\n  maxRows?: number;\r\n  /** Enable fast-path parsing (default: true) */\r\n  useFastPath?: boolean;\r\n  /** Fast-path output mode (default: 'objects') */\r\n  fastPathMode?: 'objects' | 'compact' | 'stream';\r\n  /** JSON schema for validation and formatting */\r\n  schema?: Record<string, any>;\r\n  /** Custom transform function for each row */\r\n  transform?: (row: Record<string, any>) => Record<string, any>;\r\n  /** Use delimiter cache for auto-detection (default: true) */\r\n  useCache?: boolean;\r\n  /** Custom delimiter cache instance */\r\n  cache?: any; // DelimiterCache type will be imported later\r\n  /** Hooks for custom processing */\r\n  hooks?: {\r\n    beforeConvert?: (csv: string, options: CsvToJsonOptions) => string;\r\n    perRow?: (row: Record<string, any>, index: number, context?: { options: CsvToJsonOptions }) => Record<string, any>;\r\n    afterConvert?: (result: any[], options: CsvToJsonOptions) => any[];\r\n    transformHooks?: import('../core/transform-hooks').TransformHooks;\r\n    onError?: (error: Error, csv: string, options: CsvToJsonOptions) => void;\r\n  };\r\n  /** Prevent CSV injection attacks by escaping formulas (default: true) */\r\n  preventCsvInjection?: boolean;\r\n  /** Ensure RFC 4180 compliance (proper quoting, line endings) (default: true) */\r\n  rfc4180Compliant?: boolean;\r\n  /** Warn about extra fields not in headers (default: false) */\r\n  warnExtraFields?: boolean;\r\n  /** Error recovery strategy for row-level errors (default: 'throw') */\r\n  onError?: 'skip' | 'warn' | 'throw';\r\n  /** Custom error handler for row-level errors */\r\n  errorHandler?: (error: Error, line: string, lineNumber: number) => void;\r\n  /** Warn when row count exceeds this threshold (default: 1000000) */\r\n  memoryWarningThreshold?: number;\r\n  /** Safety limit for in-memory conversion (default: 5000000). Set to Infinity to disable. */\r\n  memoryLimit?: number;\r\n  /** Attempt to repair shifted rows with trailing empty fields (default: true) */\r\n  repairRowShifts?: boolean;\r\n  /** Normalize excessive quotes in parsed fields (default: true) */\r\n  normalizeQuotes?: boolean;\r\n}\r\n\r\n// JSON save интерфейсы\r\nexport interface SaveAsJsonOptions {\r\n  /** Format JSON with indentation (default: false) */\r\n  prettyPrint?: boolean;\r\n  /** Maximum file size in bytes (default: 10MB = 10485760) */\r\n  maxSize?: number;\r\n}\r\n\r\n// Streaming интерфейсы\r\nexport interface JsonToCsvStreamOptions extends JsonToCsvOptions {\r\n  /** Custom transform function for each row */\r\n  transform?: (row: Record<string, any>) => Record<string, any>;\r\n  /** JSON schema for validation and formatting */\r\n  schema?: Record<string, any>;\r\n  /** Add UTF-8 BOM for Excel compatibility (default: true) */\r\n  addBOM?: boolean;\r\n}\r\n\r\nexport interface CsvToJsonStreamOptions extends CsvToJsonOptions {\r\n  /** Custom transform function for each row */\r\n  transform?: (row: Record<string, any>) => Record<string, any>;\r\n  /** JSON schema for validation and formatting */\r\n  schema?: Record<string, any>;\r\n}\r\n\r\n// NDJSON интерфейсы\r\nexport interface NdjsonOptions {\r\n  /** Buffer size for streaming (default: 64KB) */\r\n  bufferSize?: number;\r\n  /** Maximum line length (default: 10MB) */\r\n  maxLineLength?: number;\r\n  /** Error handler callback */\r\n  onError?: (error: Error, line: string, lineNumber: number) => void;\r\n  /** JSON stringify replacer function */\r\n  replacer?: (key: string, value: any) => any;\r\n  /** JSON stringify space (indentation) */\r\n  space?: number | string;\r\n  /** Filter function for rows */\r\n  filter?: (obj: Record<string, any>, index: number) => boolean;\r\n  /** Transform function for rows */\r\n  transform?: (obj: Record<string, any>, index: number) => any;\r\n}\r\n\r\nexport interface NdjsonToCsvStreamOptions {\r\n  /** Delimiter for CSV output (default: ',') */\r\n  delimiter?: string;\r\n  /** Include headers row (default: true) */\r\n  includeHeaders?: boolean;\r\n  /** Rename column headers { oldKey: newKey } */\r\n  renameMap?: Record<string, string>;\r\n  /** Maximum number of records to process */\r\n  maxRecords?: number;\r\n  /** Prevent CSV injection attacks by escaping formulas (default: true) */\r\n  preventCsvInjection?: boolean;\r\n  /** Ensure RFC 4180 compliance (proper quoting, line endings) (default: true) */\r\n  rfc4180Compliant?: boolean;\r\n  /** JSON schema for validation and formatting */\r\n  schema?: Record<string, any>;\r\n  /** Custom transform function for each row */\r\n  transform?: (row: Record<string, any>) => Record<string, any>;\r\n  /** Add UTF-8 BOM for Excel compatibility (default: true) */\r\n  addBOM?: boolean;\r\n}\r\n\r\n// TSV интерфейсы\r\nexport interface TsvOptions {\r\n  /** Whether TSV has headers row (default: true) */\r\n  hasHeaders?: boolean;\r\n  /** Trim whitespace from values (default: true) */\r\n  trim?: boolean;\r\n  /** Parse numeric values (default: false) */\r\n  parseNumbers?: boolean;\r\n  /** Parse boolean values (default: false) */\r\n  parseBooleans?: boolean;\r\n  /** Maximum number of rows to process */\r\n  maxRows?: number;\r\n  /** JSON schema for validation and formatting */\r\n  schema?: Record<string, any>;\r\n  /** Custom transform function for each row */\r\n  transform?: (row: Record<string, any>) => Record<string, any>;\r\n}\r\n\r\nexport interface TsvValidationResult {\r\n  /** Whether the content is valid TSV */\r\n  isValid: boolean;\r\n  /** Number of rows detected */\r\n  rowCount: number;\r\n  /** Number of columns (if consistent) */\r\n  columnCount?: number;\r\n  /** Error message if invalid */\r\n  error?: string;\r\n  /** Line number where error occurred */\r\n  errorLine?: number;\r\n}\r\n\r\nexport interface ValidateTsvOptions {\r\n  /** Maximum number of rows to check */\r\n  maxRows?: number;\r\n  /** Whether to check for consistent column count */\r\n  checkConsistency?: boolean;\r\n  /** Whether to validate TSV format strictly */\r\n  strict?: boolean;\r\n}\r\n\r\n// Worker интерфейсы для многопоточной обработки\r\nexport interface WorkerTask<T = any, R = any> {\r\n  id: string;\r\n  data: T;\r\n  type: string;\r\n  options?: Record<string, any>;\r\n}\r\n\r\nexport interface WorkerResult<R = any> {\r\n  id: string;\r\n  result: R;\r\n  error?: Error;\r\n  duration: number;\r\n}\r\n\r\nexport interface WorkerPoolStats {\r\n  totalWorkers: number;\r\n  activeWorkers: number;\r\n  idleWorkers: number;\r\n  totalTasks: number;\r\n  completedTasks: number;\r\n  failedTasks: number;\r\n  averageTaskDuration: number;\r\n  memoryUsage?: NodeJS.MemoryUsage;\r\n}\r\n\r\n// Асинхронные интерфейсы\r\nexport interface AsyncJsonToCsvOptions extends JsonToCsvOptions {\r\n  /** Use worker threads for processing (default: auto-detect based on data size) */\r\n  useWorkers?: boolean;\r\n  /** Number of worker threads to use (default: CPU cores - 1) */\r\n  workerCount?: number;\r\n  /** Size of data chunks for parallel processing */\r\n  chunkSize?: number;\r\n  /** Progress callback function */\r\n  onProgress?: (progress: { processed: number; total: number; percentage: number }) => void;\r\n}\r\n\r\nexport interface AsyncCsvToJsonOptions extends CsvToJsonOptions {\r\n  /** Use worker threads for processing (default: auto-detect based on data size) */\r\n  useWorkers?: boolean;\r\n  /** Number of worker threads to use (default: CPU cores - 1) */\r\n  workerCount?: number;\r\n  /** Size of data chunks for parallel processing */\r\n  chunkSize?: number;\r\n  /** Progress callback function */\r\n  onProgress?: (progress: { processed: number; total: number; percentage: number }) => void;\r\n}\r\n\r\n// Утилитарные типы\r\nexport type PreprocessOptions = {\r\n  flatten?: boolean;\r\n  flattenSeparator?: string;\r\n  flattenMaxDepth?: number;\r\n  arrayHandling?: 'stringify' | 'join' | 'expand';\r\n};\r\n\r\nexport type DeepUnwrapOptions = {\r\n  maxDepth?: number;\r\n  preserveArrays?: boolean;\r\n};\r\n\r\n// Экспорт всех интерфейсов\r\n// Примечание: Типы ошибок экспортируются из errors.ts\r\n"]}