Rename `options.value` to `options.placeholder`

Refactor extra arguments into options object

Rollback null-prototype to object prototype

Name collision is unlikely and enumeration may be useful. And it is easier for JSDoc to parse normal object initialization than `Object.create`.

Pin Node.js version

Add tests for ErrorStrategies

Freeze ErrorStrategies and use null prototype

This configuration is the most restrictive and fit for its intended purpose as a namespace only.

Add initial error strategies

Add JSDoc for benchmark utils

Add links to input and output CSVs

Refactor to simplify functions

Use package name for imports

Make test input paths relative to the file instead of command

Before, `npm test` only worked in the root directory. Now it can run in any directory.

Unlink file on keyboard interrupt

Reorder test name for easier skimming

Add 50MB benchmarks

Use unique pseudorandom seed on each generation

Use consistent name length to make it easier to compare outputs

Replace passthrough options with typeCastOnly

To replicate old behavior (passthrough as string), simply use `type: "string"`.

Assert non-nullable type instead of using nullish coalesce

There will be undefined `decimal` only if the input to `formatToParts` does not contain a decimal. But there will always be a decimal because the input is hardcoded.

The TS language server is not yet intelligent enough to assert it is non-nullable from the hardcoded input, so we need to pass the type hint.

Using nullish coalesce results in an uncovered branch which is impossible to test, so it should be removed.

Add additional tests for uncovered branches

Delete unnecessary token

Originally intended to match the remaining characters of the rest of the test name, but this is not needed since we only need to match the "large:" prefix.

Assert example 1.6 logs to console

Add 1MB benchmark

Silence console functions on stdout and instead assert they occurred

This approach makes the test runner output cleaner, and also tests the console calls occurred as expected.

Explicitly close file handle

Dismisses "Closing a FileHandle object on garbage collection" warnings in tests.

Add cleanup on abort

`close()` is NOT called if CSVWriter errors, only `abort()`. So need to call `close()` within `abort()` to finish cleanup.

Simplify ReadableStream constructor

Fix temp files not being deleted

The test runner will run code inside a test suite block even if the tests inside are skipped, which means the temp file was created but the cleanup `after()` call is skipped. Putting the creation within `before()` makes the temp file creation skipped it the tests are skipped.

Update prefix to match new project name

Add test for saving progress on uncaught error

Delete leftover flag from debugging

Add initial benchmarks

Update example to demonstrate more transformations

Fix regex to match examples

This change allows for the file name convention "wip_ex1_1.js" for in-progress examples.

Add "Abort a transformation" example

Improve type documentation

Fix broken test

Was previously passing by coincidence. Added an additional check to compare the actual rows vs. status rows.

Add npm script for running test coverage report

Add initial large CSV tests

Add test for changing elapsed status

Add tests for writing raw CSV strings

Add test for raising non-error rejection

Add test for handleHeaders error handling

Note that rows includes the header row

Add an example of using CSVWriter status

Add public status property to CSVWriter for tracking progress

Use consistent casing for types

Lowercase for all primitive types except Object and Array, TitleCase for all other types.

Add example to combine retry and graceful failure strategies

Add header row deletion test

Clarify handleHeaders intended usage

Setting it to an Array<any> is preferred for simple scenarios.

Add example to demonstrate passing a function to handleHeaders

Allow Array<any> and TransformationFunction as inputs to handle headers

This change simplifies the common tasks of (1) renaming headers (just pass the new header array) and (2) appending headers (pass a one-line TransformationFunction). Setting the option to a boolean is the same behavior as includeHeaders.

Passthrough encoding option for CSVReader

Add missing semicolon

Prepare for npm publish

Renumber and categorize examples

Headers make the examples easier to skim. Using minor numberings is also useful to later add more examples without having to renumber existing groupings each time.

Add graceful failure example

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