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