Refactor CSVNormalizer.fixExcelDate suite to vectors

Refactor CSVNormalizer.fixExcelBigInt suite to vectors

Refactor CSVNormalizer.fixExcelNumber suite to vectors

Run formatter

Refactor expandScientificNotation suite to vectors

Use CRLF line endings

Refactor toCamelCase suite to vectors

Add note about maxConcurrent for transformation function

Simplify with early returns

Rename to csvio

Use "concurrent" instead of "parallel" to avoid confusion with threads

Add maxConcurrent option

Tweak wording

Expose fix functions as static methods of CSVNormalizer

These functions may be useful to create custom normalizers.

Add JSDoc type to output rows

Refactor createCSVDenormalizationStream to CSVDenormalizer

Refactor createCSVNormalizationStream to CSVNormalizer

Make transform and flush private methods

Should've been private from the start to match pre-refactor.

Move arrayToCSVString to be a static method of CSVWriter

This function is useful as part of the external API to make it easier to generate raw outputs for low-level transformations.

Refactor createCSVWritableStream to CSVWriter

Refactor createCSVReadableStream to CSVReader

Populate JSDoc descriptions for TransformationFunction

Refactor createCSVTransformStream to CSVTransformer

Using classes is more aligned with existing stream APIs such as TextEncoder and CompressionStream.

Add maxBatchSize option

Although this functionality could be implemented by end-users by returning null in the transformation function until a batch is accumulated, baking it into the transform stream simplifies this common use case.

Split out TransformationInput and TransformationOutput types

Split out TransformationFunction callback function signature

Add onError callback option

Align example to match others

Simplify and add test cases for parsePathLike

fileURLToPath already throws on unsupported URLs, no need to re-throw.

Break out parsePathLike utility function

Make file URL parser more robust

Tweak wording

Use PascalCase for type names

Allow transformation function to return multiple rows

Add table of contents

Delete redundant tests

Use examples.test.js for end-to-end tests instead

Add test suite to test all examples

Explicitly await for stream close

Otherwise, a race condition occurs when running these examples in test cases

Use paths relative to JS file location, not execution location

Allows the example files to be run from any directory, not just /examples

Accept PathLike input for createCSVWritableStream

To be consistent with createCSVReadableStream and also allow paths relative to JS file (vs. execution directory only).

Add example for returning null in transformation

Allow transformation function to consume input row without output

Specify "transformation function" instead of "logic function" to be clear

Push one empty row if CSV is blank

Added a negative test to catch this edge case because it was not caught with the positive test case.

Avoid flushing to disk

Performance cost is too great (for a 100k row/100MB CSV, increases write time from 6s to 60s) for benefit (memory usage, partial recoverability if interrupted). Need to use a more intelligent approach than flushing on every row.

Format to prevent horizontal scroll

Add tests for rawOutput

Refactor to delete redundant code

Initial commit