web-csv-toolbox 0.0.0-next-20240609055757 → 0.0.0-next-20240609164654

package/dist/es/parseStringToArraySyncWASM.js

@@ -1,14 +1,21 @@
 import { parseStringToArraySync } from './_virtual/_web-csv-toolbox-wasm.js';
+import { assertCommonOptions } from './assertCommonOptions.js';
+import { InvalidOptionError } from './common/errors.js';
 import { DOUBLE_QUOTE, COMMA } from './constants.js';
 
 function parseStringToArraySyncWASM(csv, options = {}) {
   const { delimiter = COMMA, quotation = DOUBLE_QUOTE } = options;
   if (typeof delimiter !== "string" || delimiter.length !== 1) {
-    throw new Error("Invalid delimiter, must be a single character on WASM.");
+    throw new InvalidOptionError(
+      "Invalid delimiter, must be a single character on WASM."
+    );
   }
   if (quotation !== DOUBLE_QUOTE) {
-    throw new Error("Invalid quotation, must be double quote on WASM.");
+    throw new InvalidOptionError(
+      "Invalid quotation, must be double quote on WASM."
+    );
   }
+  assertCommonOptions({ delimiter, quotation });
   const demiliterCode = delimiter.charCodeAt(0);
   return JSON.parse(parseStringToArraySync(csv, demiliterCode));
 }

