npm - convert-csv-to-json - Versions diffs - 4.2.0 → 4.3.0 - Mend

convert-csv-to-json 4.2.0 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (60) hide show

package/.eslintignore +3 -0
package/.eslintrc.json +48 -0
package/.github/workflows/ci-cd.yml +28 -2
package/docs/api/BrowserApi.html +2435 -0
package/docs/api/BrowserApiError.html +522 -0
package/docs/api/ConfigurationError.html +594 -0
package/docs/api/CsvFormatError.html +530 -0
package/docs/api/CsvParsingError.html +384 -0
package/docs/api/CsvToJson.html +3136 -0
package/docs/api/CsvToJsonAsync.html +2672 -0
package/docs/api/FileOperationError.html +270 -0
package/docs/api/FileUtils.html +1012 -0
package/docs/api/InputValidationError.html +293 -0
package/docs/api/JsonUtil.html +340 -0
package/docs/api/JsonValidationError.html +247 -0
package/docs/api/fonts/OpenSans-Bold-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Bold-webfont.svg +1830 -0
package/docs/api/fonts/OpenSans-Bold-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-BoldItalic-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-BoldItalic-webfont.svg +1830 -0
package/docs/api/fonts/OpenSans-BoldItalic-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-Italic-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Italic-webfont.svg +1830 -0
package/docs/api/fonts/OpenSans-Italic-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-Light-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Light-webfont.svg +1831 -0
package/docs/api/fonts/OpenSans-Light-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-LightItalic-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-LightItalic-webfont.svg +1835 -0
package/docs/api/fonts/OpenSans-LightItalic-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-Regular-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Regular-webfont.svg +1831 -0
package/docs/api/fonts/OpenSans-Regular-webfont.woff +0 -0
package/docs/api/global.html +3315 -0
package/docs/api/index.html +326 -0
package/docs/api/index.js.html +341 -0
package/docs/api/scripts/linenumber.js +25 -0
package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -0
package/docs/api/scripts/prettify/lang-css.js +2 -0
package/docs/api/scripts/prettify/prettify.js +28 -0
package/docs/api/src_browserApi.js.html +271 -0
package/docs/api/src_csvToJson.js.html +605 -0
package/docs/api/src_csvToJsonAsync.js.html +244 -0
package/docs/api/src_util_errors.js.html +374 -0
package/docs/api/src_util_fileUtils.js.html +147 -0
package/docs/api/src_util_jsonUtils.js.html +75 -0
package/docs/api/src_util_stringUtils.js.html +212 -0
package/docs/api/styles/jsdoc-default.css +358 -0
package/docs/api/styles/prettify-jsdoc.css +111 -0
package/docs/api/styles/prettify-tomorrow.css +132 -0
package/index.js +109 -32
package/jsdoc.json +17 -0
package/package.json +10 -3
package/src/browserApi.js +96 -4
package/src/csvToJson.js +163 -2
package/src/csvToJsonAsync.js +74 -14
package/src/util/errors.js +96 -0
package/src/util/fileUtils.js +34 -0
package/src/util/jsonUtils.js +8 -0
package/src/util/stringUtils.js +51 -0

package/docs/api/src_csvToJsonAsync.js.html ADDED Viewed

