From: Ardis Lu <ardisglu@gmail.com>
Date: Thu, 9 Jan 2025 07:27:33 +0000 (-0800)
Subject: Accept PathLike input for createCSVWritableStream
X-Git-Tag: v0.1.0~135
X-Git-Url: https://git.ardis.lu/?a=commitdiff_plain;h=750003440b6a05a930eeb9bce7b758846b6fcf13;p=csvio

Accept PathLike input for createCSVWritableStream

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

diff --git a/src/core.js b/src/core.js
index 1fad6a2..48f327f 100644
--- a/src/core.js
+++ b/src/core.js
@@ -168,12 +168,21 @@ export function createCSVTransformStream(fn, options = {}) {
  * A simple wrapper around Node.js's [`fs.writeFile`](https://nodejs.org/api/fs.html#fspromiseswritefilefile-data-options) to write
  * streamed data to a file. If the input data is JSON, the data is converted to a string representing a RFC 4180 CSV record. If the
  * data is not JSON (e.g., if it is already converted to a CSV string), the data is written to the CSV file directly.
- * @param {string} path A `string` representing a path to a local CSV file destination. If the file already exists, its **data
- * will be overwritten**.
+ * @param {PathLike} path A `string`, `Buffer`, or `URL` representing a path to a local CSV file destination. If the file already
+ * exists, its **data will be overwritten**.
  * @returns {WritableStream} A `WritableStream` to write data to a file on disk.
  */
 export function createCSVWritableStream(path) {
-  const fullPath = normalize(path);
+  let fullPath;
+  if (typeof path === 'string') {
+    fullPath = normalize(path);
+  }
+  else if (ArrayBuffer.isView(path) || path instanceof ArrayBuffer) {
+    fullPath = normalize(new TextDecoder().decode(path));
+  }
+  else { // Assuming URL
+    fullPath = normalize(path.pathname.substring(1));
+  }
   const dir = dirname(fullPath);
   let handle;