package/dist/es/parseStringToArraySyncWASM.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringToArraySyncWASM.js","sources":["../../src/parseStringToArraySyncWASM.ts"],"sourcesContent":["import { parseStringToArraySync } from \"web-csv-toolbox-wasm\";\nimport type { CSVRecord, CommonOptions } from \"./common/types.ts\";\nimport { COMMA, DOUBLE_QUOTE } from \"./constants.ts\";\nimport type { loadWASM } from \"./loadWASM.ts\";\n\n/**\n * Parse CSV string to record of arrays.\n *\n * @param csv CSV string\n * @param options Parse options\n * @returns Record of arrays\n *\n * @remarks\n * This function uses WebAssembly to parse CSV string.\n * Before calling this function, you must call {@link loadWASM} function.\n *\n * This function only supports UTF-8 string.\n * If you pass a string that is not UTF-8, like UTF-16, it throws an error.\n * This function only supports double quote as quotation.\n * So, `options.quotation` must be `\"` (double quote). Otherwise, it throws an error.\n *\n * And this function only supports single character as delimiter.\n * So, `options.delimiter` must be a single character. Otherwise, it throws an error.\n *\n * @example\n *\n * ```ts\n * import { loadWASM, parseStringWASM } from \"web-csv-toolbox\";\n *\n * await loadWASM();\n *\n * const csv = \"a,b,c\\n1,2,3\";\n *\n * const result = parseStringToArraySyncWASM(csv);\n * console.log(result);\n * // Prints:\n * // [{ a: \"1\", b: \"2\", c: \"3\" }]\n * ```\n * @beta\n */\nexport function parseStringToArraySyncWASM<Header extends readonly string[]>(\n  csv: string,\n  options: CommonOptions = {},\n): CSVRecord<Header>[] {\n  const { delimiter = COMMA, quotation = DOUBLE_QUOTE } = options;\n  if (typeof delimiter !== \"string\" || delimiter.length !== 1) {\n    throw new Error(\"Invalid delimiter, must be a single character on WASM.\");\n  }\n  if (quotation !== DOUBLE_QUOTE) {\n    throw new Error(\"Invalid quotation, must be double quote on WASM.\");\n  }\n  const demiliterCode = delimiter.charCodeAt(0);\n  return JSON.parse(parseStringToArraySync(csv, demiliterCode));\n}\n"],"names":[],"mappings":";;;AAwCO,SAAS,0BACd,CAAA,GAAA,EACA,OAAyB,GAAA,EACJ,EAAA;AACrB,EAAA,MAAM,EAAE,SAAA,GAAY,KAAO,EAAA,SAAA,GAAY,cAAiB,GAAA,OAAA,CAAA;AACxD,EAAA,IAAI,OAAO,SAAA,KAAc,QAAY,IAAA,SAAA,CAAU,WAAW,CAAG,EAAA;AAC3D,IAAM,MAAA,IAAI,MAAM,wDAAwD,CAAA,CAAA;AAAA,GAC1E;AACA,EAAA,IAAI,cAAc,YAAc,EAAA;AAC9B,IAAM,MAAA,IAAI,MAAM,kDAAkD,CAAA,CAAA;AAAA,GACpE;AACA,EAAM,MAAA,aAAA,GAAgB,SAAU,CAAA,UAAA,CAAW,CAAC,CAAA,CAAA;AAC5C,EAAA,OAAO,IAAK,CAAA,KAAA,CAAM,sBAAuB,CAAA,GAAA,EAAK,aAAa,CAAC,CAAA,CAAA;AAC9D;;;;"}
+{"version":3,"file":"parseStringToArraySyncWASM.js","sources":["../../src/parseStringToArraySyncWASM.ts"],"sourcesContent":["import { parseStringToArraySync } from \"web-csv-toolbox-wasm\";\nimport { assertCommonOptions } from \"./assertCommonOptions.ts\";\nimport { InvalidOptionError } from \"./common/errors.ts\";\nimport type { CSVRecord, CommonOptions } from \"./common/types.ts\";\nimport { COMMA, DOUBLE_QUOTE } from \"./constants.ts\";\nimport type { loadWASM } from \"./loadWASM.ts\";\n\n/**\n * Parse CSV string to record of arrays.\n *\n * @param csv CSV string\n * @param options Parse options\n * @returns Record of arrays\n *\n * @remarks\n * This function uses WebAssembly to parse CSV string.\n * Before calling this function, you must call {@link loadWASM} function.\n *\n * This function only supports UTF-8 string.\n * If you pass a string that is not UTF-8, like UTF-16, it throws an error.\n * This function only supports double quote as quotation.\n * So, `options.quotation` must be `\"` (double quote). Otherwise, it throws an error.\n *\n * And this function only supports single character as delimiter.\n * So, `options.delimiter` must be a single character. Otherwise, it throws an error.\n *\n * @example\n *\n * ```ts\n * import { loadWASM, parseStringWASM } from \"web-csv-toolbox\";\n *\n * await loadWASM();\n *\n * const csv = \"a,b,c\\n1,2,3\";\n *\n * const result = parseStringToArraySyncWASM(csv);\n * console.log(result);\n * // Prints:\n * // [{ a: \"1\", b: \"2\", c: \"3\" }]\n * ```\n * @beta\n */\nexport function parseStringToArraySyncWASM<Header extends readonly string[]>(\n  csv: string,\n  options: CommonOptions = {},\n): CSVRecord<Header>[] {\n  const { delimiter = COMMA, quotation = DOUBLE_QUOTE } = options;\n  if (typeof delimiter !== \"string\" || delimiter.length !== 1) {\n    throw new InvalidOptionError(\n      \"Invalid delimiter, must be a single character on WASM.\",\n    );\n  }\n  if (quotation !== DOUBLE_QUOTE) {\n    throw new InvalidOptionError(\n      \"Invalid quotation, must be double quote on WASM.\",\n    );\n  }\n  assertCommonOptions({ delimiter, quotation });\n  const demiliterCode = delimiter.charCodeAt(0);\n  return JSON.parse(parseStringToArraySync(csv, demiliterCode));\n}\n"],"names":[],"mappings":";;;;;AA0CO,SAAS,0BACd,CAAA,GAAA,EACA,OAAyB,GAAA,EACJ,EAAA;AACrB,EAAA,MAAM,EAAE,SAAA,GAAY,KAAO,EAAA,SAAA,GAAY,cAAiB,GAAA,OAAA,CAAA;AACxD,EAAA,IAAI,OAAO,SAAA,KAAc,QAAY,IAAA,SAAA,CAAU,WAAW,CAAG,EAAA;AAC3D,IAAA,MAAM,IAAI,kBAAA;AAAA,MACR,wDAAA;AAAA,KACF,CAAA;AAAA,GACF;AACA,EAAA,IAAI,cAAc,YAAc,EAAA;AAC9B,IAAA,MAAM,IAAI,kBAAA;AAAA,MACR,kDAAA;AAAA,KACF,CAAA;AAAA,GACF;AACA,EAAoB,mBAAA,CAAA,EAAE,SAAW,EAAA,SAAA,EAAW,CAAA,CAAA;AAC5C,EAAM,MAAA,aAAA,GAAgB,SAAU,CAAA,UAAA,CAAW,CAAC,CAAA,CAAA;AAC5C,EAAA,OAAO,IAAK,CAAA,KAAA,CAAM,sBAAuB,CAAA,GAAA,EAAK,aAAa,CAAC,CAAA,CAAA;AAC9D;;;;"}