@@ -0,0 +1,244 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>JSDoc: Source: src/csvToJsonAsync.js</title>
+    <script src="scripts/prettify/prettify.js"> </script>
+    <script src="scripts/prettify/lang-css.js"> </script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+<body>
+<div id="main">
+    <h1 class="page-title">Source: src/csvToJsonAsync.js</h1>
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>/* globals CsvFormatError, FileOperationError */
+'use strict';
+const fileUtils = require('./util/fileUtils');
+const csvToJson = require('./csvToJson');
+const { InputValidationError } = require('./util/errors');
+/**
+ * Asynchronous CSV to JSON converter
+ * Proxies configuration to sync instance but provides async file I/O methods
+ */
+class CsvToJsonAsync {
+    /**
+     * Constructor initializes proxy to sync csvToJson instance
+     */
+    constructor() {
+        // Proxy the configuration methods to the sync instance
+        this.csvToJson = csvToJson;
+    }
+    /**
+     * Enable or disable automatic type formatting for values
+     * @param {boolean} active - Whether to format values by type
+     * @returns {this} For method chaining
+     */
+    formatValueByType(active) {
+        this.csvToJson.formatValueByType(active);
+        return this;
+    }
+    /**
+     * Enable or disable support for RFC 4180 quoted fields
+     * @param {boolean} active - Whether to support quoted fields
+     * @returns {this} For method chaining
+     */
+    supportQuotedField(active) {
+        this.csvToJson.supportQuotedField(active);
+        return this;
+    }
+    /**
+     * Set the field delimiter character
+     * @param {string} delimiter - Character(s) to use as field separator
+     * @returns {this} For method chaining
+     */
+    fieldDelimiter(delimiter) {
+        this.csvToJson.fieldDelimiter(delimiter);
+        return this;
+    }
+    /**
+     * Configure whitespace handling in header field names
+     * @param {boolean} active - If true, removes all whitespace; if false, only trims edges
+     * @returns {this} For method chaining
+     */
+    trimHeaderFieldWhiteSpace(active) {
+        this.csvToJson.trimHeaderFieldWhiteSpace(active);
+        return this;
+    }
+    /**
+     * Set the row index where CSV headers are located
+     * @param {number} indexHeader - Zero-based row index containing headers
+     * @returns {this} For method chaining
+     */
+    indexHeader(indexHeader) {
+        this.csvToJson.indexHeader(indexHeader);
+        return this;
+    }
+    /**
+     * Configure sub-array parsing for special field values
+     * @param {string} delimiter - Bracket character (default: '*')
+     * @param {string} separator - Item separator within brackets (default: ',')
+     * @returns {this} For method chaining
+     */
+    parseSubArray(delimiter = '*', separator = ',') {
+        this.csvToJson.parseSubArray(delimiter, separator);
+        return this;
+    }
+    /**
+     * Set a mapper function to transform each row after conversion
+     * @param {Function} mapperFn - Function receiving (row, index) that returns transformed row or null to filter
+     * @returns {this} For method chaining
+     */
+    mapRows(mapperFn) {
+        this.csvToJson.mapRows(mapperFn);
+        return this;
+    }
+    /**
+     * Set file encoding for reading CSV files
+     * @param {string} encoding - Node.js supported encoding (e.g., 'utf8', 'latin1')
+     * @returns {this} For method chaining
+     */
+    encoding(encoding) {
+        this.csvToJson.encoding = encoding;
+        return this;
+    }
+    /**
+     * Read a CSV file and write parsed JSON to an output file (async)
+     * @param {string} fileInputName - Path to input CSV file
+     * @param {string} fileOutputName - Path to output JSON file
+     * @returns {Promise&lt;void>}
+     * @throws {FileOperationError} If file operations fail
+     * @throws {CsvFormatError} If CSV is malformed
+     */
+    async generateJsonFileFromCsv(fileInputName, fileOutputName) {
+        const jsonStringified = await this.getJsonFromCsvStringified(fileInputName);
+        await fileUtils.writeFileAsync(jsonStringified, fileOutputName);
+    }
+    /**
+     * Read a CSV file and return parsed data as stringified JSON (async)
+     * @param {string} fileInputName - Path to input CSV file
+     * @returns {Promise&lt;string>} JSON stringified array of objects
+     * @throws {FileOperationError} If file read fails
+     * @throws {CsvFormatError} If CSV is malformed
+     */
+    async getJsonFromCsvStringified(fileInputName) {
+        const json = await this.getJsonFromCsvAsync(fileInputName);
+        return JSON.stringify(json, undefined, 1);
+    }
+    /**
+     * Main async API method for reading CSV and returning parsed JSON
+     * Supports reading from file path or parsing CSV string content
+     * @param {string} inputFileNameOrCsv - File path or CSV string content
+     * @param {object} options - Configuration options
+     * @param {boolean} options.raw - If true, treats input as CSV string; if false, reads from file
+     * @returns {Promise&lt;Array&lt;object>>} Array of objects representing CSV rows
+     * @throws {InputValidationError} If input is invalid
+     * @throws {FileOperationError} If file read fails
+     * @throws {CsvFormatError} If CSV is malformed
+     * @example
+     * const csvToJson = require('convert-csv-to-json');
+     * const data = await csvToJson.getJsonFromCsvAsync('resource/input.csv');
+     * console.log(data);
+     */
+    async getJsonFromCsvAsync(inputFileNameOrCsv, options = {}) {
+        if (inputFileNameOrCsv === null || inputFileNameOrCsv === undefined) {
+            throw new InputValidationError(
+                'inputFileNameOrCsv',
+                'string (file path) or CSV string content',
+                `${typeof inputFileNameOrCsv}`,
+                'Either provide a valid file path or CSV content as a string.'
+            );
+        }
+        if (options.raw) {
+            if (inputFileNameOrCsv === '') {
+                return [];
+            }
+            return this.csvToJson.csvToJson(inputFileNameOrCsv);
+        }
+        const parsedCsv = await fileUtils.readFileAsync(inputFileNameOrCsv, this.csvToJson.encoding || 'utf8');
+        return this.csvToJson.csvToJson(parsedCsv);
+    }
+    /**
+     * Parse CSV string to JSON array (async)
+     * @param {string} csvString - CSV content as string
+     * @param {object} options - Configuration options (default: { raw: true })
+     * @returns {Promise&lt;Array&lt;object>>} Array of objects representing CSV rows
+     * @throws {CsvFormatError} If CSV is malformed
+     * @example
+     * const csvToJson = require('convert-csv-to-json');
+     * const data = await csvToJson.csvStringToJsonAsync('name,age\nAlice,30');
+     * console.log(data);
+     */
+    csvStringToJsonAsync(csvString, options = { raw: true }) {
+        return this.getJsonFromCsvAsync(csvString, options);
+    }
+    /**
+     * Parse CSV string to stringified JSON (async)
+     * @param {string} csvString - CSV content as string
+     * @returns {Promise&lt;string>} JSON stringified array of objects
+     * @throws {CsvFormatError} If CSV is malformed
+     * @example
+     * const csvToJson = require('convert-csv-to-json');
+     * const jsonString = await csvToJson.csvStringToJsonStringifiedAsync('name,age\nAlice,30');
+     * console.log(jsonString);
+     */
+    async csvStringToJsonStringifiedAsync(csvString) {
+        const json = await this.csvStringToJsonAsync(csvString);
+        return JSON.stringify(json, undefined, 1);
+    }
+}
+module.exports = new CsvToJsonAsync();</code></pre>
+        </article>
+    </section>
+</div>
+<nav>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BrowserApi.html">BrowserApi</a></li><li><a href="BrowserApiError.html">BrowserApiError</a></li><li><a href="ConfigurationError.html">ConfigurationError</a></li><li><a href="CsvFormatError.html">CsvFormatError</a></li><li><a href="CsvParsingError.html">CsvParsingError</a></li><li><a href="CsvToJson.html">CsvToJson</a></li><li><a href="CsvToJsonAsync.html">CsvToJsonAsync</a></li><li><a href="FileOperationError.html">FileOperationError</a></li><li><a href="FileUtils.html">FileUtils</a></li><li><a href="InputValidationError.html">InputValidationError</a></li><li><a href="JsonUtil.html">JsonUtil</a></li><li><a href="JsonValidationError.html">JsonValidationError</a></li></ul><h3>Global</h3><ul><li><a href="global.html#asciiEncoding">asciiEncoding</a></li><li><a href="global.html#base64Encoding">base64Encoding</a></li><li><a href="global.html#browser">browser</a></li><li><a href="global.html#csvStringToJson">csvStringToJson</a></li><li><a href="global.html#csvStringToJsonStringified">csvStringToJsonStringified</a></li><li><a href="global.html#csvToJsonAsync">csvToJsonAsync</a></li><li><a href="global.html#customEncoding">customEncoding</a></li><li><a href="global.html#fieldDelimiter">fieldDelimiter</a></li><li><a href="global.html#formatValueByType">formatValueByType</a></li><li><a href="global.html#generateJsonFileFromCsv">generateJsonFileFromCsv</a></li><li><a href="global.html#getJsonFromCsv">getJsonFromCsv</a></li><li><a href="global.html#hexEncoding">hexEncoding</a></li><li><a href="global.html#indexHeader">indexHeader</a></li><li><a href="global.html#latin1Encoding">latin1Encoding</a></li><li><a href="global.html#mapRows">mapRows</a></li><li><a href="global.html#parseSubArray">parseSubArray</a></li><li><a href="global.html#supportQuotedField">supportQuotedField</a></li><li><a href="global.html#trimHeaderFieldWhiteSpace">trimHeaderFieldWhiteSpace</a></li><li><a href="global.html#ucs2Encoding">ucs2Encoding</a></li><li><a href="global.html#utf16leEncoding">utf16leEncoding</a></li><li><a href="global.html#utf8Encoding">utf8Encoding</a></li></ul>
+</nav>
+<br class="clear">
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.5</a> on Fri Mar 20 2026 14:48:29 GMT+0000 (Coordinated Universal Time)
+</footer>
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>

