web-csv-toolbox 0.3.2 → 0.4.0

package/README.md

@@ -242,6 +242,8 @@ providing an intuitive and straightforward experience for users.
 
 The `input` paramater can be a `string`, a [ReadableStream](https://developer.mozilla.org/docs/Web/API/ReadableStream)
 of `string`s or [Uint8Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array)s,
+or a [Uint8Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) object,
+or a [ArrayBuffer](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) object,
 or a [Response](https://developer.mozilla.org/docs/Web/API/Response) object.
 
 ### Middle-level APIs 🧱
@@ -249,16 +251,20 @@ or a [Response](https://developer.mozilla.org/docs/Web/API/Response) object.
 These APIs are optimized for **Enhanced Performance and Control**,
 catering to users who need more detailed and fine-tuned functionality.
 
-- **`function parseBinaryStream(stream[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseBinaryStream-1.html)
-  - Parses binary streams with precise control over data types.
+- **`function parseString(string[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseString-1.html)
+  - Efficient parsing of CSV strings.
+- **`function parseArrayBuffer(buffer[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseArrayBuffer-1.html)
+  - Parse CSV Binary of ArrayBuffer.
+- **`function parseUint8Array(buffer[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseUint8Array-1.html)
+  - Parse CSV Binary of Uint8Array.
 - **`function parseResponse(response[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseResponse-1.html)
   - Customized parsing directly from `Response` objects.
 - **`function parseStream(stream[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseStream-1.html)
   - Stream-based parsing for larger or continuous data.
-- **`function parseString(string[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseString-1.html)
-  - Efficient parsing of CSV strings.
 - **`function parseStringStream(stream[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseStringStream-1.html)
   - Combines string-based parsing with stream processing.
+- **`function parseUint8ArrayStream(stream[, options])`**: [📑](https://kamiazya.github.io/web-csv-toolbox/functions/parseUint8ArrayStream-1.html)
+  - Parses binary streams with precise control over data types.
 
 ### Low-level APIs ⚙️
 

package/lib/index.d.ts

@@ -170,6 +170,28 @@ type CSVRecord<Header extends ReadonlyArray<string>> = Record<
   Header[number],
   string
 >;
+/**
+ * CSV String.
+ *
+ * @category Types
+ */
+type CSVString = string | ReadableStream<string>;
+/**
+ * CSV Binary.
+ *
+ * @category Types
+ */
+type CSVBinary =
+  | ReadableStream<Uint8Array>
+  | Response
+  | ArrayBuffer
+  | Uint8Array;
+/**
+ * CSV.
+ *
+ * @category Types
+ */
+type CSV = CSVString | CSVBinary;
 
 /**
  * A transform stream that converts a stream of tokens into a stream of rows.
@@ -311,6 +333,58 @@ declare namespace parseString {
   ): Promise<CSVRecord<Header>[]>;
 }
 
+/**
+ * Parse a binary from an {@link !Uint8Array}.
+ *
+ * @category Middle-level API
+ *
+ * @param bytes CSV bytes to parse.
+ * @param options Parsing options
+ * @returns Async iterable iterator of records.
+ *
+ * @example Parsing CSV binary
+ *
+ * ```ts
+ * import { parseUint8Array } from 'web-csv-toolbox';
+ *
+ * const csv = Uint8Array.from([
+ *   // ...
+ * ]);
+ *
+ * for await (const record of parseUint8Array(csv)) {
+ *   console.log(record);
+ * }
+ * ```
+ */
+declare function parseUint8Array<Header extends ReadonlyArray<string>>(
+  bytes: Uint8Array,
+  options?: ParseBinaryOptions<Header>,
+): AsyncIterableIterator<CSVRecord<Header>>;
+declare namespace parseUint8Array {
+  /**
+   * Parse a binary from an {@link !Uint8Array} to an array of records.
+   *
+   * @param bytes CSV bytes to parse.
+   * @param options Parsing options
+   * @returns Array of records
+   *
+   * @example
+   * ```ts
+   * import { parseUint8Array } from 'web-csv-toolbox';
+   *
+   * const csv = Uint8Array.from([
+   *  // ...
+   * ]);
+   *
+   * const records = await parseUint8Array.toArray(csv);
+   * ```
+   */
+  function toArray<Header extends ReadonlyArray<string>>(
+    bytes: Uint8Array,
+    options?: ParseBinaryOptions<Header>,
+  ): Promise<CSVRecord<Header>[]>;
+}
+
 /**
  * Parse CSV to records.
  * This function is for parsing a binary stream.
@@ -319,15 +393,15 @@ declare namespace parseString {
  * @remarks
  * If you want to parse a string, use {@link parseStringStream}.
  * @param stream CSV string to parse
- * @param options Parsing options. See {@link ParseBinaryOptions}.
+ * @param options Parsing options.
  * @returns Async iterable iterator of records.
  *
- * If you want array of records, use {@link parseBinaryStream.toArray} function.
+ * If you want array of records, use {@link parseUint8ArrayStream.toArray} function.
  *
  * @example Parsing CSV binary
  *
  * ```ts
- * import { parseBinaryStream } from 'web-csv-toolbox';
+ * import { parseUint8ArrayStream } from 'web-csv-toolbox';
  *
  * const csv = Uint8Array.from([
  *  // ...
@@ -340,16 +414,16 @@ declare namespace parseString {
  *   },
  * });
  *
- * for await (const record of parseBinaryStream(csv)) {
- * console.log(record);
+ * for await (const record of parseUint8ArrayStream(csv)) {
+ *   console.log(record);
  * }
  * ```
  */
-declare function parseBinaryStream<Header extends ReadonlyArray<string>>(
+declare function parseUint8ArrayStream<Header extends ReadonlyArray<string>>(
   stream: ReadableStream<Uint8Array>,
   options?: ParseBinaryOptions<Header>,
 ): AsyncIterableIterator<CSVRecord<Header>>;
-declare namespace parseBinaryStream {
+declare namespace parseUint8ArrayStream {
   /**
    * Parse CSV binary to array of records,
    * ideal for smaller data sets.
@@ -358,7 +432,7 @@ declare namespace parseBinaryStream {
    *
    * @example Parsing CSV binary
    * ```ts
-   * import { parseBinaryStream } from 'web-csv-toolbox';
+   * import { parseUint8ArrayStream } from 'web-csv-toolbox';
    *
    * const csv = Uint8Array.from([
    *   // ...
@@ -371,7 +445,7 @@ declare namespace parseBinaryStream {
    *   },
    * });
    *
-   * const records = await parseBinaryStream.toArray(stream);
+   * const records = await parseUint8ArrayStream.toArray(stream);
    * console.log(records);
    * ```
    */
@@ -381,6 +455,66 @@ declare namespace parseBinaryStream {
   ): Promise<CSVRecord<Header>[]>;
 }
 
+/**
+ * Parse a binary from an {@link !ArrayBuffer}.
+ *
+ * @category Middle-level API
+
+ * @param buffer CSV ArrayBuffer to parse.
+ * @param options Parsing options
+ * @returns Async iterable iterator of records.
+ *
+ * @example Parsing CSV files from ArrayBuffers
+ *
+ * ```ts
+ * import { parseArrayBuffer } from 'web-csv-toolbox';
+ *
+ * const csv = `name,age
+ * Alice,42
+ * Bob,69`;
+ *
+ * const buffer = new TextEncoder().encode(csv).buffer;
+ *
+ * for await (const record of parseArrayBuffer(buffer)) {
+ *   console.log(record);
+ * }
+ * // Prints:
+ * // { name: 'Alice', age: '42' }
+ * // { name: 'Bob', age: '69' }
+ * ```
+ */
+declare function parseArrayBuffer<Header extends ReadonlyArray<string>>(
+  buffer: ArrayBuffer,
+  options?: ParseBinaryOptions<Header>,
+): AsyncIterableIterator<CSVRecord<Header>>;
+declare namespace parseArrayBuffer {
+  /**
+   * Parse a binary from an {@link !ArrayBuffer} to an array of records.
+   * @param buffer CSV ArrayBuffer to parse.
+   * @param options Parsing options
+   * @returns Array of records
+   * @example
+   * ```ts
+   * import { parseArrayBuffer } from 'web-csv-toolbox';
+   *
+   * const csv = `name,age
+   * Alice,42
+   * Bob,69`;
+   *
+   * const buffer = new TextEncoder().encode(csv).buffer;
+   *
+   * const records = await parseArrayBuffer.toArray(buffer);
+   * console.log(records);
+   * // Prints:
+   * // [ { name: 'Alice', age: '42' }, { name: 'Bob', age: '69' } ]
+   * ```
+   */
+  function toArray<Header extends ReadonlyArray<string>>(
+    buffer: ArrayBuffer,
+    options?: ParseBinaryOptions<Header>,
+  ): Promise<CSVRecord<Header>[]>;
+}
+
 /**
  * Parse CSV string stream to records.
  *
@@ -519,11 +653,11 @@ declare namespace parseResponse {
  * {@link !ReadableStream} of {@link !String} and {@link !Uint8Array} are supported.
  *
  * @remarks
- * {@link parseStringStream} and {@link parseBinaryStream} are used internally.
+ * {@link parseStringStream} and {@link parseUint8ArrayStream} are used internally.
  * If you known the type of the stream, it performs better to use them directly.
  *
  * If you want to parse a string, use {@link parseStringStream}.
- * If you want to parse a Uint8Array, use {@link parseBinaryStream}.
+ * If you want to parse a Uint8Array, use {@link parseUint8ArrayStream}.
  *
  * @category Middle-level API
  * @param csv CSV string to parse
@@ -610,17 +744,20 @@ declare namespace parseStream {
  * @category High-level API
  *
  * @remarks
- * {@link parseString}, {@link parseBinaryStream},
+ * {@link parseString}, {@link parseUint8ArrayStream},
+ * {@link parseArrayBuffer}, {@link parseUint8Array},
  * {@link parseStringStream} and {@link parseResponse} are used internally.
  *
  * If you known the type of the CSV, it performs better to use them directly.
  *
- * | If you want to parse a...           | Use...                    | Data are treated as... |
- * | ----------------------------------- | ------------------------- | ---------------------- |
- * | {@link !String}                     | {@link parseString}    | String                 |
- * | {@link !ReadableStream}<string>     | {@link parseStringStream} | String                 |
- * | {@link !ReadableStream}<Uint8Array> | {@link parseBinaryStream} | Binary                 |
- * | {@link !Response}                   | {@link parseResponse}     | Binary                 |
+ * | If you want to parse a...           | Use...                        | Data are treated as... |
+ * | ----------------------------------- | ----------------------------- | ---------------------- |
+ * | {@link !String}                     | {@link parseString}           | String                 |
+ * | {@link !ReadableStream}<string>     | {@link parseStringStream}     | String                 |
+ * | {@link !ReadableStream}<Uint8Array> | {@link parseUint8ArrayStream} | Binary                 |
+ * | {@link !Response}                   | {@link parseResponse}         | Binary                 |
+ * | {@link !ArrayBuffer}                | {@link parseArrayBuffer}      | Binary                 |
+ * | {@link !Uint8Array}                 | {@link parseUint8Array}       | Binary                 |
  *
  * @example Parsing CSV files from strings
  *
@@ -699,7 +836,7 @@ declare namespace parseStream {
  * ```
  */
 declare function parse<Header extends ReadonlyArray<string>>(
-  csv: string | ReadableStream<string>,
+  csv: CSVString,
   options?: ParseOptions<Header>,
 ): AsyncIterableIterator<CSVRecord<Header>>;
 /**
@@ -739,7 +876,7 @@ declare function parse<Header extends ReadonlyArray<string>>(
  * ```
  */
 declare function parse<Header extends ReadonlyArray<string>>(
-  csv: ReadableStream<Uint8Array> | Response,
+  csv: CSVBinary,
   options?: ParseBinaryOptions<Header>,
 ): AsyncIterableIterator<CSVRecord<Header>>;
 declare namespace parse {
@@ -763,7 +900,7 @@ declare namespace parse {
    * ```
    */
   function toArray<Header extends ReadonlyArray<string>>(
-    csv: string | ReadableStream<string>,
+    csv: CSVString,
     options?: ParseOptions<Header>,
   ): Promise<CSVRecord<Header>[]>;
   /**
@@ -782,14 +919,17 @@ declare namespace parse {
    * ```
    */
   function toArray<Header extends ReadonlyArray<string>>(
-    csv: ReadableStream<Uint8Array> | Response,
-    options?: ParseOptions<Header>,
+    csv: CSVBinary,
+    options?: ParseBinaryOptions<Header>,
   ): Promise<CSVRecord<Header>[]>;
 }
 
 export {
   type BinaryOptions,
+  type CSV,
+  type CSVBinary,
   type CSVRecord,
+  type CSVString,
   type CommonOptions,
   Field,
   FieldDelimiter,
@@ -802,9 +942,11 @@ export {
   type Token,
   type TokenType,
   parse,
-  parseBinaryStream,
+  parseArrayBuffer,
   parseResponse,
   parseStream,
   parseString,
   parseStringStream,
+  parseUint8Array,
+  parseUint8ArrayStream,
 };

package/lib/index.js

@@ -1,6 +1,6 @@
-const FieldDelimiter = Symbol.for("web-streams-csv.FieldDelimiter");
-const RecordDelimiter = Symbol.for("web-streams-csv.RecordDelimiter");
-const Field = Symbol.for("web-streams-csv.Field");
+const FieldDelimiter = Symbol.for("web-csv-toolbox.FieldDelimiter");
+const RecordDelimiter = Symbol.for("web-csv-toolbox.RecordDelimiter");
+const Field = Symbol.for("web-csv-toolbox.Field");
 const CR = "\r";
 const CRLF = "\r\n";
 const LF = "\n";
@@ -285,15 +285,23 @@ async function* parseStringStream(stream, options) {
   }
 }
 ((parseStringStream) => {
-  parseStringStream.toArray = toArray;
+  Object.defineProperty(parseStringStream, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
 })(parseStringStream || (parseStringStream = {}));
 async function* parseString(csv, options) {
   yield* parseStringStream(new SingleValueReadableStream(csv), options);
 }
 ((parseString) => {
-  parseString.toArray = toArray;
+  Object.defineProperty(parseString, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
 })(parseString || (parseString = {}));
-async function* parseBinaryStream(stream, options) {
+async function* parseUint8ArrayStream(stream, options) {
   const { charset, fatal, ignoreBOM, decomposition } = options ?? {};
   yield* parseStringStream(
     [
@@ -303,9 +311,33 @@ async function* parseBinaryStream(stream, options) {
     options,
   );
 }
-((parseBinaryStream) => {
-  parseBinaryStream.toArray = toArray;
-})(parseBinaryStream || (parseBinaryStream = {}));
+((parseUint8ArrayStream) => {
+  Object.defineProperty(parseUint8ArrayStream, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
+})(parseUint8ArrayStream || (parseUint8ArrayStream = {}));
+function parseUint8Array(bytes, options) {
+  return parseUint8ArrayStream(new SingleValueReadableStream(bytes), options);
+}
+((parseUint8Array) => {
+  Object.defineProperty(parseUint8Array, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
+})(parseUint8Array || (parseUint8Array = {}));
+function parseArrayBuffer(buffer, options) {
+  return parseUint8Array(new Uint8Array(buffer), options);
+}
+((parseArrayBuffer) => {
+  Object.defineProperty(parseArrayBuffer, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
+})(parseArrayBuffer || (parseArrayBuffer = {}));
 function parseMime(contentType) {
   const [type, ...parameters] = contentType.split(";");
   const result = {
@@ -330,14 +362,18 @@ function parseResponse(response, options) {
   if (response.body === null) {
     throw new Error("Response body is null");
   }
-  return parseBinaryStream(response.body, {
+  return parseUint8ArrayStream(response.body, {
     decomposition,
     charset,
     ...options,
   });
 }
 ((parseResponse) => {
-  parseResponse.toArray = toArray;
+  Object.defineProperty(parseResponse, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
 })(parseResponse || (parseResponse = {}));
 async function* parseStream(stream, options) {
   const [branch1, branch2] = stream.tee();
@@ -347,15 +383,23 @@ async function* parseStream(stream, options) {
   if (typeof firstChunk === "string") {
     yield* parseStringStream(branch2, options);
   } else if (firstChunk instanceof Uint8Array) {
-    yield* parseBinaryStream(branch2, options);
+    yield* parseUint8ArrayStream(branch2, options);
   }
 }
 ((parseStream) => {
-  parseStream.toArray = toArray;
+  Object.defineProperty(parseStream, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
 })(parseStream || (parseStream = {}));
 async function* parse(csv, options) {
   if (typeof csv === "string") {
     yield* parseString(csv, options);
+  } else if (csv instanceof Uint8Array) {
+    yield* parseUint8Array(csv, options);
+  } else if (csv instanceof ArrayBuffer) {
+    yield* parseArrayBuffer(csv, options);
   } else if (csv instanceof ReadableStream) {
     yield* parseStream(csv, options);
   } else if (csv instanceof Response) {
@@ -363,7 +407,11 @@ async function* parse(csv, options) {
   }
 }
 ((parse) => {
-  parse.toArray = toArray;
+  Object.defineProperty(parse, "toArray", {
+    enumerable: true,
+    writable: false,
+    value: toArray,
+  });
 })(parse || (parse = {}));
 export {
   Field,
@@ -372,9 +420,11 @@ export {
   RecordAssemblerTransformar,
   RecordDelimiter,
   parse,
-  parseBinaryStream,
+  parseArrayBuffer,
   parseResponse,
   parseStream,
   parseString,
   parseStringStream,
+  parseUint8Array,
+  parseUint8ArrayStream,
 };

package/lib/index.umd.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).CSV={})}(this,(function(e){"use strict";const t=Symbol.for("web-streams-csv.FieldDelimiter"),i=Symbol.for("web-streams-csv.RecordDelimiter"),r=Symbol.for("web-streams-csv.Field"),n="\r\n",s="\n";function o(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}class a extends TransformStream{#e;#t;#i;#r;#n;#s="";get demiliter(){return this.#e}get quotation(){return this.#i}constructor({demiliter:e=",",quotation:t='"'}={}){!function(e){if("string"==typeof e.quotation&&0===e.quotation.length)throw new Error("quotation must not be empty");if("string"==typeof e.demiliter&&0===e.demiliter.length)throw new Error("demiliter must not be empty");if(e.quotation.includes(s)||e.quotation.includes("\r"))throw new Error("quotation must not include CR or LF");if(e.demiliter.includes(s)||e.demiliter.includes("\r"))throw new Error("demiliter must not include CR or LF");if(e.demiliter.includes(e.quotation)||e.quotation.includes(e.demiliter))throw new Error("demiliter and quotation must not include each other as a substring")}({demiliter:e,quotation:t}),super({transform:(e,t)=>{if(0!==e.length){this.#s+=e;for(const e of this.#o({flush:!1}))t.enqueue(e)}},flush:e=>{for(const t of this.#o({flush:!0}))e.enqueue(t)}}),this.#e=e,this.#t=e.length,this.#i=t,this.#r=t.length;const i=o(e),r=o(t);this.#n=new RegExp(`^(?:(?!${r})(?!${i})(?![\\r\\n]))([\\S\\s\\uFEFF\\xA0]+?)(?=${r}|${i}|\\r|\\n|$)`)}*#o({flush:e}){let n=null;for(let s;s=this.#a({flush:e});)switch(s.type){case r:n?n.value+=s.value:n=s;break;case t:case i:n&&(yield n,n=null),yield s}n&&(yield n)}#a({flush:e=!1}={}){if(0===this.#s.length)return null;if(this.#s.startsWith(n))return this.#s=this.#s.slice(2),{type:i,value:n};if(this.#s.startsWith(s))return this.#s=this.#s.slice(1),{type:i,value:s};if(this.#s.startsWith(this.#e))return this.#s=this.#s.slice(this.#t),{type:t,value:this.#e};if(this.#s.startsWith(this.#i))return!1===e&&this.#s.endsWith(this.#i)?null:this.extractQuotedString(e);const o=this.#n.exec(this.#s);return o?!1===e&&o[0].length===this.#s.length?null:(this.#s=this.#s.slice(o[0].length),{type:r,value:o[0]}):null}extractQuotedString(e){let t=this.#r,i="";for(;t<this.#s.length;)if(this.#s.slice(t,t+this.#r)!==this.quotation||this.#s.slice(t+this.#r,t+2*this.#r)!==this.quotation){if(this.#s.slice(t,t+this.#r)===this.quotation)return!1===e&&t+this.#r<this.#s.length&&this.#s.slice(t+this.#r,this.#t)!==this.demiliter&&this.#s.slice(t+this.#r,t+this.#r+2)!==n&&this.#s.slice(t+this.#r,t+this.#r+1)!==s?null:(this.#s=this.#s.slice(t+this.#r),{type:r,value:i});i+=this.#s[t],t++}else i+=this.quotation,t+=2*this.#r;return null}}class h extends TransformStream{#h=0;#u=[];#l;#f=!1;constructor(e={}){super({transform:(e,n)=>{switch(e.type){case r:this.#f=!0,this.#u[this.#h]=e.value;break;case t:this.#h++;break;case i:if(void 0===this.#l)this.#c(this.#u);else if(this.#f){const e=Object.fromEntries(this.#l.filter((e=>e)).map(((e,t)=>[e,this.#u.at(t)])));n.enqueue(e)}this.#h=0,this.#u=new Array(this.#l?.length),this.#f=!1}},flush:e=>{if(0!==this.#h&&void 0!==this.#l&&this.#f){const t=Object.fromEntries(this.#l.filter((e=>e)).map(((e,t)=>[e,this.#u.at(t)])));e.enqueue(t)}}}),void 0!==e.header&&Array.isArray(e.header)&&this.#c(e.header)}#c(e){if(this.#l=e,0===this.#l.length)throw new Error("The header must not be empty.");if(new Set(this.#l).size!==this.#l.length)throw new Error("The header must not contain duplicate fields.")}}class u extends ReadableStream{constructor(e){super({start(t){t.enqueue(e),t.close()}})}}async function l(...e){const t=[];for await(const i of this(...e))t.push(i);return t}async function*f(e,t){let i;const r=new ReadableStream({start:e=>i=e});await e.pipeThrough(new a(t)).pipeThrough(new h(t)).pipeTo(new WritableStream({write:e=>i.enqueue(e),close:()=>i.close()}));const n=r.getReader();try{for(;;){const{value:e,done:t}=await n.read();if(t)break;yield e}}finally{n.releaseLock()}}async function*c(e,t){yield*f(new u(e),t)}async function*d(e,t){const{charset:i,fatal:r,ignoreBOM:n,decomposition:s}=t??{};yield*f([...s?[new DecompressionStream(s)]:[],new TextDecoderStream(i,{fatal:r,ignoreBOM:n})].reduce(((e,t)=>e.pipeThrough(t)),e),t)}function m(e,t){const{headers:i}=e,r=i.get("content-type")??"text/csv",n=function(e){const[t,...i]=e.split(";"),r={type:t.trim(),parameters:{}};for(const e of i){const[t,i]=e.split("=");r.parameters[t.trim()]=i.trim()}return r}(r);if("text/csv"!==n.type)throw new Error(`Invalid mime type: ${r}`);const s=i.get("content-encoding")??void 0,o=n.parameters.charset??"utf-8";if(null===e.body)throw new Error("Response body is null");return d(e.body,{decomposition:s,charset:o,...t})}async function*y(e,t){const[i,r]=e.tee(),n=i.getReader(),{value:s}=await n.read();n.releaseLock(),"string"==typeof s?yield*f(r,t):s instanceof Uint8Array&&(yield*d(r,t))}async function*p(e,t){"string"==typeof e?yield*c(e,t):e instanceof ReadableStream?yield*y(e,t):e instanceof Response&&(yield*m(e,t))}!function(e){e.toArray=l}(f||(f={})),function(e){e.toArray=l}(c||(c={})),function(e){e.toArray=l}(d||(d={})),function(e){e.toArray=l}(m||(m={})),function(e){e.toArray=l}(y||(y={})),function(e){e.toArray=l}(p||(p={})),e.Field=r,e.FieldDelimiter=t,e.LexerTransformer=a,e.RecordAssemblerTransformar=h,e.RecordDelimiter=i,e.parse=p,e.parseBinaryStream=d,e.parseResponse=m,e.parseStream=y,e.parseString=c,e.parseStringStream=f}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).CSV={})}(this,(function(e){"use strict";const t=Symbol.for("web-csv-toolbox.FieldDelimiter"),i=Symbol.for("web-csv-toolbox.RecordDelimiter"),r=Symbol.for("web-csv-toolbox.Field"),n="\r\n",o="\n";function s(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}class a extends TransformStream{#e;#t;#i;#r;#n;#o="";get demiliter(){return this.#e}get quotation(){return this.#i}constructor({demiliter:e=",",quotation:t='"'}={}){!function(e){if("string"==typeof e.quotation&&0===e.quotation.length)throw new Error("quotation must not be empty");if("string"==typeof e.demiliter&&0===e.demiliter.length)throw new Error("demiliter must not be empty");if(e.quotation.includes(o)||e.quotation.includes("\r"))throw new Error("quotation must not include CR or LF");if(e.demiliter.includes(o)||e.demiliter.includes("\r"))throw new Error("demiliter must not include CR or LF");if(e.demiliter.includes(e.quotation)||e.quotation.includes(e.demiliter))throw new Error("demiliter and quotation must not include each other as a substring")}({demiliter:e,quotation:t}),super({transform:(e,t)=>{if(0!==e.length){this.#o+=e;for(const e of this.#s({flush:!1}))t.enqueue(e)}},flush:e=>{for(const t of this.#s({flush:!0}))e.enqueue(t)}}),this.#e=e,this.#t=e.length,this.#i=t,this.#r=t.length;const i=s(e),r=s(t);this.#n=new RegExp(`^(?:(?!${r})(?!${i})(?![\\r\\n]))([\\S\\s\\uFEFF\\xA0]+?)(?=${r}|${i}|\\r|\\n|$)`)}*#s({flush:e}){let n=null;for(let o;o=this.#a({flush:e});)switch(o.type){case r:n?n.value+=o.value:n=o;break;case t:case i:n&&(yield n,n=null),yield o}n&&(yield n)}#a({flush:e=!1}={}){if(0===this.#o.length)return null;if(this.#o.startsWith(n))return this.#o=this.#o.slice(2),{type:i,value:n};if(this.#o.startsWith(o))return this.#o=this.#o.slice(1),{type:i,value:o};if(this.#o.startsWith(this.#e))return this.#o=this.#o.slice(this.#t),{type:t,value:this.#e};if(this.#o.startsWith(this.#i))return!1===e&&this.#o.endsWith(this.#i)?null:this.extractQuotedString(e);const s=this.#n.exec(this.#o);return s?!1===e&&s[0].length===this.#o.length?null:(this.#o=this.#o.slice(s[0].length),{type:r,value:s[0]}):null}extractQuotedString(e){let t=this.#r,i="";for(;t<this.#o.length;)if(this.#o.slice(t,t+this.#r)!==this.quotation||this.#o.slice(t+this.#r,t+2*this.#r)!==this.quotation){if(this.#o.slice(t,t+this.#r)===this.quotation)return!1===e&&t+this.#r<this.#o.length&&this.#o.slice(t+this.#r,this.#t)!==this.demiliter&&this.#o.slice(t+this.#r,t+this.#r+2)!==n&&this.#o.slice(t+this.#r,t+this.#r+1)!==o?null:(this.#o=this.#o.slice(t+this.#r),{type:r,value:i});i+=this.#o[t],t++}else i+=this.quotation,t+=2*this.#r;return null}}class u extends TransformStream{#u=0;#l=[];#h;#f=!1;constructor(e={}){super({transform:(e,n)=>{switch(e.type){case r:this.#f=!0,this.#l[this.#u]=e.value;break;case t:this.#u++;break;case i:if(void 0===this.#h)this.#c(this.#l);else if(this.#f){const e=Object.fromEntries(this.#h.filter((e=>e)).map(((e,t)=>[e,this.#l.at(t)])));n.enqueue(e)}this.#u=0,this.#l=new Array(this.#h?.length),this.#f=!1}},flush:e=>{if(0!==this.#u&&void 0!==this.#h&&this.#f){const t=Object.fromEntries(this.#h.filter((e=>e)).map(((e,t)=>[e,this.#l.at(t)])));e.enqueue(t)}}}),void 0!==e.header&&Array.isArray(e.header)&&this.#c(e.header)}#c(e){if(this.#h=e,0===this.#h.length)throw new Error("The header must not be empty.");if(new Set(this.#h).size!==this.#h.length)throw new Error("The header must not contain duplicate fields.")}}class l extends ReadableStream{constructor(e){super({start(t){t.enqueue(e),t.close()}})}}async function h(...e){const t=[];for await(const i of this(...e))t.push(i);return t}async function*f(e,t){let i;const r=new ReadableStream({start:e=>i=e});await e.pipeThrough(new a(t)).pipeThrough(new u(t)).pipeTo(new WritableStream({write:e=>i.enqueue(e),close:()=>i.close()}));const n=r.getReader();try{for(;;){const{value:e,done:t}=await n.read();if(t)break;yield e}}finally{n.releaseLock()}}async function*c(e,t){yield*f(new l(e),t)}async function*d(e,t){const{charset:i,fatal:r,ignoreBOM:n,decomposition:o}=t??{};yield*f([...o?[new DecompressionStream(o)]:[],new TextDecoderStream(i,{fatal:r,ignoreBOM:n})].reduce(((e,t)=>e.pipeThrough(t)),e),t)}function m(e,t){return d(new l(e),t)}function b(e,t){return m(new Uint8Array(e),t)}function y(e,t){const{headers:i}=e,r=i.get("content-type")??"text/csv",n=function(e){const[t,...i]=e.split(";"),r={type:t.trim(),parameters:{}};for(const e of i){const[t,i]=e.split("=");r.parameters[t.trim()]=i.trim()}return r}(r);if("text/csv"!==n.type)throw new Error(`Invalid mime type: ${r}`);const o=i.get("content-encoding")??void 0,s=n.parameters.charset??"utf-8";if(null===e.body)throw new Error("Response body is null");return d(e.body,{decomposition:o,charset:s,...t})}async function*p(e,t){const[i,r]=e.tee(),n=i.getReader(),{value:o}=await n.read();n.releaseLock(),"string"==typeof o?yield*f(r,t):o instanceof Uint8Array&&(yield*d(r,t))}async function*g(e,t){"string"==typeof e?yield*c(e,t):e instanceof Uint8Array?yield*m(e,t):e instanceof ArrayBuffer?yield*b(e,t):e instanceof ReadableStream?yield*p(e,t):e instanceof Response&&(yield*y(e,t))}!function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(f||(f={})),function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(c||(c={})),function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(d||(d={})),function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(m||(m={})),function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(b||(b={})),function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(y||(y={})),function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(p||(p={})),function(e){Object.defineProperty(e,"toArray",{enumerable:!0,writable:!1,value:h})}(g||(g={})),e.Field=r,e.FieldDelimiter=t,e.LexerTransformer=a,e.RecordAssemblerTransformar=u,e.RecordDelimiter=i,e.parse=g,e.parseArrayBuffer=b,e.parseResponse=y,e.parseStream=p,e.parseString=c,e.parseStringStream=f,e.parseUint8Array=m,e.parseUint8ArrayStream=d}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-csv-toolbox",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "A CSV Toolbox utilizing Web Standard APIs.",
   "type": "module",
   "main": "lib/index.js",