package/dist/es/parseStringToIterableIterator.js

@@ -1,11 +1,16 @@
 import { Lexer } from './Lexer.js';
 import { RecordAssembler } from './RecordAssembler.js';
+import { commonParseErrorHandling } from './commonParseErrorHandling.js';
 
 function parseStringToIterableIterator(csv, options) {
-  const lexer = new Lexer(options);
-  const assembler = new RecordAssembler(options);
-  const tokens = lexer.lex(csv);
-  return assembler.assemble(tokens);
+  try {
+    const lexer = new Lexer(options);
+    const assembler = new RecordAssembler(options);
+    const tokens = lexer.lex(csv);
+    return assembler.assemble(tokens);
+  } catch (error) {
+    commonParseErrorHandling(error);
+  }
 }
 
 export { parseStringToIterableIterator };

package/dist/es/parseStringToIterableIterator.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringToIterableIterator.js","sources":["../../src/parseStringToIterableIterator.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\n\nexport function parseStringToIterableIterator<\n  Header extends ReadonlyArray<string>,\n>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): IterableIterator<CSVRecord<Header>> {\n  const lexer = new Lexer(options);\n  const assembler = new RecordAssembler(options);\n  const tokens = lexer.lex(csv);\n  return assembler.assemble(tokens);\n}\n"],"names":[],"mappings":";;;AAIgB,SAAA,6BAAA,CAGd,KACA,OACqC,EAAA;AACrC,EAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,EAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,EAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,EAAO,OAAA,SAAA,CAAU,SAAS,MAAM,CAAA,CAAA;AAClC;;;;"}
+{"version":3,"file":"parseStringToIterableIterator.js","sources":["../../src/parseStringToIterableIterator.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\n\nexport function parseStringToIterableIterator<\n  Header extends ReadonlyArray<string>,\n>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): IterableIterator<CSVRecord<Header>> {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    const tokens = lexer.lex(csv);\n    return assembler.assemble(tokens);\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AAKgB,SAAA,6BAAA,CAGd,KACA,OACqC,EAAA;AACrC,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,IAAO,OAAA,SAAA,CAAU,SAAS,MAAM,CAAA,CAAA;AAAA,WACzB,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}

package/dist/es/parseStringToStream.js

@@ -1,18 +1,23 @@
 import { Lexer } from './Lexer.js';
 import { RecordAssembler } from './RecordAssembler.js';
+import { commonParseErrorHandling } from './commonParseErrorHandling.js';
 
 function parseStringToStream(csv, options) {
-  const lexer = new Lexer(options);
-  const assembler = new RecordAssembler(options);
-  return new ReadableStream({
-    start(controller) {
-      const tokens = lexer.lex(csv);
-      for (const record of assembler.assemble(tokens)) {
-        controller.enqueue(record);
+  try {
+    const lexer = new Lexer(options);
+    const assembler = new RecordAssembler(options);
+    return new ReadableStream({
+      start(controller) {
+        const tokens = lexer.lex(csv);
+        for (const record of assembler.assemble(tokens)) {
+          controller.enqueue(record);
+        }
+        controller.close();
       }
-      controller.close();
-    }
-  });
+    });
+  } catch (error) {
+    commonParseErrorHandling(error);
+  }
 }
 
 export { parseStringToStream };

package/dist/es/parseStringToStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringToStream.js","sources":["../../src/parseStringToStream.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\n\nexport function parseStringToStream<Header extends ReadonlyArray<string>>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>> {\n  const lexer = new Lexer(options);\n  const assembler = new RecordAssembler(options);\n  return new ReadableStream({\n    start(controller) {\n      const tokens = lexer.lex(csv);\n      for (const record of assembler.assemble(tokens)) {\n        controller.enqueue(record);\n      }\n      controller.close();\n    },\n  });\n}\n"],"names":[],"mappings":";;;AAIgB,SAAA,mBAAA,CACd,KACA,OACmC,EAAA;AACnC,EAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,EAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,EAAA,OAAO,IAAI,cAAe,CAAA;AAAA,IACxB,MAAM,UAAY,EAAA;AAChB,MAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,MAAA,KAAA,MAAW,MAAU,IAAA,SAAA,CAAU,QAAS,CAAA,MAAM,CAAG,EAAA;AAC/C,QAAA,UAAA,CAAW,QAAQ,MAAM,CAAA,CAAA;AAAA,OAC3B;AACA,MAAA,UAAA,CAAW,KAAM,EAAA,CAAA;AAAA,KACnB;AAAA,GACD,CAAA,CAAA;AACH;;;;"}
+{"version":3,"file":"parseStringToStream.js","sources":["../../src/parseStringToStream.ts"],"sourcesContent":["import { Lexer } from \"./Lexer.ts\";\nimport { RecordAssembler } from \"./RecordAssembler.ts\";\nimport type { CSVRecord, ParseOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\n\nexport function parseStringToStream<Header extends ReadonlyArray<string>>(\n  csv: string,\n  options?: ParseOptions<Header>,\n): ReadableStream<CSVRecord<Header>> {\n  try {\n    const lexer = new Lexer(options);\n    const assembler = new RecordAssembler(options);\n    return new ReadableStream({\n      start(controller) {\n        const tokens = lexer.lex(csv);\n        for (const record of assembler.assemble(tokens)) {\n          controller.enqueue(record);\n        }\n        controller.close();\n      },\n    });\n  } catch (error) {\n    commonParseErrorHandling(error);\n  }\n}\n"],"names":[],"mappings":";;;;AAKgB,SAAA,mBAAA,CACd,KACA,OACmC,EAAA;AACnC,EAAI,IAAA;AACF,IAAM,MAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,OAAO,CAAA,CAAA;AAC/B,IAAM,MAAA,SAAA,GAAY,IAAI,eAAA,CAAgB,OAAO,CAAA,CAAA;AAC7C,IAAA,OAAO,IAAI,cAAe,CAAA;AAAA,MACxB,MAAM,UAAY,EAAA;AAChB,QAAM,MAAA,MAAA,GAAS,KAAM,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AAC5B,QAAA,KAAA,MAAW,MAAU,IAAA,SAAA,CAAU,QAAS,CAAA,MAAM,CAAG,EAAA;AAC/C,UAAA,UAAA,CAAW,QAAQ,MAAM,CAAA,CAAA;AAAA,SAC3B;AACA,QAAA,UAAA,CAAW,KAAM,EAAA,CAAA;AAAA,OACnB;AAAA,KACD,CAAA,CAAA;AAAA,WACM,KAAO,EAAA;AACd,IAAA,wBAAA,CAAyB,KAAK,CAAA,CAAA;AAAA,GAChC;AACF;;;;"}

package/dist/es/utils/convertBinaryToString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertBinaryToString.js","sources":["../../../src/utils/convertBinaryToString.ts"],"sourcesContent":["import type { BinaryOptions } from \"../common/types.ts\";\n\n/**\n * Converts a binary string to a string.\n *\n * @param binary - The binary string to convert.\n * @param options - The options for parsing the binary string.\n * @returns The converted string.\n * @throws {RangeError} The given charset is not supported.\n * @throws {TypeError} The encoded data was not valid.\n */\nexport function convertBinaryToString(\n  binary: Uint8Array | ArrayBuffer,\n  options: BinaryOptions,\n): string {\n  return new TextDecoder(options?.charset, {\n    ignoreBOM: options?.ignoreBOM,\n    fatal: options?.fatal,\n  }).decode(binary instanceof ArrayBuffer ? new Uint8Array(binary) : binary);\n}\n"],"names":[],"mappings":"AAWgB,SAAA,qBAAA,CACd,QACA,OACQ,EAAA;AACR,EAAO,OAAA,IAAI,WAAY,CAAA,OAAA,EAAS,OAAS,EAAA;AAAA,IACvC,WAAW,OAAS,EAAA,SAAA;AAAA,IACpB,OAAO,OAAS,EAAA,KAAA;AAAA,GACjB,EAAE,MAAO,CAAA,MAAA,YAAkB,cAAc,IAAI,UAAA,CAAW,MAAM,CAAA,GAAI,MAAM,CAAA,CAAA;AAC3E;;;;"}

package/dist/es/utils/pipeline.js

@@ -9,7 +9,7 @@ function pipeline(stream, ...transformers) {
           write: (v) => controller.enqueue(v),
           close: () => controller.close()
         })