package/docs/api/src_util_errors.js.html ADDED Viewed

@@ -0,0 +1,374 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>JSDoc: Source: src/util/errors.js</title>
+    <script src="scripts/prettify/prettify.js"> </script>
+    <script src="scripts/prettify/lang-css.js"> </script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+<body>
+<div id="main">
+    <h1 class="page-title">Source: src/util/errors.js</h1>
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>'use strict';
+/**
+ * Custom error classes following clean code principles
+ * Provides clear, actionable error messages with context
+ */
+/**
+ * Base class for all CSV parsing errors
+ * Provides consistent error formatting and context
+ */
+class CsvParsingError extends Error {
+    /**
+     * Create a CSV parsing error
+     * @param {string} message - Error message
+     * @param {string} code - Error code for identification
+     * @param {object} context - Additional context information (default: {})
+     */
+    constructor(message, code, context = {}) {
+        super(message);
+        this.name = 'CsvParsingError';
+        this.code = code;
+        this.context = context;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    /**
+     * Convert error to formatted string with context information
+     * @returns {string} Formatted error message including context
+     */
+    toString() {
+        let output = `${this.name}: ${this.message}`;
+        if (this.context &amp;&amp; Object.keys(this.context).length > 0) {
+            output += '\n\nContext:';
+            Object.entries(this.context).forEach(([key, value]) => {
+                output += `\n  ${key}: ${this.formatValue(value)}`;
+            });
+        }
+        return output;
+    }
+    /**
+     * Format a context value for display in error message
+     * @param {*} value - Value to format
+     * @returns {string} Formatted value string
+     * @private
+     */
+    formatValue(value) {
+        if (value === null) return 'null';
+        if (value === undefined) return 'undefined';
+        if (typeof value === 'string') return `"${value}"`;
+        if (typeof value === 'object') return JSON.stringify(value);
+        return String(value);
+    }
+}
+/**
+ * Input validation errors
+ * Thrown when function parameters don't meet expected type or value requirements
+ */
+class InputValidationError extends CsvParsingError {
+    /**
+     * Create an input validation error
+     * @param {string} paramName - Name of the invalid parameter
+     * @param {string} expectedType - Expected type description
+     * @param {string} receivedType - Actual type received
+     * @param {string} details - Additional error details (optional)
+     */
+    constructor(paramName, expectedType, receivedType, details = '') {
+        const message =
+            `Invalid input: Parameter '${paramName}' is required.\n` +
+            `Expected: ${expectedType}\n` +
+            `Received: ${receivedType}${details ? '\n' + details : ''}`;
+        super(message, 'INPUT_VALIDATION_ERROR', {
+            parameter: paramName,
+            expectedType,
+            receivedType
+        });
+        this.name = 'InputValidationError';
+    }
+}
+/**
+ * Configuration-related errors
+ * Thrown when configuration options conflict or are invalid
+ */
+class ConfigurationError extends CsvParsingError {
+    /**
+     * Create a configuration error
+     * @param {string} message - Error message
+     * @param {object} conflictingOptions - Configuration options in conflict (optional)
+     */
+    constructor(message, conflictingOptions = {}) {
+        super(message, 'CONFIGURATION_ERROR', conflictingOptions);
+        this.name = 'ConfigurationError';
+    }
+    /**
+     * Create error for quoted field configuration conflict
+     * Occurs when quote character is used as delimiter while quoted fields are enabled
+     * @param {string} optionName - Name of the conflicting option
+     * @param {string} value - Value that causes the conflict
+     * @returns {ConfigurationError} Configured error instance
+     * @static
+     */
+    static quotedFieldConflict(optionName, value) {
+        return new ConfigurationError(
+            `Configuration conflict: supportQuotedField() is enabled, but ${optionName} is set to '${value}'.\n` +
+            `The quote character (") cannot be used as a field delimiter, separator, or sub-array delimiter when quoted field support is active.\n\n` +
+            `Solutions:\n` +
+            `  1. Use a different character for ${optionName} (e.g., '|', '\\t', ';')\n` +
+            `  2. Disable supportQuotedField() if your CSV doesn't contain quoted fields\n` +
+            `  3. Refer to RFC 4180 for proper CSV formatting: https://tools.ietf.org/html/rfc4180`,
+            { optionName, value, conflictingOption: 'supportQuotedField' }
+        );
+    }
+    /**
+     * Create error for invalid header index
+     * Occurs when indexHeader() receives non-numeric value
+     * @param {*} value - Invalid header index value
+     * @returns {ConfigurationError} Configured error instance
+     * @static
+     */
+    static invalidHeaderIndex(value) {
+        return new ConfigurationError(
+            `Invalid configuration: indexHeader() expects a numeric value.\n` +
+            `Received: ${typeof value} (${value})\n\n` +
+            `Solutions:\n` +
+            `  1. Ensure indexHeader() receives a number: indexHeader(0), indexHeader(1), etc.\n` +
+            `  2. Headers are typically found on row 0 (first line)\n` +
+            `  3. Use indexHeader(2) if headers are on the 3rd line`,
+            { parameterName: 'indexHeader', value, type: typeof value }
+        );
+    }
+}
+/**
+ * CSV parsing errors with detailed context
+ * Thrown when CSV format is invalid or malformed
+ */
+class CsvFormatError extends CsvParsingError {
+    /**
+     * Create a CSV format error
+     * @param {string} message - Error message
+     * @param {object} context - Additional context information (optional)
+     */
+    constructor(message, context = {}) {
+        super(message, 'CSV_FORMAT_ERROR', context);
+        this.name = 'CsvFormatError';
+    }
+    /**
+     * Create error for missing CSV header row
+     * Occurs when no valid header row is found in CSV
+     * @returns {CsvFormatError} Configured error instance
+     * @static
+     */
+    static missingHeader() {
+        return new CsvFormatError(
+            `CSV parsing error: No header row found.\n` +
+            `The CSV file appears to be empty or has no valid header line.\n\n` +
+            `Solutions:\n` +
+            `  1. Ensure your CSV file contains at least one row (header row)\n` +
+            `  2. Verify the file is not empty or contains only whitespace\n` +
+            `  3. Check if you need to use indexHeader(n) to specify a non-standard header row\n` +
+            `  4. Refer to RFC 4180 for proper CSV format: https://tools.ietf.org/html/rfc4180`
+        );
+    }
+    /**
+     * Create error for mismatched quotes in CSV
+     * Occurs when quoted fields are not properly closed
+     * @param {string} location - Where the error occurred (default: 'CSV')
+     * @returns {CsvFormatError} Configured error instance
+     * @static
+     */
+    static mismatchedQuotes(location = 'CSV') {
+        return new CsvFormatError(
+            `CSV parsing error: Mismatched quotes detected in ${location}.\n` +
+            `A quoted field was not properly closed with a matching quote character.\n\n` +
+            `RFC 4180 rules for quoted fields:\n` +
+            `  • Fields containing delimiters or quotes MUST be enclosed in double quotes\n` +
+            `  • To include a quote within a quoted field, use two consecutive quotes: ""\n` +
+            `  • Example: "Smith, John" (name contains comma)\n` +
+            `  • Example: "He said ""Hello""" (text contains quotes)\n\n` +
+            `Solutions:\n` +
+            `  1. Review your CSV for properly paired quote characters\n` +
+            `  2. Use double quotes ("") to escape quotes within quoted fields\n` +
+            `  3. Ensure all commas within field values are inside quotes\n` +
+            `  4. Enable supportQuotedField(true) if you're using quoted fields`,
+            { location }
+        );
+    }
+}
+/**
+ * File operation errors
+ * Thrown when file read or write operations fail
+ */
+class FileOperationError extends CsvParsingError {
+    /**
+     * Create a file operation error
+     * @param {string} operation - Type of operation that failed (e.g., 'read', 'write')
+     * @param {string} filePath - Path to the file where operation failed
+     * @param {Error} originalError - The underlying error object from Node.js
+     */
+    constructor(operation, filePath, originalError) {
+        const message =
+            `File operation error: Failed to ${operation} file.\n` +
+            `File path: ${filePath}\n` +
+            `Reason: ${originalError.message}\n\n` +
+            `Solutions:\n` +
+            `  1. Verify the file path is correct: ${filePath}\n` +
+            `  2. Check file permissions (read access for input, write access for output)\n` +
+            `  3. Ensure the directory exists and is writable for output files\n` +
+            `  4. Verify the file is not in use by another process`;
+        super(message, 'FILE_OPERATION_ERROR', {
+            operation,
+            filePath,
+            originalError: originalError.message
+        });
+        this.name = 'FileOperationError';
+        this.originalError = originalError;
+    }
+}
+/**
+ * JSON validation errors
+ * Thrown when parsed CSV data cannot be converted to valid JSON
+ */
+class JsonValidationError extends CsvParsingError {
+    /**
+     * Create a JSON validation error
+     * @param {string} csvData - The CSV data that failed validation
+     * @param {Error} originalError - The underlying JSON parsing error
+     */
+    constructor(csvData, originalError) {
+        const message =
+            `JSON validation error: The parsed CSV data generated invalid JSON.\n` +
+            `This typically indicates malformed field names or values in the CSV.\n` +
+            `Original error: ${originalError.message}\n\n` +
+            `Solutions:\n` +
+            `  1. Check that field names are valid JavaScript identifiers (or will be converted safely)\n` +
+            `  2. Review the CSV data for special characters that aren't properly escaped\n` +
+            `  3. Enable supportQuotedField(true) for fields containing special characters\n` +
+            `  4. Verify that formatValueByType() isn't converting values incorrectly`;
+        super(message, 'JSON_VALIDATION_ERROR', {
+            originalError: originalError.message,
+            csvPreview: csvData ? csvData.substring(0, 200) : 'N/A'
+        });
+        this.name = 'JsonValidationError';
+        this.originalError = originalError;
+    }
+}
+/**
+ * Browser-specific errors
+ * Thrown when browser API operations fail
+ */
+class BrowserApiError extends CsvParsingError {
+    /**
+     * Create a browser API error
+     * @param {string} message - Error message
+     * @param {object} context - Additional context information (optional)
+     */
+    constructor(message, context = {}) {
+        super(message, 'BROWSER_API_ERROR', context);
+        this.name = 'BrowserApiError';
+    }
+    /**
+     * Create error for unavailable FileReader API
+     * Occurs when browser doesn't support FileReader
+     * @returns {BrowserApiError} Configured error instance
+     * @static
+     */
+    static fileReaderNotAvailable() {
+        return new BrowserApiError(
+            `Browser compatibility error: FileReader API is not available.\n` +
+            `Your browser does not support the FileReader API required for file parsing.\n\n` +
+            `Solutions:\n` +
+            `  1. Use a modern browser that supports FileReader (Chrome 13+, Firefox 10+, Safari 6+)\n` +
+            `  2. Consider using csvStringToJson() or csvStringToJsonAsync() for string-based parsing\n` +
+            `  3. Implement a polyfill or alternative file reading method`
+        );
+    }
+    /**
+     * Create error for file parsing failure in browser
+     * Occurs when file read or CSV parse fails
+     * @param {Error} originalError - The underlying error that occurred
+     * @returns {BrowserApiError} Configured error instance
+     * @static
+     */
+    static parseFileError(originalError) {
+        return new BrowserApiError(
+            `Browser file parsing error: Failed to read and parse the file.\n` +
+            `Error details: ${originalError.message}\n\n` +
+            `Solutions:\n` +
+            `  1. Verify the file is a valid CSV file\n` +
+            `  2. Check the file encoding (UTF-8 is recommended)\n` +
+            `  3. Try a smaller file to isolate the issue\n` +
+            `  4. Check browser console for additional error details`,
+            { originalError: originalError.message }
+        );
+    }
+}
+module.exports = {
+    CsvParsingError,
+    InputValidationError,
+    ConfigurationError,
+    CsvFormatError,
+    FileOperationError,
+    JsonValidationError,
+    BrowserApiError
+};
+</code></pre>
+        </article>
+    </section>
+</div>
+<nav>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BrowserApi.html">BrowserApi</a></li><li><a href="BrowserApiError.html">BrowserApiError</a></li><li><a href="ConfigurationError.html">ConfigurationError</a></li><li><a href="CsvFormatError.html">CsvFormatError</a></li><li><a href="CsvParsingError.html">CsvParsingError</a></li><li><a href="CsvToJson.html">CsvToJson</a></li><li><a href="CsvToJsonAsync.html">CsvToJsonAsync</a></li><li><a href="FileOperationError.html">FileOperationError</a></li><li><a href="FileUtils.html">FileUtils</a></li><li><a href="InputValidationError.html">InputValidationError</a></li><li><a href="JsonUtil.html">JsonUtil</a></li><li><a href="JsonValidationError.html">JsonValidationError</a></li></ul><h3>Global</h3><ul><li><a href="global.html#asciiEncoding">asciiEncoding</a></li><li><a href="global.html#base64Encoding">base64Encoding</a></li><li><a href="global.html#browser">browser</a></li><li><a href="global.html#csvStringToJson">csvStringToJson</a></li><li><a href="global.html#csvStringToJsonStringified">csvStringToJsonStringified</a></li><li><a href="global.html#csvToJsonAsync">csvToJsonAsync</a></li><li><a href="global.html#customEncoding">customEncoding</a></li><li><a href="global.html#fieldDelimiter">fieldDelimiter</a></li><li><a href="global.html#formatValueByType">formatValueByType</a></li><li><a href="global.html#generateJsonFileFromCsv">generateJsonFileFromCsv</a></li><li><a href="global.html#getJsonFromCsv">getJsonFromCsv</a></li><li><a href="global.html#hexEncoding">hexEncoding</a></li><li><a href="global.html#indexHeader">indexHeader</a></li><li><a href="global.html#latin1Encoding">latin1Encoding</a></li><li><a href="global.html#mapRows">mapRows</a></li><li><a href="global.html#parseSubArray">parseSubArray</a></li><li><a href="global.html#supportQuotedField">supportQuotedField</a></li><li><a href="global.html#trimHeaderFieldWhiteSpace">trimHeaderFieldWhiteSpace</a></li><li><a href="global.html#ucs2Encoding">ucs2Encoding</a></li><li><a href="global.html#utf16leEncoding">utf16leEncoding</a></li><li><a href="global.html#utf8Encoding">utf8Encoding</a></li></ul>
+</nav>
+<br class="clear">
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.5</a> on Fri Mar 20 2026 14:48:29 GMT+0000 (Coordinated Universal Time)
+</footer>
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>