jtcsv 2.2.8 → 3.1.0

package/dist/json-save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-save.js","sourceRoot":"","sources":["../json-save.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * JSON Save Module - TypeScript Module\r\n * \r\n * A lightweight module for saving JSON data to files with security validation.\r\n */\r\n\r\nimport {\r\n  ValidationError,\r\n  SecurityError,\r\n  FileSystemError,\r\n  LimitError,\r\n  ConfigurationError,\r\n  safeExecuteSync,\r\n  safeExecuteAsync,\r\n  ErrorCode\r\n} from './errors';\r\n\r\nimport { SaveAsJsonOptions, AnyObject, AnyArray } from './src/types';\r\nimport * as fs from 'fs';\r\nimport * as path from 'path';\r\n\r\n/**\r\n * Validates file path for JSON saving\r\n * @private\r\n */\r\nexport function validateJsonFilePath(filePath: string): string {\n  // Basic validation\r\n  if (typeof filePath !== 'string' || filePath.trim() === '') {\r\n    throw new ValidationError('File path must be a non-empty string');\r\n  }\r\n\r\n  // Ensure file has .json extension\r\n  if (!filePath.toLowerCase().endsWith('.json')) {\r\n    throw new ValidationError('File must have .json extension');\r\n  }\r\n\r\n  // Block UNC paths BEFORE path.resolve() to avoid network lookup timeouts\r\n  if (filePath.startsWith('\\\\\\\\') || filePath.startsWith('//')) {\r\n    throw new SecurityError('UNC paths are not allowed');\r\n  }\r\n\r\n  // Get absolute path and check for traversal\r\n  const absolutePath = path.resolve(filePath);\r\n  const normalizedPath = path.normalize(filePath);\r\n  \r\n  // Prevent directory traversal attacks\r\n  if (normalizedPath.includes('..') || \r\n      /\\\\\\.\\.\\\\|\\/\\.\\.\\//.test(filePath) ||\r\n      filePath.startsWith('..') ||\r\n      filePath.includes('/..')) {\r\n    throw new SecurityError('Directory traversal detected in file path');\r\n  }\r\n  \r\n  return absolutePath;\r\n}\r\n\r\n/**\r\n * Validates JSON data and options\r\n * @private\r\n */\r\nfunction validateJsonData(data: any, options?: SaveAsJsonOptions): boolean {\r\n  // Validate data\r\n  if (data === undefined || data === null) {\r\n    throw new ValidationError('Data cannot be null or undefined');\r\n  }\r\n  \r\n  // Validate options\r\n  if (options && typeof options !== 'object') {\r\n    throw new ConfigurationError('Options must be an object');\r\n  }\r\n  \r\n  // Validate prettyPrint\r\n  if (options?.prettyPrint !== undefined && typeof options.prettyPrint !== 'boolean') {\r\n    throw new ConfigurationError('prettyPrint must be a boolean');\r\n  }\r\n  \r\n  // Validate maxSize\r\n  if (options?.maxSize && (typeof options.maxSize !== 'number' || options.maxSize <= 0)) {\r\n    throw new ConfigurationError('maxSize must be a positive number');\r\n  }\r\n  \r\n  return true;\r\n}\r\n\r\n/**\r\n * Saves JSON data to a file\r\n * \r\n * @param data - Data to save as JSON\r\n * @param filePath - Path to save the JSON file\r\n * @param options - Configuration options\r\n * @returns Promise<void>\r\n * \r\n * @example\r\n * const { saveAsJson } = require('./json-save');\r\n * \r\n * const data = [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }];\r\n * await saveAsJson(data, './output.json', { prettyPrint: true });\r\n */\r\nexport async function saveAsJson(\n  data: any,\n  filePath: string,\n  options: SaveAsJsonOptions = {}\n): Promise<string> {\n  return safeExecuteAsync(async () => {\n    // Validate inputs\n    const safeOptions = options === null ? {} : options;\n    validateJsonData(data, safeOptions);\n    const absolutePath = validateJsonFilePath(filePath);\n    \n    const {\n      prettyPrint = false,\n      maxSize = 10485760 // 10MB default\n    } = safeOptions;\n    \n    // Convert data to JSON string\n    let jsonString: string;\n    try {\n      jsonString = prettyPrint\n        ? JSON.stringify(data, null, 2)\n        : JSON.stringify(data);\n    } catch (error: any) {\n      const message = error?.message ? String(error.message) : 'Unknown error';\n      if (message.toLowerCase().includes('circular')) {\n        throw new ValidationError('JSON contains circular references');\n      }\n      throw new ValidationError(`Failed to stringify JSON: ${message}`);\n    }\n    \n    // Check size limit\n    const byteLength = Buffer.byteLength(jsonString, 'utf8');\n    if (byteLength > maxSize) {\n      throw new LimitError(\n        `JSON size exceeds maximum limit of ${maxSize} bytes`,\n        maxSize,\n        byteLength\n      );\n    }\n    \r\n    // Ensure directory exists\r\n    const dir = path.dirname(absolutePath);\r\n    if (!fs.existsSync(dir)) {\r\n      fs.mkdirSync(dir, { recursive: true });\r\n    }\r\n    \r\n    try {\n      await fs.promises.writeFile(absolutePath, jsonString, 'utf8');\n    } catch (error: any) {\n      if (error?.code === 'EACCES') {\n        throw new FileSystemError('Permission denied', error);\n      }\n      if (error?.code === 'ENOENT') {\n        throw new FileSystemError('Directory does not exist', error);\n      }\n      if (error?.code === 'ENOSPC') {\n        throw new FileSystemError('No space left on device', error);\n      }\n      throw new FileSystemError(`Failed to write JSON file: ${error?.message || 'unknown error'}`, error);\n    }\n\n    return absolutePath;\n  }, 'FILE_SYSTEM_ERROR', { function: 'saveAsJson' });\n}\n\r\n/**\r\n * Synchronous version of saveAsJson\r\n * \r\n * @param data - Data to save as JSON\r\n * @param filePath - Path to save the JSON file\r\n * @param options - Configuration options\r\n * @returns void\r\n * \r\n * @example\r\n * const { saveAsJsonSync } = require('./json-save');\r\n * \r\n * const data = [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }];\r\n * saveAsJsonSync(data, './output.json', { prettyPrint: true });\r\n */\r\nexport function saveAsJsonSync(\n  data: any,\n  filePath: string,\n  options: SaveAsJsonOptions = {}\n): string {\n  return safeExecuteSync(() => {\n    // Validate inputs\n    const safeOptions = options === null ? {} : options;\n    validateJsonData(data, safeOptions);\n    const absolutePath = validateJsonFilePath(filePath);\n    \n    const {\n      prettyPrint = false,\n      maxSize = 10485760 // 10MB default\n    } = safeOptions;\n    \n    // Convert data to JSON string\n    let jsonString: string;\n    try {\n      jsonString = prettyPrint\n        ? JSON.stringify(data, null, 2)\n        : JSON.stringify(data);\n    } catch (error: any) {\n      const message = error?.message ? String(error.message) : 'Unknown error';\n      if (message.toLowerCase().includes('circular')) {\n        throw new ValidationError('JSON contains circular references');\n      }\n      throw new ValidationError(`Failed to stringify JSON: ${message}`);\n    }\n    \n    // Check size limit\n    const byteLength = Buffer.byteLength(jsonString, 'utf8');\n    if (byteLength > maxSize) {\n      throw new LimitError(\n        `JSON size exceeds maximum limit of ${maxSize} bytes`,\n        maxSize,\n        byteLength\n      );\n    }\n    \r\n    // Ensure directory exists\r\n    const dir = path.dirname(absolutePath);\r\n    if (!fs.existsSync(dir)) {\r\n      fs.mkdirSync(dir, { recursive: true });\r\n    }\r\n    \r\n    try {\n      fs.writeFileSync(absolutePath, jsonString, 'utf8');\n    } catch (error: any) {\n      if (error?.code === 'EACCES') {\n        throw new FileSystemError('Permission denied', error);\n      }\n      if (error?.code === 'ENOENT') {\n        throw new FileSystemError('Directory does not exist', error);\n      }\n      if (error?.code === 'ENOSPC') {\n        throw new FileSystemError('No space left on device', error);\n      }\n      throw new FileSystemError(`Failed to write JSON file: ${error?.message || 'unknown error'}`, error);\n    }\n\n    return absolutePath;\n  }, 'FILE_SYSTEM_ERROR', { function: 'saveAsJsonSync' });\n}\n\r\n/**\r\n * Asynchronous version with worker thread support for large datasets\r\n * \r\n * @param data - Data to save as JSON\r\n * @param filePath - Path to save the JSON file\r\n * @param options - Configuration options with worker support\r\n * @returns Promise<void>\r\n */\r\nexport async function saveAsJsonAsync(\r\n  data: any,\r\n  filePath: string,\r\n  options: SaveAsJsonOptions & {\r\n    useWorkers?: boolean;\r\n    workerCount?: number;\r\n    chunkSize?: number;\r\n    onProgress?: (progress: { processed: number; total: number; percentage: number }) => void;\r\n  } = {}\r\n): Promise<void> {\n  return safeExecuteAsync(async () => {\n    const { useWorkers = false, workerCount, chunkSize, onProgress, ...saveOptions } = options;\n    \n    // For now, use the standard async version\n    // TODO: Implement worker thread support for large datasets\n    await saveAsJson(data, filePath, saveOptions);\n  }, 'FILE_SYSTEM_ERROR', { function: 'saveAsJsonAsync' });\n}\n\r\n/**\r\n * Validates if a file path is safe for JSON saving\r\n * \r\n * @param filePath - File path to validate\r\n * @returns Validation result with details\r\n */\r\nexport function validateFilePath(filePath: string): {\r\n  isValid: boolean;\r\n  absolutePath?: string;\r\n  error?: string;\r\n  errorCode?: string;\r\n} {\r\n  try {\r\n    const absolutePath = validateJsonFilePath(filePath);\r\n    return {\r\n      isValid: true,\r\n      absolutePath\r\n    };\r\n  } catch (error: any) {\r\n    return {\r\n      isValid: false,\r\n      error: error.message,\r\n      errorCode: error.code || 'VALIDATION_ERROR'\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Estimates the size of JSON data in bytes\r\n * \r\n * @param data - Data to estimate size for\r\n * @param options - Options for pretty printing\r\n * @returns Estimated size in bytes\r\n */\r\nexport function estimateJsonSize(\r\n  data: any,\r\n  options: { prettyPrint?: boolean } = {}\r\n): number {\r\n  const { prettyPrint = false } = options;\r\n  \r\n  const jsonString = prettyPrint \r\n    ? JSON.stringify(data, null, 2)\r\n    : JSON.stringify(data);\r\n  \r\n  return Buffer.byteLength(jsonString, 'utf8');\r\n}\r\n\r\n/**\r\n * Creates a JSON file with proper error handling\r\n * \r\n * @param data - Data to save\r\n * @param filePath - Path to save\r\n * @param options - Save options\r\n * @returns Promise with result object\r\n */\r\nexport async function createJsonFile(\r\n  data: any,\r\n  filePath: string,\r\n  options: SaveAsJsonOptions = {}\r\n): Promise<{\r\n  success: boolean;\r\n  filePath: string;\r\n  size: number;\r\n  error?: Error;\r\n}> {\r\n  try {\r\n    await saveAsJson(data, filePath, options);\r\n    const size = estimateJsonSize(data, options);\r\n    \r\n    return {\r\n      success: true,\r\n      filePath,\r\n      size\r\n    };\r\n  } catch (error: any) {\r\n    return {\r\n      success: false,\r\n      filePath,\r\n      size: 0,\r\n      error\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Batch save multiple JSON files\r\n * \r\n * @param files - Array of file definitions\r\n * @param options - Common options for all files\r\n * @returns Promise with results\r\n */\r\nexport async function saveJsonFiles(\r\n  files: Array<{\r\n    data: any;\r\n    filePath: string;\r\n    options?: SaveAsJsonOptions;\r\n  }>,\r\n  commonOptions: SaveAsJsonOptions = {}\r\n): Promise<Array<{\r\n  success: boolean;\r\n  filePath: string;\r\n  size: number;\r\n  error?: Error;\r\n}>> {\r\n  const results = [];\r\n  \r\n  for (const file of files) {\r\n    const options = { ...commonOptions, ...file.options };\r\n    const result = await createJsonFile(file.data, file.filePath, options);\r\n    results.push(result);\r\n  }\r\n  \r\n  return results;\r\n}\n"]}

package/dist/json-to-csv.js

@@ -0,0 +1,576 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preprocessData = preprocessData;
+exports.deepUnwrap = deepUnwrap;
+exports.validateFilePath = validateFilePath;
+exports.jsonToCsv = jsonToCsv;
+exports.jsonToCsvAsync = jsonToCsvAsync;
+exports.saveAsCsv = saveAsCsv;
+exports.saveAsCsvAsync = saveAsCsvAsync;
+const errors_1 = require("./errors");
+const schema_validator_1 = require("./src/utils/schema-validator");
+function validateInput(data, options) {
+    if (!Array.isArray(data)) {
+        throw new errors_1.ValidationError('Input data must be an array');
+    }
+    if (options && typeof options !== 'object') {
+        throw new errors_1.ConfigurationError('Options must be an object');
+    }
+    if (options?.delimiter && typeof options.delimiter !== 'string') {
+        throw new errors_1.ConfigurationError('Delimiter must be a string');
+    }
+    if (options?.delimiter && options.delimiter.length !== 1) {
+        throw new errors_1.ConfigurationError('Delimiter must be a single character');
+    }
+    if (options?.renameMap && typeof options.renameMap !== 'object') {
+        throw new errors_1.ConfigurationError('renameMap must be an object');
+    }
+    if (options && options.maxRecords !== undefined) {
+        if (typeof options.maxRecords !== 'number' || options.maxRecords <= 0) {
+            throw new errors_1.ConfigurationError('maxRecords must be a positive number');
+        }
+    }
+    if (options?.memoryWarningThreshold !== undefined) {
+        if (typeof options.memoryWarningThreshold !== 'number' || options.memoryWarningThreshold <= 0) {
+            throw new errors_1.ConfigurationError('memoryWarningThreshold must be a positive number');
+        }
+    }
+    if (options?.memoryLimit !== undefined) {
+        if (typeof options.memoryLimit !== 'number') {
+            throw new errors_1.ConfigurationError('memoryLimit must be a number');
+        }
+        if (options.memoryLimit !== Infinity && options.memoryLimit <= 0) {
+            throw new errors_1.ConfigurationError('memoryLimit must be a positive number or Infinity');
+        }
+    }
+    if (options?.preventCsvInjection !== undefined && typeof options.preventCsvInjection !== 'boolean') {
+        throw new errors_1.ConfigurationError('preventCsvInjection must be a boolean');
+    }
+    if (options?.rfc4180Compliant !== undefined && typeof options.rfc4180Compliant !== 'boolean') {
+        throw new errors_1.ConfigurationError('rfc4180Compliant must be a boolean');
+    }
+    if (options?.normalizeQuotes !== undefined && typeof options.normalizeQuotes !== 'boolean') {
+        throw new errors_1.ConfigurationError('normalizeQuotes must be a boolean');
+    }
+    if (options?.schema && typeof options.schema !== 'object') {
+        throw new errors_1.ConfigurationError('schema must be an object');
+    }
+    return true;
+}
+function preprocessData(data, options = {}) {
+    const { flatten = false, flattenSeparator = '.', flattenMaxDepth = 3, arrayHandling = 'join' } = options;
+    if (!Array.isArray(data)) {
+        return [];
+    }
+    const processed = [];
+    const fastPath = !flatten && arrayHandling === 'join';
+    for (const item of data) {
+        if (!item || typeof item !== 'object') {
+            processed.push({});
+            continue;
+        }
+        if (fastPath) {
+            let hasComplex = false;
+            let hasNullish = false;
+            for (const key in item) {
+                if (!Object.prototype.hasOwnProperty.call(item, key)) {
+                    continue;
+                }
+                const value = item[key];
+                if (value === null || value === undefined) {
+                    hasNullish = true;
+                    continue;
+                }
+                if (typeof value === 'object') {
+                    hasComplex = true;
+                    break;
+                }
+            }
+            if (!hasComplex && !hasNullish) {
+                processed.push(item);
+                continue;
+            }
+            const processedItem = {};
+            for (const key in item) {
+                if (!Object.prototype.hasOwnProperty.call(item, key)) {
+                    continue;
+                }
+                const value = item[key];
+                if (value === null || value === undefined) {
+                    processedItem[key] = '';
+                }
+                else if (typeof value === 'object') {
+                    processedItem[key] = deepUnwrap(value);
+                }
+                else {
+                    processedItem[key] = value;
+                }
+            }
+            processed.push(processedItem);
+            continue;
+        }
+        let processedItem = { ...item };
+        if (flatten) {
+            processedItem = flattenObject(item, flattenSeparator, flattenMaxDepth);
+        }
+        processedItem = processArrays(processedItem, arrayHandling);
+        for (const [key, value] of Object.entries(processedItem)) {
+            if (value && typeof value === 'object') {
+                processedItem[key] = deepUnwrap(value);
+            }
+            else if (value === null || value === undefined) {
+                processedItem[key] = '';
+            }
+            else {
+                processedItem[key] = value;
+            }
+        }
+        processed.push(processedItem);
+    }
+    return processed;
+}
+function flattenObject(obj, separator = '.', maxDepth = 3, currentDepth = 0, prefix = '') {
+    if (currentDepth >= maxDepth) {
+        return { [prefix || 'value']: obj };
+    }
+    const flattened = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const newKey = prefix ? `${prefix}${separator}${key}` : key;
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            const nestedFlattened = flattenObject(value, separator, maxDepth, currentDepth + 1, newKey);
+            Object.assign(flattened, nestedFlattened);
+        }
+        else {
+            flattened[newKey] = value;
+        }
+    }
+    return flattened;
+}
+function processArrays(obj, arrayHandling) {
+    const processed = { ...obj };
+    for (const [key, value] of Object.entries(obj)) {
+        if (Array.isArray(value)) {
+            switch (arrayHandling) {
+                case 'stringify':
+                    processed[key] = JSON.stringify(value);
+                    break;
+                case 'join':
+                    processed[key] = value.join(', ');
+                    break;
+                case 'expand':
+                    if (value.length > 0 && typeof value[0] === 'object') {
+                        processed[key] = JSON.stringify(value);
+                    }
+                    else {
+                        processed[key] = value.join(', ');
+                    }
+                    break;
+            }
+        }
+    }
+    return processed;
+}
+function deepUnwrap(value, depthOrOptions = 0, maxDepthParam = 10) {
+    let currentDepth = 0;
+    let maxDepth = 10;
+    let preserveArrays = false;
+    if (depthOrOptions && typeof depthOrOptions === 'object') {
+        maxDepth = typeof depthOrOptions.maxDepth === 'number' ? depthOrOptions.maxDepth : maxDepth;
+        preserveArrays = Boolean(depthOrOptions.preserveArrays);
+    }
+    else {
+        currentDepth = typeof depthOrOptions === 'number' ? depthOrOptions : 0;
+        maxDepth = typeof maxDepthParam === 'number' ? maxDepthParam : maxDepth;
+    }
+    return unwrapRecursive(value, currentDepth, maxDepth, preserveArrays, new WeakSet());
+}
+function unwrapRecursive(value, currentDepth, maxDepth, preserveArrays, seen) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (seen.has(value)) {
+            return '[Circular Reference]';
+        }
+        if (currentDepth >= maxDepth) {
+            return '[Too Deep]';
+        }
+        if (value.length === 0) {
+            return '';
+        }
+        seen.add(value);
+        if (preserveArrays) {
+            try {
+                return value.map(item => unwrapRecursive(item, currentDepth + 1, maxDepth, preserveArrays, seen));
+            }
+            finally {
+                seen.delete(value);
+            }
+        }
+        try {
+            const parts = value.map(item => unwrapRecursive(item, currentDepth + 1, maxDepth, preserveArrays, seen));
+            return parts.join(', ');
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
+    if (typeof value === 'object') {
+        if (currentDepth >= maxDepth) {
+            return '[Too Deep]';
+        }
+        if (Object.keys(value).length === 0) {
+            return '';
+        }
+        if (seen.has(value)) {
+            return '[Circular Reference]';
+        }
+        seen.add(value);
+        try {
+            return JSON.stringify(value);
+        }
+        catch (error) {
+            const message = error?.message ? String(error.message) : '';
+            if (message.toLowerCase().includes('circular')) {
+                return '[Circular Reference]';
+            }
+            return '[Unstringifiable Object]';
+        }
+        finally {
+            seen.delete(value);
+        }
+    }
+    return String(value);
+}
+function validateFilePath(filePath, options = {}) {
+    const { allowRelative = true } = options;
+    if (typeof filePath !== 'string' || filePath.trim().length === 0) {
+        throw new errors_1.ValidationError('File path must be a non-empty string');
+    }
+    const normalized = filePath.trim();
+    if (normalized.includes('\0')) {
+        throw new errors_1.SecurityError('File path contains null byte');
+    }
+    const traversalPattern = /(^|[\\/])\.\.([\\/]|$)/;
+    const pathsToCheck = [normalized];
+    try {
+        const decodedOnce = decodeURIComponent(normalized);
+        pathsToCheck.push(decodedOnce);
+        try {
+            pathsToCheck.push(decodeURIComponent(decodedOnce));
+        }
+        catch {
+        }
+    }
+    catch {
+    }
+    for (const candidate of pathsToCheck) {
+        if (candidate.includes('..') || traversalPattern.test(candidate)) {
+            throw new errors_1.SecurityError('Directory traversal detected in file path');
+        }
+    }
+    if (!allowRelative && (normalized.startsWith('./') || normalized.startsWith('.\\'))) {
+        throw new errors_1.SecurityError('Relative file paths are not allowed');
+    }
+    if (process.platform === 'win32') {
+        const normalizedWin = normalized.replace(/\//g, '\\');
+        if (normalizedWin.startsWith('\\\\')) {
+            if (!normalizedWin.toLowerCase().startsWith('\\\\?\\')) {
+                throw new errors_1.SecurityError('UNC paths are not allowed');
+            }
+            if (normalizedWin.toLowerCase().startsWith('\\\\?\\unc\\')) {
+                throw new errors_1.SecurityError('UNC paths are not allowed');
+            }
+        }
+    }
+    const ext = require('path').extname(normalized);
+    if (!ext || ext.toLowerCase() !== '.csv') {
+        throw new errors_1.ValidationError('File must have .csv extension');
+    }
+    const dangerousPatterns = [
+        /^\/etc\/passwd/,
+        /^\/etc\/shadow/,
+        /^\/proc\/self/,
+        /^\/dev\/null/,
+        /^\/dev\/zero/,
+        /^\/dev\/random/,
+        /^\/dev\/urandom/
+    ];
+    for (const pattern of dangerousPatterns) {
+        if (pattern.test(filePath)) {
+            throw new errors_1.SecurityError('File path matches dangerous pattern');
+        }
+    }
+    return true;
+}
+function jsonToCsv(data, options = {}) {
+    return (0, errors_1.safeExecuteSync)(() => {
+        validateInput(data, options);
+        const opts = options && typeof options === 'object' ? options : {};
+        const { delimiter = ';', includeHeaders = true, renameMap = {}, template = {}, maxRecords, preventCsvInjection = true, rfc4180Compliant = true, normalizeQuotes = true, schema = null, flatten = false, flattenSeparator = '.', flattenMaxDepth = 3, arrayHandling = 'stringify', memoryWarningThreshold = 1000000, memoryLimit = 5000000 } = opts;
+        let schemaValidators = null;
+        if (schema) {
+            schemaValidators = (0, schema_validator_1.createSchemaValidators)(schema);
+        }
+        if (data.length === 0) {
+            return '';
+        }
+        if (Number.isFinite(memoryLimit) && data.length > memoryLimit) {
+            throw new errors_1.LimitError(`Data size exceeds memory safety limit of ${memoryLimit} records`, memoryLimit, data.length);
+        }
+        if (memoryWarningThreshold
+            && data.length > memoryWarningThreshold
+            && process.env['NODE_ENV'] !== 'test') {
+            console.warn('Warning: Large in-memory conversion detected.\n' +
+                'Consider using streaming or batching for big datasets.\n' +
+                'Current size: ' + data.length.toLocaleString() + ' records\n' +
+                'Tip: Increase memoryLimit or set memoryLimit: Infinity to override.');
+        }
+        if (maxRecords && data.length > maxRecords) {
+            throw new errors_1.LimitError(`Data size exceeds maximum limit of ${maxRecords} records`, maxRecords, data.length);
+        }
+        const processedData = preprocessData(data, {
+            flatten,
+            flattenSeparator,
+            flattenMaxDepth,
+            arrayHandling
+        });
+        if (schemaValidators && Object.keys(schemaValidators).length > 0) {
+            for (let i = 0; i < processedData.length; i++) {
+                const row = processedData[i];
+                if (!row || typeof row !== 'object') {
+                    continue;
+                }
+                for (const [field, validator] of Object.entries(schemaValidators)) {
+                    const typedValidator = validator;
+                    const value = row[field];
+                    if (typeof typedValidator.validate === 'function' && !typedValidator.validate(value)) {
+                        throw new errors_1.ValidationError(`Invalid value for field "${field}"`);
+                    }
+                    if (typeof typedValidator.format === 'function') {
+                        row[field] = typedValidator.format(value);
+                    }
+                }
+            }
+        }
+        const allKeys = new Set();
+        const originalKeys = [];
+        for (let i = 0; i < processedData.length; i++) {
+            const item = processedData[i];
+            if (!item || typeof item !== 'object') {
+                continue;
+            }
+            for (const key in item) {
+                if (Object.prototype.hasOwnProperty.call(item, key) && !allKeys.has(key)) {
+                    allKeys.add(key);
+                    originalKeys.push(key);
+                }
+            }
+        }
+        const hasRenameMap = Object.keys(renameMap).length > 0;
+        const hasTemplate = Object.keys(template).length > 0;
+        let headers = originalKeys;
+        let reverseRenameMap = null;
+        if (hasRenameMap) {
+            headers = new Array(originalKeys.length);
+            reverseRenameMap = {};
+            for (let i = 0; i < originalKeys.length; i++) {
+                const key = originalKeys[i];
+                const header = renameMap[key] || key;
+                headers[i] = header;
+                reverseRenameMap[header] = key;
+            }
+        }
+        let finalHeaders = headers;
+        if (hasTemplate) {
+            const templateKeys = Object.keys(template);
+            const templateHeaders = hasRenameMap
+                ? templateKeys.map(key => renameMap[key] || key)
+                : templateKeys;
+            const templateHeaderSet = new Set(templateHeaders);
+            const extraHeaders = [];
+            for (let i = 0; i < headers.length; i++) {
+                const header = headers[i];
+                if (!templateHeaderSet.has(header)) {
+                    extraHeaders.push(header);
+                }
+            }
+            finalHeaders = templateHeaders.concat(extraHeaders);
+        }
+        const finalKeys = new Array(finalHeaders.length);
+        if (hasRenameMap && reverseRenameMap) {
+            for (let i = 0; i < finalHeaders.length; i++) {
+                const header = finalHeaders[i];
+                finalKeys[i] = reverseRenameMap[header] || header;
+            }
+        }
+        else {
+            for (let i = 0; i < finalHeaders.length; i++) {
+                finalKeys[i] = finalHeaders[i];
+            }
+        }
+        const phoneKeys = new Set(['phone', 'phonenumber', 'phone_number', 'tel', 'telephone']);
+        const normalizeQuotesInField = (value) => {
+            if ((value.startsWith('{') && value.endsWith('}')) ||
+                (value.startsWith('[') && value.endsWith(']'))) {
+                return value;
+            }
+            let normalized = value.replace(/"{2,}/g, '"');
+            normalized = normalized.replace(/"\n/g, '\n').replace(/\n"/g, '\n');
+            if (normalized.length >= 2 && normalized.startsWith('"') && normalized.endsWith('"')) {
+                normalized = normalized.slice(1, -1);
+            }
+            return normalized;
+        };
+        const normalizePhoneValue = (value) => {
+            const trimmed = value.trim();
+            if (trimmed === '') {
+                return trimmed;
+            }
+            return trimmed.replace(/["'\\]/g, '');
+        };
+        const normalizeValueForCsv = (value, key) => {
+            if (!normalizeQuotes || typeof value !== 'string') {
+                return value;
+            }
+            const base = normalizeQuotesInField(value);
+            if (key && phoneKeys.has(String(key).toLowerCase())) {
+                return normalizePhoneValue(base);
+            }
+            return base;
+        };
+        const quoteRegex = /"/g;
+        const delimiterCode = delimiter.charCodeAt(0);
+        const isPotentialFormula = (value) => {
+            let idx = 0;
+            while (idx < value.length) {
+                const code = value.charCodeAt(idx);
+                if (code === 32 || code === 9 || code === 10 || code === 13 || code === 0xfeff) {
+                    idx++;
+                    continue;
+                }
+                break;
+            }
+            if (idx < value.length && (value[idx] === '"' || value[idx] === "'")) {
+                idx++;
+                while (idx < value.length) {
+                    const code = value.charCodeAt(idx);
+                    if (code === 32 || code === 9) {
+                        idx++;
+                        continue;
+                    }
+                    break;
+                }
+            }
+            if (idx >= value.length) {
+                return false;
+            }
+            const char = value[idx];
+            return char === '=' || char === '+' || char === '-' || char === '@';
+        };
+        const escapeValue = (value) => {
+            if (value === null || value === undefined || value === '') {
+                return '';
+            }
+            let stringValue = value;
+            if (typeof stringValue !== 'string') {
+                stringValue = String(stringValue);
+            }
+            let escapedValue = stringValue;
+            if (preventCsvInjection) {
+                if (isPotentialFormula(stringValue)) {
+                    escapedValue = "'" + stringValue;
+                }
+                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;
+            let hasQuote = false;
+            for (let i = 0; i < escapedValue.length; i++) {
+                const code = escapedValue.charCodeAt(i);
+                if (code === 34) {
+                    hasQuote = true;
+                    needsQuoting = true;
+                }
+                else if (code === delimiterCode || code === 10 || code === 13) {
+                    needsQuoting = true;
+                }
+            }
+            if (needsQuoting) {
+                const quotedValue = hasQuote ? escapedValue.replace(quoteRegex, '""') : escapedValue;
+                return `"${quotedValue}"`;
+            }
+            return escapedValue;
+        };
+        const rows = [];
+        if (includeHeaders) {
+            const headerRow = finalHeaders.map(header => escapeValue(header)).join(delimiter);
+            rows.push(headerRow);
+        }
+        for (let i = 0; i < processedData.length; i++) {
+            const item = processedData[i];
+            const rowValues = [];
+            for (let j = 0; j < finalKeys.length; j++) {
+                const key = finalKeys[j];
+                const value = item && typeof item === 'object' ? item[key] : undefined;
+                const normalized = normalizeValueForCsv(value, key);
+                rowValues.push(escapeValue(normalized));
+            }
+            rows.push(rowValues.join(delimiter));
+        }
+        let csv = rows.join(rfc4180Compliant ? '\r\n' : '\n');
+        return csv;
+    }, 'PARSING_ERROR', { function: 'jsonToCsv' });
+}
+async function jsonToCsvAsync(data, options = {}) {
+    return (0, errors_1.safeExecuteAsync)(async () => {
+        const { useWorkers = false, workerCount, chunkSize, onProgress, ...syncOptions } = options;
+        return jsonToCsv(data, syncOptions);
+    }, 'PARSING_ERROR', { function: 'jsonToCsvAsync' });
+}
+async function saveAsCsv(data, filePath, options = {}) {
+    return (0, errors_1.safeExecuteAsync)(async () => {
+        const { validatePath = true, ...csvOptions } = options;
+        if (validatePath) {
+            validateFilePath(filePath);
+        }
+        const path = require('path');
+        const fs = require('fs');
+        const resolvedPath = path.resolve(filePath);
+        const dir = path.dirname(resolvedPath);
+        try {
+            await fs.promises.mkdir(dir, { recursive: true });
+            const csv = jsonToCsv(data, csvOptions);
+            await fs.promises.writeFile(resolvedPath, csv, 'utf8');
+        }
+        catch (error) {
+            if (error instanceof errors_1.JtcsvError) {
+                throw error;
+            }
+            throw new errors_1.FileSystemError(error.message || 'File system error', error);
+        }
+    }, 'FILE_SYSTEM_ERROR', { function: 'saveAsCsv' });
+}
+async function saveAsCsvAsync(data, filePath, options = {}) {
+    return saveAsCsv(data, filePath, options);
+}
+exports.default = {
+    jsonToCsv,
+    jsonToCsvAsync,
+    preprocessData,
+    deepUnwrap,
+    validateFilePath,
+    saveAsCsv,
+    saveAsCsvAsync
+};
+//# sourceMappingURL=json-to-csv.js.map