-      ))();
+      ).catch((error) => controller.error(error)))();
     }
   });
 }

package/dist/es/utils/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sources":["../../../src/utils/pipeline.ts"],"sourcesContent":["export function pipeline<I, T, O>(\n  stream: ReadableStream<I>,\n  transformer1: TransformStream<I, T>,\n  transformer2: TransformStream<T, O>,\n): ReadableStream<O>;\nexport function pipeline<I, T1, T2, O>(\n  stream: ReadableStream<I>,\n  transformer1: TransformStream<I, T1>,\n  transformer2: TransformStream<T1, T2>,\n  transformer3: TransformStream<T2, O>,\n): ReadableStream<O>;\nexport function pipeline<I, T1, T2, T3, O>(\n  stream: ReadableStream<I>,\n  transformer1: TransformStream<I, T1>,\n  transformer2: TransformStream<T1, T2>,\n  transformer3: TransformStream<T2, T3>,\n  transformer4: TransformStream<T3, O>,\n): ReadableStream<O>;\nexport function pipeline<I, O>(\n  stream: ReadableStream<I>,\n  ...transformers: TransformStream[]\n): ReadableStream<O> {\n  return new ReadableStream({\n    start: (controller) => {\n      (() =>\n        transformers\n          .reduce<ReadableStream>(\n            (stream, transformer) => stream.pipeThrough(transformer),\n            stream,\n          )\n          .pipeTo(\n            new WritableStream({\n              write: (v) => controller.enqueue(v),\n              close: () => controller.close(),\n            }),\n          ))();\n    },\n  });\n}\n"],"names":["stream"],"mappings":"AAkBgB,SAAA,QAAA,CACd,WACG,YACgB,EAAA;AACnB,EAAA,OAAO,IAAI,cAAe,CAAA;AAAA,IACxB,KAAA,EAAO,CAAC,UAAe,KAAA;AACrB,MAAA,CAAC,MACC,YACG,CAAA,MAAA;AAAA,QACC,CAACA,OAAAA,EAAQ,WAAgBA,KAAAA,OAAAA,CAAO,YAAY,WAAW,CAAA;AAAA,QACvD,MAAA;AAAA,OAED,CAAA,MAAA;AAAA,QACC,IAAI,cAAe,CAAA;AAAA,UACjB,KAAO,EAAA,CAAC,CAAM,KAAA,UAAA,CAAW,QAAQ,CAAC,CAAA;AAAA,UAClC,KAAA,EAAO,MAAM,UAAA,CAAW,KAAM,EAAA;AAAA,SAC/B,CAAA;AAAA,OACA,GAAA,CAAA;AAAA,KACT;AAAA,GACD,CAAA,CAAA;AACH;;;;"}
+{"version":3,"file":"pipeline.js","sources":["../../../src/utils/pipeline.ts"],"sourcesContent":["export function pipeline<I, T, O>(\n  stream: ReadableStream<I>,\n  transformer1: TransformStream<I, T>,\n  transformer2: TransformStream<T, O>,\n): ReadableStream<O>;\nexport function pipeline<I, T1, T2, O>(\n  stream: ReadableStream<I>,\n  transformer1: TransformStream<I, T1>,\n  transformer2: TransformStream<T1, T2>,\n  transformer3: TransformStream<T2, O>,\n): ReadableStream<O>;\nexport function pipeline<I, T1, T2, T3, O>(\n  stream: ReadableStream<I>,\n  transformer1: TransformStream<I, T1>,\n  transformer2: TransformStream<T1, T2>,\n  transformer3: TransformStream<T2, T3>,\n  transformer4: TransformStream<T3, O>,\n): ReadableStream<O>;\nexport function pipeline<I, O>(\n  stream: ReadableStream<I>,\n  ...transformers: TransformStream[]\n): ReadableStream<O> {\n  return new ReadableStream({\n    start: (controller) => {\n      (() =>\n        transformers\n          .reduce<ReadableStream>(\n            (stream, transformer) => stream.pipeThrough(transformer),\n            stream,\n          )\n          .pipeTo(\n            new WritableStream({\n              write: (v) => controller.enqueue(v),\n              close: () => controller.close(),\n            }),\n          )\n          .catch((error) => controller.error(error)))();\n    },\n  });\n}\n"],"names":["stream"],"mappings":"AAkBgB,SAAA,QAAA,CACd,WACG,YACgB,EAAA;AACnB,EAAA,OAAO,IAAI,cAAe,CAAA;AAAA,IACxB,KAAA,EAAO,CAAC,UAAe,KAAA;AACrB,MAAA,CAAC,MACC,YACG,CAAA,MAAA;AAAA,QACC,CAACA,OAAAA,EAAQ,WAAgBA,KAAAA,OAAAA,CAAO,YAAY,WAAW,CAAA;AAAA,QACvD,MAAA;AAAA,OAED,CAAA,MAAA;AAAA,QACC,IAAI,cAAe,CAAA;AAAA,UACjB,KAAO,EAAA,CAAC,CAAM,KAAA,UAAA,CAAW,QAAQ,CAAC,CAAA;AAAA,UAClC,KAAA,EAAO,MAAM,UAAA,CAAW,KAAM,EAAA;AAAA,SAC/B,CAAA;AAAA,OACH,CACC,MAAM,CAAC,KAAA,KAAU,WAAW,KAAM,CAAA,KAAK,CAAC,CAAG,GAAA,CAAA;AAAA,KAClD;AAAA,GACD,CAAA,CAAA;AACH;;;;"}

