convert-csv-to-json 3.12.0 → 3.12.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- New `csvStringToJsonStringified()` method that converts CSV content directly to a validated JSON string without requiring file I/O
+- Improved test coverage for string-based CSV parsing
+
+### Changed
+- No breaking changes - all existing APIs remain unchanged

package/README.md

@@ -41,6 +41,7 @@ show your :heart: and support.
       - [Number](#number)
       - [Boolean](#boolean)
     + [Encoding](#encoding)
+    + [Working with CSV strings directly](#working-with-csv-strings-directly)
   * [Chaining Pattern](#chaining-pattern)
 - [Development](#development)
 - [CI CD github action](#ci-cd-github-action)
@@ -306,6 +307,30 @@ You can read and decode files with the following encoding:
                   .getJsonFromCsv(fileInputName);
       ```
 
+#### Working with CSV strings directly
+If you have CSV content as a string (for example, from an API response or test data), you can parse it directly without writing to a file:
+
+```js
+
+// Parse CSV string to array of objects
+let csvString = 'firstName;lastName\nJohn;Doe\nJane;Smith';
+let jsonArray = csvToJson.csvStringToJson(csvString);
+// Output: [{"firstName":"John","lastName":"Doe"},{"firstName":"Jane","lastName":"Smith"}]
+
+// Parse CSV string to JSON string (validated)
+let jsonString = csvToJson.csvStringToJsonStringified(csvString);
+// Output: "[\n {\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\"\n },\n {\n  \"firstName\": \"Jane\",\n  \"lastName\": \"Smith\"\n }\n]"
+```
+
+Both methods support all configuration options through the chaining pattern:
+
+```js
+let jsonArray = csvToJson
+  .fieldDelimiter(',')
+  .formatValueByType()
+  .csvStringToJson(csvString);
+```
+
 ### Chaining Pattern
 
 The exposed API is implemented with the [Method Chaining Pattern](https://en.wikipedia.org/wiki/Method_chaining), which means that multiple methods can be chained, e.g.:

package/index.d.ts

@@ -92,6 +92,14 @@ declare module 'convert-csv-to-json' {
     getJsonFromCsv(inputFileName: string): any[];
 
     csvStringToJson(csvString: string): any[];
+
+    /**
+    * Parses a csv string and returns a JSON string (validated)
+    * @param {csvString} csvString CSV content as string
+    * @return {string} JSON stringified result
+    */
+    csvStringToJsonStringified(csvString: string): string;
+    
     /**
      * Parses .csv file and put its content into a file in json format.
      * @param {inputFileName} path/filename

package/index.js

@@ -156,6 +156,18 @@ exports.csvStringToJson = function(csvString) {
   return csvToJson.csvStringToJson(csvString);
 };
 
+/**
+ * Parses a csv string and returns a JSON string (validated)
+ * @param {csvString} csvString CSV content as string
+ * @return {string} JSON stringified result
+ */
+exports.csvStringToJsonStringified = function(csvString) {
+  if (csvString === undefined || csvString === null) {
+    throw new Error("csvString is not defined!!!");
+  }
+  return csvToJson.csvStringToJsonStringified(csvString);
+};
+
 /**
  * Parses .csv file and put its content into a file in json format.
  * @param {inputFileName} path/filename

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convert-csv-to-json",
-  "version": "3.12.0",
+  "version": "3.12.1",
   "description": "Convert CSV to JSON",
   "main": "index.js",
   "types": "index.d.ts",

package/src/csvToJson.js

@@ -69,6 +69,13 @@ class CsvToJson {
     return this.csvToJson(csvString);
   }
 
+  csvStringToJsonStringified(csvString) {
+    let json = this.csvStringToJson(csvString);
+    let jsonStringified = JSON.stringify(json, undefined, 1);
+    jsonUtils.validateJson(jsonStringified);
+    return jsonStringified;
+  }
+
   csvToJson(parsedCsv) {
   	this.validateInputConfig();
     let lines = parsedCsv.split(newLine);