@cerios/csv-nested-json - npm Package Compare versions

Comparing version 1.2.0 to 1.2.1

dist/index.d.mts

@@ -231,2 +231,11 @@ import * as node_stream from 'node:stream';
     /**
+     * Preserve integer values outside JavaScript safe integer range as strings.
+     * Helps prevent precision loss when autoParseNumbers is enabled.
+     * @default false
+     *
+     * @remarks
+     * Only applies to whole numbers where `Math.abs(Number(value)) > Number.MAX_SAFE_INTEGER`.
+     */
+    preserveUnsafeIntegersAsString?: boolean;
+    /**
      * Automatically convert 'true'/'false' strings to booleans.
@@ -233,0 +242,0 @@ * Case-insensitive matching.

dist/index.d.ts

@@ -231,2 +231,11 @@ import * as node_stream from 'node:stream';
     /**
+     * Preserve integer values outside JavaScript safe integer range as strings.
+     * Helps prevent precision loss when autoParseNumbers is enabled.
+     * @default false
+     *
+     * @remarks
+     * Only applies to whole numbers where `Math.abs(Number(value)) > Number.MAX_SAFE_INTEGER`.
+     */
+    preserveUnsafeIntegersAsString?: boolean;
+    /**
      * Automatically convert 'true'/'false' strings to booleans.
@@ -233,0 +242,0 @@ * Case-insensitive matching.

package.json

 {
 	"name": "@cerios/csv-nested-json",
-	"version": "1.2.0",
+	"version": "1.2.1",
 	"author": "Ronald Veth - Cerios",
@@ -5,0 +5,0 @@ "description": "Parse CSV files into nested JSON objects with support for dot notation, arrays, and complex data structures",

README.md

@@ -906,2 +906,3 @@ # @cerios/csv-nested-json
   autoParseNumbers?: boolean;                     // Default: false
+  preserveUnsafeIntegersAsString?: boolean;       // Default: false
   autoParseBooleans?: boolean;                    // Default: false
@@ -982,2 +983,18 @@ autoParseDates?: boolean;                       // Default: false
 
+Note: JavaScript numbers lose integer precision above `Number.MAX_SAFE_INTEGER` (`9007199254740991`).
+If you want to prevent precision loss for large integers, enable `preserveUnsafeIntegersAsString`.
+
+#### `preserveUnsafeIntegersAsString`
+
+When used with `autoParseNumbers`, keeps integers outside JavaScript's safe integer range as strings.
+
+```typescript
+const result = CsvParser.parseString(csv, {
+  autoParseNumbers: true,
+  preserveUnsafeIntegersAsString: true
+});
+
+// "9007199254740993" stays a string to avoid precision loss
+```
+
 #### `autoParseBooleans`
@@ -984,0 +1001,0 @@

No alert changes

Improved metrics

Total package byte prevSize

583118

0.71%

Lines of code

5741

0.93%

Number of lines in readme file

1602

1.07%

No dependency changes