package/dist/es/web-csv-toolbox.js

@@ -1,12 +1,12 @@
 export { Field, FieldDelimiter, RecordDelimiter } from './common/constants.js';
 export { LexerTransformer } from './LexerTransformer.js';
-export { RecordAssemblerTransformer } from './RecordAssemblerTransformer.js';
-export { parseString } from './parseString.js';
+export { loadWASM } from './loadWASM.js';
+export { parse } from './parse.js';
 export { parseBinary } from './parseBinary.js';
-export { parseUint8ArrayStream } from './parseUint8ArrayStream.js';
-export { parseStringStream } from './parseStringStream.js';
 export { parseResponse } from './parseResponse.js';
-export { parse } from './parse.js';
-export { loadWASM } from './loadWASM.js';
+export { parseString } from './parseString.js';
+export { parseStringStream } from './parseStringStream.js';
 export { parseStringToArraySyncWASM } from './parseStringToArraySyncWASM.js';
+export { parseUint8ArrayStream } from './parseUint8ArrayStream.js';
+export { RecordAssemblerTransformer } from './RecordAssemblerTransformer.js';
 //# sourceMappingURL=web-csv-toolbox.js.map

package/dist/types/LexerTransformer.d.ts

@@ -1,3 +1,4 @@
+import { Lexer } from "./Lexer.ts";
 import type { CommonOptions, Token } from "./common/types.ts";
 /**
  * A transform stream that converts a stream of tokens into a stream of rows.
@@ -19,16 +20,17 @@ import type { CommonOptions, Token } from "./common/types.ts";
  *       console.log(token);
  *     }
  *   }}));
- * // { type: Field, value: "name" }
- * // FieldDelimiter
- * // { type: Field, value: "age" }
- * // RecordDelimiter
- * // { type: Field, value: "Alice" }
- * // FieldDelimiter
+ * // { type: Field, value: "name", location: {...} }
+ * // { type: FieldDelimiter, value: ",", location: {...} }
+ * // { type: Field, value: "age", location: {...} }
+ * // { type: RecordDelimiter, value: "\r\n", location: {...} }
+ * // { type: Field, value: "Alice", location: {...} }
+ * // { type: FieldDelimiter, value: ",", location: {...} }
  * // { type: Field, value: "20" }
- * // RecordDelimiter
+ * // { type: RecordDelimiter, value: "\r\n", location: {...} }
  * ```
  */
 export declare class LexerTransformer extends TransformStream<string, Token[]> {
+    readonly lexer: Lexer;
     constructor(options?: CommonOptions);
 }

