select-csv 1.1.20 → 1.1.22

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Housseyn Cheriet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,22 +1,19 @@
-Parse CSV with JavaScript
-========================================
-
-It is the fastest, simplest and most powerful package of all existing libraries in npmjs. It converts .csv files into an array and even into lines. It contains two important functions parseCsv that handles a csv file, you only need a link to the file. And parseText deals with text, and they both have the same roles and and methods, and it comes with these features:
-
-- Package with small content (< 30 KB)
-- Easy to use
-- Parse CSV files directly (local)
-- Fast mode
-- Stream large files
-- It is a synchronous package
-- Uses chunks
-- Uses row offset (get rows from line x to line x+n)
-- Returns rows (with columns) or lines (without columns)
-- No external dependencies
-- Flexible with lots of options (header, quote, line break, delimiter, bufferSize in CSV file, Rows in an array or json array)
-- One of the only parsers that correctly handles line-breaks and quotations
-
-select-csv has **no dependencies** .
+# select-csv
+
+The fastest, simplest, and most powerful CSV parser for Node.js. Optimized for high performance and extreme memory efficiency when handling massive datasets (100M+ rows).
+
+`select-csv` converts `.csv` files into arrays, JSON objects, or raw lines. It provides two main functions, `parseCsv` (for local files) and `parseText` (for raw strings), both sharing the same methods and features.
+
+##  Key Features
+- **Ultra-Lightweight:** Package size is less than 30 KB.
+- **Fast Mode:** Synchronous execution for maximum speed and zero overhead.
+- **Memory Efficient:** Streams large files using chunks and row offsets instead of loading the entire file into RAM.
+- **Robust Parsing:** Correct handling of complex line-breaks (`\r\n`, `\n`) and nested quotations.
+- **No Dependencies:** Zero external dependencies for maximum security and stability.
+- **Flexible Options:** Highly customizable (headers, quotes, delimiters, buffers).
+
+---
+
 
 Install:
 -------
@@ -58,38 +55,29 @@ parse = parseText(
 );
 
 
-```
-
-* If you want to get just the header :
-```js
-const result = parse.header(); 
-/*
-  ["Index","User Id","First Name","Last Name","Sex"]
-*/
-
 ```
 
 * If you want to get all rows :
 ```js
 const result = parse.get(); //Return all rows
 /*
-  {
-  time:'1 ms',
-  header:["Index","User Id","First Name","Last Name","Sex"],
-  rows:[
-    ["1","5f10e9D33fC5f2b","Sara","Mcguire","Female"],
-    ["2","751cD1cbF77e005","Alisha","Hebert","Male"],
-    ["3","DcEFDB2D2e62bF9","Gwendolyn","Sheppard","Male"],
-    ["4","C88661E02EEDA9e","Kristine","Mccann","Female"],
-    ["5","fafF1aBDebaB2a6","Bobby","Pittman","Female"],
-    ["6","BdDb6C8Af309202","Calvin","Ramsey","Female"],
-    ["7","FCdfFf08196f633","Collin","Allison","Male"],
-    ["8","356279dAa0F7CbD","Nicholas","Branch","Male"],
-    ["9","F563CcbFBfEcf5a","Emma","Robinson","Female"],
-    ["10","f2dceFc00F62542","Pedro","Cordova","Male"]
-    ],
-  row_count:10
-  }
+	{
+	time:1,
+	header:["Index","User Id","First Name","Last Name","Sex"],
+	rows:[
+		["1","5f10e9D33fC5f2b","Sara","Mcguire","Female"],
+		["2","751cD1cbF77e005","Alisha","Hebert","Male"],
+		["3","DcEFDB2D2e62bF9","Gwendolyn","Sheppard","Male"],
+		["4","C88661E02EEDA9e","Kristine","Mccann","Female"],
+		["5","fafF1aBDebaB2a6","Bobby","Pittman","Female"],
+		["6","BdDb6C8Af309202","Calvin","Ramsey","Female"],
+		["7","FCdfFf08196f633","Collin","Allison","Male"],
+		["8","356279dAa0F7CbD","Nicholas","Branch","Male"],
+		["9","F563CcbFBfEcf5a","Emma","Robinson","Female"],
+		["10","f2dceFc00F62542","Pedro","Cordova","Male"]
+		],
+	row_count:10
+	}
 */
 
 ```
@@ -105,9 +93,9 @@ result = parse.chunk(c)
 result = parse.chunk(2) //Return row 0 and 1 
 /*
 {
-  time: '0 ms',
-  header: [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
-  rows: [
+  "Time": 0,
+  "Header": [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
+  "Rows": [
     [ "1", "5f10e9D33fC5f2b", "Sara", "Mcguire", "Female" ],
     [ "2", "751cD1cbF77e005", "Alisha", "Hebert", "Male" ]
   ],
@@ -118,9 +106,9 @@ result = parse.chunk(2) //Return row 0 and 1
 result = parse.chunk(3) //Return row 2,3 and 4 (Get rows from last offset saved)
 /*
 {
-  time: '0 ms',
-  header: [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
-  rows: [
+  "Time": 0,
+  "Header": [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
+  "Rows": [
     [ "3", "DcEFDB2D2e62bF9", "Gwendolyn", "Sheppard", "Male" ],
     [ "4", "C88661E02EEDA9e", "Kristine", "Mccann", "Female" ],
     [ "5", "fafF1aBDebaB2a6", "Bobby", "Pittman", "Female" ]
@@ -132,9 +120,9 @@ result = parse.chunk(3) //Return row 2,3 and 4 (Get rows from last offset saved)
 result = parse.chunk(1) //Return row 5 (Get rows from last offset saved)
 /*
 {
-  time: '0 ms',
-  header: [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
-  rows: [
+  "Time": 0,
+  "Header": [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
+  "Rows": [
     [ "6", "BdDb6C8Af309202", "Calvin", "Ramsey", "Female" ]
   ],
   "row_count:": 1
@@ -159,9 +147,9 @@ result = parse.rowOffset(from,to)
 result = parse.rowOffset(6) //Returns all rows from the sixth row to the last row
 /*
 {
-  time: '0 ms',
-  header: [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
-  rows: [
+  "Time": 0,
+  "Header": [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
+  "Rows": [
     [ "7", "FCdfFf08196f633", "Collin", "Allison", "Male" ],
     [ "8", "356279dAa0F7CbD", "Nicholas", "Branch", "Male" ],
     [ "9", "F563CcbFBfEcf5a", "Emma", "Robinson", "Female" ],
@@ -174,9 +162,9 @@ result = parse.rowOffset(6) //Returns all rows from the sixth row to the last ro
 result = parse.rowOffset(5,8) //Returns all rows from 5th to 8th row
 /*
 {
-  time: '1 ms',
-  header: [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
-  rows: [
+  "Time": 1,
+  "Header": [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
+  "Rows": [
     [ "6", "BdDb6C8Af309202", "Calvin", "Ramsey", "Female" ],
     [ "7", "FCdfFf08196f633", "Collin", "Allison", "Male" ],
     [ "8", "356279dAa0F7CbD", "Nicholas", "Branch", "Male" ]
@@ -204,9 +192,9 @@ result = parse.setRowOffset(5)
 result = parse.chunk(1) // Get rows from last offset saved
 /*
 {
-  time: '0 ms',
-  header: [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
-  rows: [
+  "Time": 0,
+  "Header": [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
+  "Rows": [
     [ "6", "BdDb6C8Af309202", "Calvin", "Ramsey", "Female" ]
   ],
   "row_count:": 1
@@ -221,9 +209,9 @@ false
 result = parse.chunk(1) // Get rows from last offset saved
 /*
 {
-  time: '0 ms',
-  header: [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
-  rows: [
+  "Time": 0,
+  "Header": [ "Index", "User Id", "First Name", "Last Name", "Sex" ],
+  "Rows": [
     [ "7", "FCdfFf08196f633", "Collin", "Allison", "Male" ]
   ],
   "row_count:": 1
@@ -237,26 +225,24 @@ result = parse.chunk(1) // Get rows from last offset saved
 
 ```js
 {
-  'header': true,
-  'quote': false,
-  'linebreak': '\r\n',
-  'delimiter': ",",
-  'json': false,
+	'header': true,
+	'quote': false,
+	'linebreak': '\r\n',
+	'delimiter': ",",
   'bufferSize':1024*1024 
 }