package/dist/types/LexerTransformer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/RecordAssemblerTransformer.d.ts

@@ -1,3 +1,4 @@
+import { RecordAssembler } from "./RecordAssembler.ts";
 import type { CSVRecord, RecordAssemblerOptions, Token } from "./common/types.ts";
 /**
  * A transform stream that converts a stream of tokens into a stream of rows.
@@ -43,5 +44,6 @@ import type { CSVRecord, RecordAssemblerOptions, Token } from "./common/types.ts
  * ```
  */
 export declare class RecordAssemblerTransformer<Header extends ReadonlyArray<string>> extends TransformStream<Token[], CSVRecord<Header>> {
+    readonly assembler: RecordAssembler<Header>;
     constructor(options?: RecordAssemblerOptions<Header>);
 }

package/dist/types/assertCommonOptions.d.ts

@@ -15,6 +15,7 @@ import type { CommonOptions } from "./common/types.ts";
  * ```
  *
  * @param options - The options object to be validated.
- * @throws {Error} If any required property is missing or if the delimiter is the same as the quotation.
+ * @throws {InvalidOptionError} If any required property is missing or if the delimiter is the same as the quotation.
+ * @throws {TypeError} If any required property is not a string.
  */
 export declare function assertCommonOptions(options: Required<CommonOptions>): asserts options is Required<CommonOptions>;

package/dist/types/common/errors.d.ts

@@ -0,0 +1,26 @@
+import type { Position } from "./types.js";
+/**
+ * Error class for invalid option errors.
+ */
+export declare class InvalidOptionError extends Error {
+    constructor(message?: string, options?: ErrorOptions);
+}
+/**
+ * Options for creating a parse error.
+ */
+export interface ParseErrorOptions extends ErrorOptions {
+    /**
+     * The position where the error occurred.
+     */
+    position?: Position;
+}
+/**
+ * Error class for parse errors.
+ */
+export declare class ParseError extends Error {
+    /**
+     * The position where the error occurred.
+     */
+    position?: Position;
+    constructor(message?: string, options?: ParseErrorOptions);
+}

package/dist/types/commonParseErrorHandling.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Common error handling for parsing CSV data.
+ *
+ * @param error - The error to handle.
+ * @throws {ParseError} When an error occurs while parsing the CSV data.
+ * @throws {InvalidOptionError} When an invalid option is provided.
+ */
+export declare function commonParseErrorHandling(error: unknown): never;

package/dist/types/getOptionsFromResponse.d.ts

@@ -1,2 +1,10 @@
 import type { ParseBinaryOptions } from "./common/types.ts";
+/**
+ * Extracts the options from the response object.
+ *
+ * @param response - The response object from which to extract the options.
+ * @param options - The options to merge with the extracted options.
+ * @returns The options extracted from the response.
+ * @throws {RangeError} - The content type is not supported.
+ */
 export declare function getOptionsFromResponse<Header extends ReadonlyArray<string>>(response: Response, options?: ParseBinaryOptions<Header>): ParseBinaryOptions<Header>;

package/dist/types/parseBinaryToArraySync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/parseBinaryToIterableIterator.d.ts

@@ -1,2 +1,10 @@
 import type { CSVRecord, ParseBinaryOptions } from "./common/types.ts";
+/**
+ * Parses the given binary data into an iterable iterator of CSV records.
+ *
+ * @param binary - The binary data to parse.
+ * @param options - The parse options.
+ * @returns An iterable iterator of CSV records.
+ * @throws {ParseError} When an error occurs while parsing the CSV data.
+ */
 export declare function parseBinaryToIterableIterator<Header extends ReadonlyArray<string>>(binary: Uint8Array | ArrayBuffer, options?: ParseBinaryOptions<Header>): IterableIterator<CSVRecord<Header>>;

package/dist/types/utils/convertBinaryToString.d.ts

@@ -0,0 +1,11 @@
+import type { BinaryOptions } from "../common/types.ts";
+/**
+ * Converts a binary string to a string.
+ *
+ * @param binary - The binary string to convert.
+ * @param options - The options for parsing the binary string.
+ * @returns The converted string.
+ * @throws {RangeError} The given charset is not supported.
+ * @throws {TypeError} The encoded data was not valid.
+ */
+export declare function convertBinaryToString(binary: Uint8Array | ArrayBuffer, options: BinaryOptions): string;

package/dist/types/web-csv-toolbox.d.ts

@@ -1,12 +1,12 @@
 export * from "./common/constants.ts";
 export * from "./common/types.ts";
 export * from "./LexerTransformer.ts";
-export * from "./RecordAssemblerTransformer.ts";
-export * from "./parseString.ts";
+export * from "./loadWASM.ts";
+export * from "./parse.ts";
 export * from "./parseBinary.ts";
-export * from "./parseUint8ArrayStream.ts";
-export * from "./parseStringStream.ts";
 export * from "./parseResponse.ts";
-export * from "./parse.ts";
-export * from "./loadWASM.ts";
+export * from "./parseString.ts";
+export * from "./parseStringStream.ts";
 export * from "./parseStringToArraySyncWASM.ts";
+export * from "./parseUint8ArrayStream.ts";
+export * from "./RecordAssemblerTransformer.ts";