-  // delimiter: (String: get rows containing columns, false: get lines without columns)
+	// delimiter: (String: get rows containing columns, false: get lines without columns)
   //bufferSize: It only works with a CSV file, which is the maximum number of characters that can be read at a time, the minimum value is 1024
 ```
 
 * If you want to use specific option :
 ```js
 var option = {
-  'header': false,    /* or true */
-  'quote': true,      /* or false */
-  'linebreak': '\n',  /* '\n' or '\r' or any other string  */
-  'delimiter': ","    /* ';' or any other string or false */
-  'json': false       /* or true */
-  'bufferSize':2000   /* It only works with a CSV file */
+	'header': false, 	/* or true */
+	'quote': true, 		/* or false */
+	'linebreak': '\n', 	/* '\n' or '\r' or any other string  */
+	'delimiter': ","	/* ';' or any other string or false */
+  'bufferSize':2000 /* It only works with a CSV file */
 }
 
 var parse;
@@ -271,13 +257,16 @@ parse = parseText(
 3,DcEFDB2D2e62bF9,Gwendolyn,Sheppard,Male`
 , option);
 
+option = {
+	'header': false,
+}
 
 result = parse.rowOffset(2)
 /*
 {
-  time: '0 ms',
-  header: false,
-  rows: [
+  "Time": 0,
+  "Header": false,
+  "Rows": [
     [ "2", "751cD1cbF77e005", "Alisha", "Hebert", "Male" ]
   ],
   "row_count:": 1
@@ -285,15 +274,15 @@ result = parse.rowOffset(2)
 */
 
 option = { 
-  'header': true,
-  'delimiter': false 
+	'header': true,
+	'delimiter': false 
 }
-  // delimiter: (String: get rows containing columns, false: get lines without columns)
+	// delimiter: (String: get rows containing columns, false: get lines without columns)
 /*
 {
-  time: '0 ms',
-  header: false,
-  rows: [
+  "Time": 0,
+  "Header": false,
+  "Rows": [
     [ "2,751cD1cbF77e005,Alisha,Hebert,Male" ] // No columns, just string (all line)
   ],
   "row_count:": 1
@@ -305,58 +294,14 @@ option = {
 * If you want to reset option after multiple uses of your code :
 ```js
 const option = {       // Just an exapmle
-  'header': false,
-  'quote': true,
-  'linebreak': '\n'
+	'header': false,
+	'quote': true,
+	'linebreak': '\n'
 }
 
 parse.resetOption(option); // All saved values are erased and the object is restared again
 
 
-```
-
-* If you want to rows as json array :
-```js
-// 'header' and 'json' must be true if you want to get rows as a json array
-const option = {       
-  'header': true, 
-  'json': true
-}
-
-
-const result = parse.chunk(3)
-/*
-{
-  time: '0 ms',
-  header: [ 'Index', 'User Id', 'First Name', 'Last Name', 'Sex' ],
-  rows: [
-    {
-      Index: '1',
-      'User Id': '5f10e9D33fC5f2b',
-      'First Name': 'Sara',
-      'Last Name': 'Mcguire',
-      Sex: 'Female'
-    },
-    {
-      Index: '2',
-      'User Id': '751cD1cbF77e005',
-      'First Name': 'Alisha',
-      'Last Name': 'Hebert',
-      Sex: 'Male'
-    },
-    {
-      Index: '3',
-      'User Id': 'DcEFDB2D2e62bF9',
-      'First Name': 'Gwendolyn',
-      'Last Name': 'Sheppard',
-      Sex: 'Male'
-    }
-  ],
-  row_count: 3
-}
-*/
-
-
 ```
 
 * If you want to get information of your object :
@@ -389,7 +334,7 @@ var result;
 result = parse.chunk(100000)
 /*
 {
-  time: '222 ms',
+  time: 222,
   header: false,
   rows: [
     [ '198801', '1', '103', '100', '000000190', '0', '35843', '34353' ],
@@ -419,7 +364,7 @@ result = parse.chunk(100000)
 result = parse.chunk(3) // Return row 100001,100002 and 100003 (Get rows from last offset saved)
 /*
 {
-  time: '1 ms',
+  time: 1,
   header: false,
   rows: [
     [ '198801', '1', '326', '500', '841330000', '90', '81', '246' ],
@@ -435,7 +380,7 @@ const to = from + 5;
 result = parse.rowOffset(from,to)
 /*
 {
-  time: '3743 ms',
+  time: 3743,
   header: false,
   rows: [
     [
@@ -458,7 +403,7 @@ const to = from + 4;
 result = parse.rowOffset(from,to)
 /*
 {
-  time: '44126 ms',
+  time: 44126,
   header: false,
   rows: [
     [ '201412', '1', '125', '400', '283525000', '0', '160000', '6492' ],
@@ -473,7 +418,7 @@ result = parse.rowOffset(from,to)
 result = parse.chunk(3) // Get rows from last offset saved ( row to,to+1 and to+2 )
 /*
 {
-  time: '29 ms',
+  time: 29,
   header: false,
   rows: [
     [ '201412', '1', '125', '400', '400932000', '0', '18', '526' ],
@@ -500,13 +445,6 @@ result = parse.getInfo() // Get all the information
 */
 ```
 
-## Request Features or Report Bugs
-
-Feature requests and bug reports are very welcome: https://github.com/housseynCheriet/select-csv/issues
-
-A couple of requests from me when you raise an issue on GitHub.
+## 📄 License
 
-* **Requesting a feature:** Please try to provide the context of why you want the feature. Such as,
-  in what situation the feature could help you and how, or how the lack of the feature is causing an inconvenience to you.
-  I can't start thinking of introducing it until I understand how it helps you 🙂
-* **Reporting a bug:** If you could provide a runnable code snippet that reproduces the bug, it would be very helpful!
+MIT License

package/package.json

@@ -1,34 +1,37 @@
-{
-  "name": "select-csv",
-  "version": "1.1.20",
-  "description": "Fastest, simplest and most powerful package of all existing libraries in npmjs. It converts .csv files into an array and even into lines. It contains two important functions parseCsv that handles a csv file, you only need a link to the file. And parseText deals with text, and they both have the same roles and and methods",
-  "keywords": [
-    "csv",
-    "parser",
-    "parse",
-    "parsing",
-    "delimited",
-    "text",
-    "data",
-    "comma",
-    "tab",
-    "pipe",
-    "file",
-    "filereader",
-    "stream",
-    "chunk",
-    "line"
-  ],
-  "author": {
-    "name": "Housseyn Cheriet",
-    "url": "https://github.com/housseynCheriet"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/housseynCheriet/select-csv"
-  },
-  "license": "CC-BY-ND",
-  "main": "selectcsv.js",
-  "scripts": {}
-  
-}
+{
+  "name": "select-csv",
+  "version": "1.1.22",
+  "description": "A high-performance, memory-efficient CSV parser for Node.js. Supports streaming large files via chunks and row offsets with zero dependencies.",
+  "keywords": [
+    "csv",
+    "parser",
+    "parse",
+    "parsing",
+    "delimited",
+    "text",
+    "data",
+    "comma",
+    "tab",
+    "pipe",
+    "file",
+    "filereader",
+    "stream",
+    "chunk",
+    "line",
+    "fast-csv",
+    "large-file"
+  ],
+  "author": {
+    "name": "Housseyn Cheriet",
+    "url": "https://github.com/housseynCheriet"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/housseynCheriet/select-csv"
+  },
+  "license": "MIT",
+  "main": "selectcsv.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}