web-csv-toolbox 0.14.0-next-e45bc4d089f1fb259a7596b9862b3b34e717dab7 → 0.14.0-next-74f4486094d18dbaf4e7492f41a2860ba012985a

package/dist/execution/worker/parseStringInWorkerWASM.web.js

@@ -3,10 +3,12 @@ import { sendWorkerMessage } from './utils/messageHandler.js';
 import { serializeOptions } from './utils/serializeOptions.js';
 
 async function* parseStringInWorkerWASM(csv, options) {
-  using session = await WorkerSession.create({
-    workerPool: options?.engine?.workerPool,
-    workerURL: options?.engine?.workerURL
-  });
+  using session = await WorkerSession.create(
+    options?.engine?.worker === true ? {
+      workerURL: options.engine.workerURL,
+      workerPool: options.engine.workerPool
+    } : void 0
+  );
   yield* sendWorkerMessage(
     session.getWorker(),
     {

package/dist/execution/worker/parseStringInWorkerWASM.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStringInWorkerWASM.web.js","sources":["../../../src/execution/worker/parseStringInWorkerWASM.web.ts"],"sourcesContent":["import type {\n  CSVRecord,\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"../../constants.ts\";\nimport { WorkerSession } from \"./helpers/WorkerSession.ts\";\nimport { sendWorkerMessage } from \"./utils/messageHandler.ts\";\nimport { serializeOptions } from \"./utils/serializeOptions.ts\";\n\n/**\n * Parse CSV string in Worker thread using WASM (Browser/Deno).\n *\n * @internal\n */\nexport async function* parseStringInWorkerWASM<\n  Header extends ReadonlyArray<string>,\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  csv: string,\n  options?: ParseOptions<Header, Delimiter, Quotation>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  using session = await WorkerSession.create({\n    workerPool: options?.engine?.workerPool,\n    workerURL: options?.engine?.workerURL,\n  });\n\n  yield* sendWorkerMessage<CSVRecord<Header>>(\n    session.getWorker(),\n    {\n      id: session.getNextRequestId(),\n      type: \"parseString\",\n      data: csv,\n      options: serializeOptions(options),\n      useWASM: true,\n    },\n    options as ParseOptions<Header> | ParseBinaryOptions<Header> | undefined,\n  );\n}\n"],"names":[],"mappings":";;;;AAeA,gBAAuB,uBAAA,CAKrB,KACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,OAAA,GAAU,MAAM,aAAA,CAAc,MAAA,CAAO;AAAA,IACzC,UAAA,EAAY,SAAS,MAAA,EAAQ,UAAA;AAAA,IAC7B,SAAA,EAAW,SAAS,MAAA,EAAQ;AAAA,GAC7B,CAAA;AAED,EAAA,OAAO,iBAAA;AAAA,IACL,QAAQ,SAAA,EAAU;AAAA,IAClB;AAAA,MACE,EAAA,EAAI,QAAQ,gBAAA,EAAiB;AAAA,MAC7B,IAAA,EAAM,aAAA;AAAA,MACN,IAAA,EAAM,GAAA;AAAA,MACN,OAAA,EAAS,iBAAiB,OAAO,CAAA;AAAA,MACjC,OAAA,EAAS;AAAA,KACX;AAAA,IACA;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"parseStringInWorkerWASM.web.js","sources":["../../../src/execution/worker/parseStringInWorkerWASM.web.ts"],"sourcesContent":["import type {\n  CSVRecord,\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"../../constants.ts\";\nimport { WorkerSession } from \"./helpers/WorkerSession.ts\";\nimport { sendWorkerMessage } from \"./utils/messageHandler.ts\";\nimport { serializeOptions } from \"./utils/serializeOptions.ts\";\n\n/**\n * Parse CSV string in Worker thread using WASM (Browser/Deno).\n *\n * @internal\n */\nexport async function* parseStringInWorkerWASM<\n  Header extends ReadonlyArray<string>,\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  csv: string,\n  options?: ParseOptions<Header, Delimiter, Quotation>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  using session = await WorkerSession.create(\n    options?.engine?.worker === true\n      ? {\n          workerURL: options.engine.workerURL,\n          workerPool: options.engine.workerPool,\n        }\n      : undefined,\n  );\n\n  yield* sendWorkerMessage<CSVRecord<Header>>(\n    session.getWorker(),\n    {\n      id: session.getNextRequestId(),\n      type: \"parseString\",\n      data: csv,\n      options: serializeOptions(options),\n      useWASM: true,\n    },\n    options as ParseOptions<Header> | ParseBinaryOptions<Header> | undefined,\n  );\n}\n"],"names":[],"mappings":";;;;AAeA,gBAAuB,uBAAA,CAKrB,KACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,OAAA,GAAU,MAAM,aAAA,CAAc,MAAA;AAAA,IAClC,OAAA,EAAS,MAAA,EAAQ,MAAA,KAAW,IAAA,GACxB;AAAA,MACE,SAAA,EAAW,QAAQ,MAAA,CAAO,SAAA;AAAA,MAC1B,UAAA,EAAY,QAAQ,MAAA,CAAO;AAAA,KAC7B,GACA;AAAA,GACN;AAEA,EAAA,OAAO,iBAAA;AAAA,IACL,QAAQ,SAAA,EAAU;AAAA,IAClB;AAAA,MACE,EAAA,EAAI,QAAQ,gBAAA,EAAiB;AAAA,MAC7B,IAAA,EAAM,aAAA;AAAA,MACN,IAAA,EAAM,GAAA;AAAA,MACN,OAAA,EAAS,iBAAiB,OAAO,CAAA;AAAA,MACjC,OAAA,EAAS;AAAA,KACX;AAAA,IACA;AAAA,GACF;AACF;;;;"}

package/dist/execution/worker/parseUint8ArrayStreamInWorker.node.js

@@ -5,10 +5,12 @@ import { collectUint8ArrayStream } from './utils/streamCollector.node.js';
 
 async function* parseUint8ArrayStreamInWorker(stream, options) {
   const combined = await collectUint8ArrayStream(stream, options?.signal);
-  using session = await WorkerSession.create({
-    workerPool: options?.engine?.workerPool,
-    workerURL: options?.engine?.workerURL
-  });
+  using session = await WorkerSession.create(
+    options?.engine?.worker === true ? {
+      workerURL: options.engine.workerURL,
+      workerPool: options.engine.workerPool
+    } : void 0
+  );
   yield* sendWorkerMessage(
     session.getWorker(),
     {

package/dist/execution/worker/parseUint8ArrayStreamInWorker.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseUint8ArrayStreamInWorker.node.js","sources":["../../../src/execution/worker/parseUint8ArrayStreamInWorker.node.ts"],"sourcesContent":["import type {\n  CSVRecord,\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"../../constants.ts\";\nimport { WorkerSession } from \"./helpers/WorkerSession.ts\";\nimport { sendWorkerMessage } from \"./utils/messageHandler.ts\";\nimport { serializeOptions } from \"./utils/serializeOptions.ts\";\nimport { collectUint8ArrayStream } from \"./utils/streamCollector.node.ts\";\n\n/**\n * Parse CSV Uint8Array stream in Worker thread (Node.js).\n * Collects stream into Uint8Array first, then sends to worker.\n *\n * Note: Node.js Worker Threads do not support ReadableStream transfer,\n * so we collect the stream into an array first.\n *\n * @internal\n */\nexport async function* parseUint8ArrayStreamInWorker<\n  Header extends ReadonlyArray<string>,\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  stream: ReadableStream<Uint8Array>,\n  options?: ParseBinaryOptions<Header, Delimiter, Quotation>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  // Node.js: Collect stream into Uint8Array first\n  const combined = await collectUint8ArrayStream(stream, options?.signal);\n\n  using session = await WorkerSession.create({\n    workerPool: options?.engine?.workerPool,\n    workerURL: options?.engine?.workerURL,\n  });\n\n  yield* sendWorkerMessage<CSVRecord<Header>>(\n    session.getWorker(),\n    {\n      id: session.getNextRequestId(),\n      type: \"parseBinary\",\n      data: combined,\n      options: serializeOptions(options),\n      useWASM: false,\n    },\n    options as ParseOptions<Header> | ParseBinaryOptions<Header> | undefined,\n  );\n}\n"],"names":[],"mappings":";;;;;AAoBA,gBAAuB,6BAAA,CAKrB,QACA,OAAA,EAC0C;AAE1C,EAAA,MAAM,QAAA,GAAW,MAAM,uBAAA,CAAwB,MAAA,EAAQ,SAAS,MAAM,CAAA;AAEtE,EAAA,MAAM,OAAA,GAAU,MAAM,aAAA,CAAc,MAAA,CAAO;AAAA,IACzC,UAAA,EAAY,SAAS,MAAA,EAAQ,UAAA;AAAA,IAC7B,SAAA,EAAW,SAAS,MAAA,EAAQ;AAAA,GAC7B,CAAA;AAED,EAAA,OAAO,iBAAA;AAAA,IACL,QAAQ,SAAA,EAAU;AAAA,IAClB;AAAA,MACE,EAAA,EAAI,QAAQ,gBAAA,EAAiB;AAAA,MAC7B,IAAA,EAAM,aAAA;AAAA,MACN,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,iBAAiB,OAAO,CAAA;AAAA,MACjC,OAAA,EAAS;AAAA,KACX;AAAA,IACA;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"parseUint8ArrayStreamInWorker.node.js","sources":["../../../src/execution/worker/parseUint8ArrayStreamInWorker.node.ts"],"sourcesContent":["import type {\n  CSVRecord,\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"../../constants.ts\";\nimport { WorkerSession } from \"./helpers/WorkerSession.ts\";\nimport { sendWorkerMessage } from \"./utils/messageHandler.ts\";\nimport { serializeOptions } from \"./utils/serializeOptions.ts\";\nimport { collectUint8ArrayStream } from \"./utils/streamCollector.node.ts\";\n\n/**\n * Parse CSV Uint8Array stream in Worker thread (Node.js).\n * Collects stream into Uint8Array first, then sends to worker.\n *\n * Note: Node.js Worker Threads do not support ReadableStream transfer,\n * so we collect the stream into an array first.\n *\n * @internal\n */\nexport async function* parseUint8ArrayStreamInWorker<\n  Header extends ReadonlyArray<string>,\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  stream: ReadableStream<Uint8Array>,\n  options?: ParseBinaryOptions<Header, Delimiter, Quotation>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  // Node.js: Collect stream into Uint8Array first\n  const combined = await collectUint8ArrayStream(stream, options?.signal);\n\n  using session = await WorkerSession.create(\n    options?.engine?.worker === true\n      ? {\n          workerURL: options.engine.workerURL,\n          workerPool: options.engine.workerPool,\n        }\n      : undefined,\n  );\n\n  yield* sendWorkerMessage<CSVRecord<Header>>(\n    session.getWorker(),\n    {\n      id: session.getNextRequestId(),\n      type: \"parseBinary\",\n      data: combined,\n      options: serializeOptions(options),\n      useWASM: false,\n    },\n    options as ParseOptions<Header> | ParseBinaryOptions<Header> | undefined,\n  );\n}\n"],"names":[],"mappings":";;;;;AAoBA,gBAAuB,6BAAA,CAKrB,QACA,OAAA,EAC0C;AAE1C,EAAA,MAAM,QAAA,GAAW,MAAM,uBAAA,CAAwB,MAAA,EAAQ,SAAS,MAAM,CAAA;AAEtE,EAAA,MAAM,OAAA,GAAU,MAAM,aAAA,CAAc,MAAA;AAAA,IAClC,OAAA,EAAS,MAAA,EAAQ,MAAA,KAAW,IAAA,GACxB;AAAA,MACE,SAAA,EAAW,QAAQ,MAAA,CAAO,SAAA;AAAA,MAC1B,UAAA,EAAY,QAAQ,MAAA,CAAO;AAAA,KAC7B,GACA;AAAA,GACN;AAEA,EAAA,OAAO,iBAAA;AAAA,IACL,QAAQ,SAAA,EAAU;AAAA,IAClB;AAAA,MACE,EAAA,EAAI,QAAQ,gBAAA,EAAiB;AAAA,MAC7B,IAAA,EAAM,aAAA;AAAA,MACN,IAAA,EAAM,QAAA;AAAA,MACN,OAAA,EAAS,iBAAiB,OAAO,CAAA;AAAA,MACjC,OAAA,EAAS;AAAA,KACX;AAAA,IACA;AAAA,GACF;AACF;;;;"}

package/dist/execution/worker/parseUint8ArrayStreamInWorker.web.js

@@ -3,10 +3,12 @@ import { sendWorkerMessage } from './utils/messageHandler.js';
 import { serializeOptions } from './utils/serializeOptions.js';
 
 async function* parseUint8ArrayStreamInWorker(stream, options) {
-  using session = await WorkerSession.create({
-    workerPool: options?.engine?.workerPool,
-    workerURL: options?.engine?.workerURL
-  });
+  using session = await WorkerSession.create(
+    options?.engine?.worker === true ? {
+      workerURL: options.engine.workerURL,
+      workerPool: options.engine.workerPool
+    } : void 0
+  );
   yield* sendWorkerMessage(
     session.getWorker(),
     {

package/dist/execution/worker/parseUint8ArrayStreamInWorker.web.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseUint8ArrayStreamInWorker.web.js","sources":["../../../src/execution/worker/parseUint8ArrayStreamInWorker.web.ts"],"sourcesContent":["import type {\n  CSVRecord,\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"../../constants.ts\";\nimport { convertStreamToAsyncIterableIterator } from \"../../utils/convertStreamToAsyncIterableIterator.ts\";\nimport { WorkerSession } from \"./helpers/WorkerSession.ts\";\nimport { sendWorkerMessage } from \"./utils/messageHandler.ts\";\nimport { serializeOptions } from \"./utils/serializeOptions.ts\";\n\n/**\n * Parse CSV Uint8Array stream in Worker thread (Browser/Deno).\n * Uses Transferable Streams for zero-copy transfer.\n *\n * @internal\n */\nexport async function* parseUint8ArrayStreamInWorker<\n  Header extends ReadonlyArray<string>,\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  stream: ReadableStream<Uint8Array>,\n  options?: ParseBinaryOptions<Header, Delimiter, Quotation>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  using session = await WorkerSession.create({\n    workerPool: options?.engine?.workerPool,\n    workerURL: options?.engine?.workerURL,\n  });\n\n  yield* sendWorkerMessage<CSVRecord<Header>>(\n    session.getWorker(),\n    {\n      id: session.getNextRequestId(),\n      type: \"parseUint8ArrayStream\",\n      data: stream,\n      options: serializeOptions(options),\n    },\n    options as ParseOptions<Header> | ParseBinaryOptions<Header> | undefined,\n    [stream], // Transfer stream\n  );\n}\n"],"names":[],"mappings":";;;;AAiBA,gBAAuB,6BAAA,CAKrB,QACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,OAAA,GAAU,MAAM,aAAA,CAAc,MAAA,CAAO;AAAA,IACzC,UAAA,EAAY,SAAS,MAAA,EAAQ,UAAA;AAAA,IAC7B,SAAA,EAAW,SAAS,MAAA,EAAQ;AAAA,GAC7B,CAAA;AAED,EAAA,OAAO,iBAAA;AAAA,IACL,QAAQ,SAAA,EAAU;AAAA,IAClB;AAAA,MACE,EAAA,EAAI,QAAQ,gBAAA,EAAiB;AAAA,MAC7B,IAAA,EAAM,uBAAA;AAAA,MACN,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,iBAAiB,OAAO;AAAA,KACnC;AAAA,IACA,OAAA;AAAA,IACA,CAAC,MAAM;AAAA;AAAA,GACT;AACF;;;;"}
+{"version":3,"file":"parseUint8ArrayStreamInWorker.web.js","sources":["../../../src/execution/worker/parseUint8ArrayStreamInWorker.web.ts"],"sourcesContent":["import type {\n  CSVRecord,\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../common/types.ts\";\nimport type { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from \"../../constants.ts\";\nimport { convertStreamToAsyncIterableIterator } from \"../../utils/convertStreamToAsyncIterableIterator.ts\";\nimport { WorkerSession } from \"./helpers/WorkerSession.ts\";\nimport { sendWorkerMessage } from \"./utils/messageHandler.ts\";\nimport { serializeOptions } from \"./utils/serializeOptions.ts\";\n\n/**\n * Parse CSV Uint8Array stream in Worker thread (Browser/Deno).\n * Uses Transferable Streams for zero-copy transfer.\n *\n * @internal\n */\nexport async function* parseUint8ArrayStreamInWorker<\n  Header extends ReadonlyArray<string>,\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  stream: ReadableStream<Uint8Array>,\n  options?: ParseBinaryOptions<Header, Delimiter, Quotation>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  using session = await WorkerSession.create(\n    options?.engine?.worker === true\n      ? {\n          workerURL: options.engine.workerURL,\n          workerPool: options.engine.workerPool,\n        }\n      : undefined,\n  );\n\n  yield* sendWorkerMessage<CSVRecord<Header>>(\n    session.getWorker(),\n    {\n      id: session.getNextRequestId(),\n      type: \"parseUint8ArrayStream\",\n      data: stream,\n      options: serializeOptions(options),\n    },\n    options as ParseOptions<Header> | ParseBinaryOptions<Header> | undefined,\n    [stream], // Transfer stream\n  );\n}\n"],"names":[],"mappings":";;;;AAiBA,gBAAuB,6BAAA,CAKrB,QACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,OAAA,GAAU,MAAM,aAAA,CAAc,MAAA;AAAA,IAClC,OAAA,EAAS,MAAA,EAAQ,MAAA,KAAW,IAAA,GACxB;AAAA,MACE,SAAA,EAAW,QAAQ,MAAA,CAAO,SAAA;AAAA,MAC1B,UAAA,EAAY,QAAQ,MAAA,CAAO;AAAA,KAC7B,GACA;AAAA,GACN;AAEA,EAAA,OAAO,iBAAA;AAAA,IACL,QAAQ,SAAA,EAAU;AAAA,IAClB;AAAA,MACE,EAAA,EAAI,QAAQ,gBAAA,EAAiB;AAAA,MAC7B,IAAA,EAAM,uBAAA;AAAA,MACN,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,iBAAiB,OAAO;AAAA,KACnC;AAAA,IACA,OAAA;AAAA,IACA,CAAC,MAAM;AAAA;AAAA,GACT;AACF;;;;"}

package/dist/getOptionsFromFile.d.ts

@@ -0,0 +1,14 @@
+import { ParseBinaryOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER } from './constants.ts';
+/**
+ * Extracts the options from the file object.
+ *
+ * @remarks
+ * This function automatically sets the file name as the error source
+ * for better error reporting (unless explicitly overridden via options).
+ *
+ * @param file - The file object from which to extract the options.
+ * @param options - The options to merge with the extracted options.
+ * @returns The options extracted from the file.
+ */
+export declare function getOptionsFromFile<Header extends ReadonlyArray<string>, Delimiter extends string = DEFAULT_DELIMITER>(file: File, options?: ParseBinaryOptions<Header, Delimiter>): ParseBinaryOptions<Header, Delimiter>;

package/dist/getOptionsFromFile.js

@@ -0,0 +1,12 @@
+import { getOptionsFromBlob } from './getOptionsFromBlob.js';
+
+function getOptionsFromFile(file, options = {}) {
+  const blobOptions = getOptionsFromBlob(file, options);
+  return {
+    ...blobOptions,
+    source: options.source ?? file.name
+  };
+}
+
+export { getOptionsFromFile };
+//# sourceMappingURL=getOptionsFromFile.js.map

package/dist/getOptionsFromFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOptionsFromFile.js","sources":["../src/getOptionsFromFile.ts"],"sourcesContent":["import type { ParseBinaryOptions } from \"./common/types.ts\";\nimport type { DEFAULT_DELIMITER } from \"./constants.ts\";\nimport { getOptionsFromBlob } from \"./getOptionsFromBlob.ts\";\n\n/**\n * Extracts the options from the file object.\n *\n * @remarks\n * This function automatically sets the file name as the error source\n * for better error reporting (unless explicitly overridden via options).\n *\n * @param file - The file object from which to extract the options.\n * @param options - The options to merge with the extracted options.\n * @returns The options extracted from the file.\n */\nexport function getOptionsFromFile<\n  Header extends ReadonlyArray<string>,\n  Delimiter extends string = DEFAULT_DELIMITER,\n>(\n  file: File,\n  options: ParseBinaryOptions<Header, Delimiter> = {} as ParseBinaryOptions<\n    Header,\n    Delimiter\n  >,\n): ParseBinaryOptions<Header, Delimiter> {\n  // Get options from blob (charset extraction)\n  const blobOptions = getOptionsFromBlob(file, options);\n\n  // Add file name as source for error reporting if not already set\n  return {\n    ...blobOptions,\n    source: options.source ?? file.name,\n  };\n}\n"],"names":[],"mappings":";;AAeO,SAAS,kBAAA,CAId,IAAA,EACA,OAAA,GAAiD,EAAC,EAIX;AAEvC,EAAA,MAAM,WAAA,GAAc,kBAAA,CAAmB,IAAA,EAAM,OAAO,CAAA;AAGpD,EAAA,OAAO;AAAA,IACL,GAAG,WAAA;AAAA,IACH,MAAA,EAAQ,OAAA,CAAQ,MAAA,IAAU,IAAA,CAAK;AAAA,GACjC;AACF;;;;"}

package/dist/parseBlob.js

@@ -1,14 +1,22 @@
 import { commonParseErrorHandling } from './commonParseErrorHandling.js';
+import { DEFAULT_ARRAY_BUFFER_THRESHOLD } from './constants.js';
 import { getOptionsFromBlob } from './getOptionsFromBlob.js';
+import { parseBinary } from './parseBinary.js';
 import { parseBlobToStream } from './parseBlobToStream.js';
 import { parseUint8ArrayStream } from './parseUint8ArrayStream.js';
 import { convertThisAsyncIterableIteratorToArray } from './utils/convertThisAsyncIterableIteratorToArray.js';
 
 function parseBlob(blob, options) {
   const options_ = getOptionsFromBlob(blob, options);
+  const threshold = options_?.engine?.arrayBufferThreshold ?? DEFAULT_ARRAY_BUFFER_THRESHOLD;
   return (async function* () {
     try {
-      yield* parseUint8ArrayStream(blob.stream(), options_);
+      if (blob.size < threshold) {
+        const buffer = await blob.arrayBuffer();
+        yield* parseBinary(new Uint8Array(buffer), options_);
+      } else {
+        yield* parseUint8ArrayStream(blob.stream(), options_);
+      }
     } catch (error) {
       commonParseErrorHandling(error);
     }

package/dist/parseBlob.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseBlob.js","sources":["../src/parseBlob.ts"],"sourcesContent":["import type { CSVRecord, ParseBinaryOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\nimport { getOptionsFromBlob } from \"./getOptionsFromBlob.ts\";\nimport { parseBlobToStream } from \"./parseBlobToStream.ts\";\nimport { parseUint8ArrayStream } from \"./parseUint8ArrayStream.ts\";\nimport * as internal from \"./utils/convertThisAsyncIterableIteratorToArray.ts\";\n\n/**\n * Parse CSV from a {@link !Blob} or {@link !File} to records.\n *\n * @remarks\n * This function can parse CSV data from Blob or File objects.\n * If the Blob has a type with charset parameter, it will be used for decoding.\n *\n * File objects (from file inputs or drag-and-drop) extend Blob and are automatically supported.\n *\n * @category Middle-level API\n * @param blob - The blob or file to parse\n * @param options - Parsing options\n * @returns Async iterable iterator of records.\n *\n * If you want array of records, use {@link parseBlob.toArray} function.\n *\n * @example Parsing CSV from Blob\n *\n * ```ts\n * import { parseBlob } from 'web-csv-toolbox';\n *\n * const blob = new Blob(['name,age\\nAlice,42\\nBob,69'], { type: 'text/csv' });\n *\n * for await (const record of parseBlob(blob)) {\n *   console.log(record);\n * }\n * ```\n *\n * @example Parsing CSV from File (input element)\n *\n * ```ts\n * import { parseBlob } from 'web-csv-toolbox';\n *\n * const input = document.querySelector('input[type=\"file\"]');\n * input.addEventListener('change', async (event) => {\n *   const file = event.target.files[0];\n *   for await (const record of parseBlob(file)) {\n *     console.log(record);\n *   }\n * });\n * ```\n *\n * @example Parsing CSV from Blob with charset\n *\n * ```ts\n * import { parseBlob } from 'web-csv-toolbox';\n *\n * const blob = new Blob([csvData], { type: 'text/csv;charset=shift-jis' });\n *\n * for await (const record of parseBlob(blob)) {\n *   console.log(record);\n * }\n * ```\n */\nexport function parseBlob<Header extends ReadonlyArray<string>>(\n  blob: Blob,\n  options?: ParseBinaryOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  // Extract options from blob\n  const options_ = getOptionsFromBlob(blob, options);\n\n  // Return wrapper async generator for error handling\n  return (async function* () {\n    try {\n      yield* parseUint8ArrayStream(blob.stream(), options_);\n    } catch (error) {\n      commonParseErrorHandling(error);\n    }\n  })();\n}\n\nexport declare namespace parseBlob {\n  /**\n   * Parse CSV from a {@link !Blob} or {@link !File} to array of records.\n   *\n   * @returns Array of records\n   *\n   * @example Parsing CSV from Blob\n   *\n   * ```ts\n   * import { parseBlob } from 'web-csv-toolbox';\n   *\n   * const blob = new Blob(['name,age\\nAlice,42\\nBob,69'], { type: 'text/csv' });\n   *\n   * const records = await parseBlob.toArray(blob);\n   * console.log(records);\n   * ```\n   */\n  export function toArray<Header extends ReadonlyArray<string>>(\n    blob: Blob,\n    options?: ParseBinaryOptions<Header>,\n  ): Promise<CSVRecord<Header>[]>;\n  /**\n   * Parse CSV from a {@link !Blob} or {@link !File} to stream of records.\n   *\n   * @param blob - Blob or File to parse\n   * @returns Stream of records\n   *\n   * @example Parsing CSV from Blob\n   *\n   * ```ts\n   * import { parseBlob } from 'web-csv-toolbox';\n   *\n   * const blob = new Blob(['name,age\\nAlice,42\\nBob,69'], { type: 'text/csv' });\n   *\n   * await parseBlob.toStream(blob)\n   *   .pipeTo(\n   *     new WritableStream({\n   *       write(record) {\n   *         console.log(record);\n   *       },\n   *    }),\n   * );\n   * // Prints:\n   * // { name: 'Alice', age: '42' }\n   * // { name: 'Bob', age: '69' }\n   * ```\n   */\n  export function toStream<Header extends ReadonlyArray<string>>(\n    blob: Blob,\n    options?: ParseBinaryOptions<Header>,\n  ): ReadableStream<CSVRecord<Header>>;\n}\n\nObject.defineProperties(parseBlob, {\n  toArray: {\n    enumerable: true,\n    writable: false,\n    value: internal.convertThisAsyncIterableIteratorToArray,\n  },\n  toStream: {\n    enumerable: true,\n    writable: false,\n    value: parseBlobToStream,\n  },\n});\n"],"names":["internal.convertThisAsyncIterableIteratorToArray"],"mappings":";;;;;;AA6DO,SAAS,SAAA,CACd,MACA,OAAA,EAC0C;AAE1C,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,IAAA,EAAM,OAAO,CAAA;AAGjD,EAAA,OAAA,CAAQ,mBAAmB;AACzB,IAAA,IAAI;AACF,MAAA,OAAO,qBAAA,CAAsB,IAAA,CAAK,MAAA,EAAO,EAAG,QAAQ,CAAA;AAAA,IACtD,SAAS,KAAA,EAAO;AACd,MAAA,wBAAA,CAAyB,KAAK,CAAA;AAAA,IAChC;AAAA,EACF,CAAA,GAAG;AACL;AAuDA,MAAA,CAAO,iBAAiB,SAAA,EAAW;AAAA,EACjC,OAAA,EAAS;AAAA,IACP,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,OAAOA;AAAS,GAClB;AAAA,EACA,QAAA,EAAU;AAAA,IACR,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,KAAA,EAAO;AAAA;AAEX,CAAC,CAAA;;;;"}
+{"version":3,"file":"parseBlob.js","sources":["../src/parseBlob.ts"],"sourcesContent":["import type { CSVRecord, ParseBinaryOptions } from \"./common/types.ts\";\nimport { commonParseErrorHandling } from \"./commonParseErrorHandling.ts\";\nimport { DEFAULT_ARRAY_BUFFER_THRESHOLD } from \"./constants.ts\";\nimport { getOptionsFromBlob } from \"./getOptionsFromBlob.ts\";\nimport { parseBinary } from \"./parseBinary.ts\";\nimport { parseBlobToStream } from \"./parseBlobToStream.ts\";\nimport { parseUint8ArrayStream } from \"./parseUint8ArrayStream.ts\";\nimport * as internal from \"./utils/convertThisAsyncIterableIteratorToArray.ts\";\n\n/**\n * Parse CSV from a {@link !Blob} or {@link !File} to records.\n *\n * @remarks\n * This function can parse CSV data from Blob or File objects.\n * If the Blob has a type with charset parameter, it will be used for decoding.\n *\n * File objects (from file inputs or drag-and-drop) extend Blob and are automatically supported.\n *\n * @category Middle-level API\n * @param blob - The blob or file to parse\n * @param options - Parsing options\n * @returns Async iterable iterator of records.\n *\n * If you want array of records, use {@link parseBlob.toArray} function.\n *\n * @example Parsing CSV from Blob\n *\n * ```ts\n * import { parseBlob } from 'web-csv-toolbox';\n *\n * const blob = new Blob(['name,age\\nAlice,42\\nBob,69'], { type: 'text/csv' });\n *\n * for await (const record of parseBlob(blob)) {\n *   console.log(record);\n * }\n * ```\n *\n * @example Parsing CSV from File (input element)\n *\n * ```ts\n * import { parseBlob } from 'web-csv-toolbox';\n *\n * const input = document.querySelector('input[type=\"file\"]');\n * input.addEventListener('change', async (event) => {\n *   const file = event.target.files[0];\n *   for await (const record of parseBlob(file)) {\n *     console.log(record);\n *   }\n * });\n * ```\n *\n * @example Parsing CSV from Blob with charset\n *\n * ```ts\n * import { parseBlob } from 'web-csv-toolbox';\n *\n * const blob = new Blob([csvData], { type: 'text/csv;charset=shift-jis' });\n *\n * for await (const record of parseBlob(blob)) {\n *   console.log(record);\n * }\n * ```\n */\nexport function parseBlob<Header extends ReadonlyArray<string>>(\n  blob: Blob,\n  options?: ParseBinaryOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  // Extract options from blob\n  const options_ = getOptionsFromBlob(blob, options);\n\n  // Get threshold from engine config or use default\n  const threshold =\n    options_?.engine?.arrayBufferThreshold ?? DEFAULT_ARRAY_BUFFER_THRESHOLD;\n\n  // Return wrapper async generator for error handling\n  return (async function* () {\n    try {\n      // Choose strategy based on blob size and threshold\n      if (blob.size < threshold) {\n        // Small file: use arrayBuffer for better performance\n        const buffer = await blob.arrayBuffer();\n        yield* parseBinary(new Uint8Array(buffer), options_);\n      } else {\n        // Large file: use streaming for memory efficiency\n        yield* parseUint8ArrayStream(blob.stream(), options_);\n      }\n    } catch (error) {\n      commonParseErrorHandling(error);\n    }\n  })();\n}\n\nexport declare namespace parseBlob {\n  /**\n   * Parse CSV from a {@link !Blob} or {@link !File} to array of records.\n   *\n   * @returns Array of records\n   *\n   * @example Parsing CSV from Blob\n   *\n   * ```ts\n   * import { parseBlob } from 'web-csv-toolbox';\n   *\n   * const blob = new Blob(['name,age\\nAlice,42\\nBob,69'], { type: 'text/csv' });\n   *\n   * const records = await parseBlob.toArray(blob);\n   * console.log(records);\n   * ```\n   */\n  export function toArray<Header extends ReadonlyArray<string>>(\n    blob: Blob,\n    options?: ParseBinaryOptions<Header>,\n  ): Promise<CSVRecord<Header>[]>;\n  /**\n   * Parse CSV from a {@link !Blob} or {@link !File} to stream of records.\n   *\n   * @param blob - Blob or File to parse\n   * @returns Stream of records\n   *\n   * @example Parsing CSV from Blob\n   *\n   * ```ts\n   * import { parseBlob } from 'web-csv-toolbox';\n   *\n   * const blob = new Blob(['name,age\\nAlice,42\\nBob,69'], { type: 'text/csv' });\n   *\n   * await parseBlob.toStream(blob)\n   *   .pipeTo(\n   *     new WritableStream({\n   *       write(record) {\n   *         console.log(record);\n   *       },\n   *    }),\n   * );\n   * // Prints:\n   * // { name: 'Alice', age: '42' }\n   * // { name: 'Bob', age: '69' }\n   * ```\n   */\n  export function toStream<Header extends ReadonlyArray<string>>(\n    blob: Blob,\n    options?: ParseBinaryOptions<Header>,\n  ): ReadableStream<CSVRecord<Header>>;\n}\n\nObject.defineProperties(parseBlob, {\n  toArray: {\n    enumerable: true,\n    writable: false,\n    value: internal.convertThisAsyncIterableIteratorToArray,\n  },\n  toStream: {\n    enumerable: true,\n    writable: false,\n    value: parseBlobToStream,\n  },\n});\n"],"names":["internal.convertThisAsyncIterableIteratorToArray"],"mappings":";;;;;;;;AA+DO,SAAS,SAAA,CACd,MACA,OAAA,EAC0C;AAE1C,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,IAAA,EAAM,OAAO,CAAA;AAGjD,EAAA,MAAM,SAAA,GACJ,QAAA,EAAU,MAAA,EAAQ,oBAAA,IAAwB,8BAAA;AAG5C,EAAA,OAAA,CAAQ,mBAAmB;AACzB,IAAA,IAAI;AAEF,MAAA,IAAI,IAAA,CAAK,OAAO,SAAA,EAAW;AAEzB,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,WAAA,EAAY;AACtC,QAAA,OAAO,WAAA,CAAY,IAAI,UAAA,CAAW,MAAM,GAAG,QAAQ,CAAA;AAAA,MACrD,CAAA,MAAO;AAEL,QAAA,OAAO,qBAAA,CAAsB,IAAA,CAAK,MAAA,EAAO,EAAG,QAAQ,CAAA;AAAA,MACtD;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,wBAAA,CAAyB,KAAK,CAAA;AAAA,IAChC;AAAA,EACF,CAAA,GAAG;AACL;AAuDA,MAAA,CAAO,iBAAiB,SAAA,EAAW;AAAA,EACjC,OAAA,EAAS;AAAA,IACP,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,OAAOA;AAAS,GAClB;AAAA,EACA,QAAA,EAAU;AAAA,IACR,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,KAAA,EAAO;AAAA;AAEX,CAAC,CAAA;;;;"}

package/dist/parseFile.d.ts

@@ -3,11 +3,12 @@ import { CSVRecord, ParseBinaryOptions } from './common/types.ts';
  * Parse CSV from a {@link !File} to records.
  *
  * @remarks
- * This is an alias for {@link parseBlob} since File extends Blob.
- *
  * This function can parse CSV data from File objects (from file inputs or drag-and-drop).
  * If the File has a type with charset parameter, it will be used for decoding.
  *
+ * Unlike {@link parseBlob}, this function automatically sets the file name as the
+ * error source for better error reporting (unless explicitly overridden via options).
+ *
  * @category Middle-level API
  * @param file - The file to parse
  * @param options - Parsing options

package/dist/parseFile.js

@@ -1,18 +1,22 @@
+import { getOptionsFromFile } from './getOptionsFromFile.js';
 import { parseBlob } from './parseBlob.js';
+import { parseFileToArray } from './parseFileToArray.js';
+import { parseFileToStream } from './parseFileToStream.js';
 
 function parseFile(file, options) {
-  return parseBlob(file, options);
+  const options_ = getOptionsFromFile(file, options);
+  return parseBlob(file, options_);
 }
 Object.defineProperties(parseFile, {
   toArray: {
     enumerable: true,
     writable: false,
-    value: parseBlob.toArray
+    value: parseFileToArray
   },
   toStream: {
     enumerable: true,
     writable: false,
-    value: parseBlob.toStream
+    value: parseFileToStream
   }
 });
 

package/dist/parseFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseFile.js","sources":["../src/parseFile.ts"],"sourcesContent":["import type { CSVRecord, ParseBinaryOptions } from \"./common/types.ts\";\nimport { parseBlob } from \"./parseBlob.ts\";\n\n/**\n * Parse CSV from a {@link !File} to records.\n *\n * @remarks\n * This is an alias for {@link parseBlob} since File extends Blob.\n *\n * This function can parse CSV data from File objects (from file inputs or drag-and-drop).\n * If the File has a type with charset parameter, it will be used for decoding.\n *\n * @category Middle-level API\n * @param file - The file to parse\n * @param options - Parsing options\n * @returns Async iterable iterator of records.\n *\n * If you want array of records, use {@link parseFile.toArray} function.\n *\n * @example Parsing CSV from File (input element)\n *\n * ```ts\n * import { parseFile } from 'web-csv-toolbox';\n *\n * const input = document.querySelector('input[type=\"file\"]');\n * input.addEventListener('change', async (event) => {\n *   const file = event.target.files[0];\n *   for await (const record of parseFile(file)) {\n *     console.log(record);\n *   }\n * });\n * ```\n *\n * @example Parsing CSV from File (drag-and-drop)\n *\n * ```ts\n * import { parseFile } from 'web-csv-toolbox';\n *\n * dropZone.addEventListener('drop', async (event) => {\n *   event.preventDefault();\n *   const file = event.dataTransfer.files[0];\n *   for await (const record of parseFile(file)) {\n *     console.log(record);\n *   }\n * });\n * ```\n */\nexport function parseFile<Header extends ReadonlyArray<string>>(\n  file: File,\n  options?: ParseBinaryOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  return parseBlob(file, options);\n}\n\nexport declare namespace parseFile {\n  /**\n   * Parse CSV from a {@link !File} to array of records.\n   *\n   * @returns Array of records\n   *\n   * @example Parsing CSV from File\n   *\n   * ```ts\n   * import { parseFile } from 'web-csv-toolbox';\n   *\n   * const input = document.querySelector('input[type=\"file\"]');\n   * input.addEventListener('change', async (event) => {\n   *   const file = event.target.files[0];\n   *   const records = await parseFile.toArray(file);\n   *   console.log(records);\n   * });\n   * ```\n   */\n  export function toArray<Header extends ReadonlyArray<string>>(\n    file: File,\n    options?: ParseBinaryOptions<Header>,\n  ): Promise<CSVRecord<Header>[]>;\n  /**\n   * Parse CSV from a {@link !File} to stream of records.\n   *\n   * @param file - File to parse\n   * @returns Stream of records\n   *\n   * @example Parsing CSV from File\n   *\n   * ```ts\n   * import { parseFile } from 'web-csv-toolbox';\n   *\n   * const input = document.querySelector('input[type=\"file\"]');\n   * input.addEventListener('change', async (event) => {\n   *   const file = event.target.files[0];\n   *   await parseFile.toStream(file)\n   *     .pipeTo(\n   *       new WritableStream({\n   *         write(record) {\n   *           console.log(record);\n   *         },\n   *      }),\n   *   );\n   * });\n   * ```\n   */\n  export function toStream<Header extends ReadonlyArray<string>>(\n    file: File,\n    options?: ParseBinaryOptions<Header>,\n  ): ReadableStream<CSVRecord<Header>>;\n}\n\nObject.defineProperties(parseFile, {\n  toArray: {\n    enumerable: true,\n    writable: false,\n    value: parseBlob.toArray,\n  },\n  toStream: {\n    enumerable: true,\n    writable: false,\n    value: parseBlob.toStream,\n  },\n});\n"],"names":[],"mappings":";;AA+CO,SAAS,SAAA,CACd,MACA,OAAA,EAC0C;AAC1C,EAAA,OAAO,SAAA,CAAU,MAAM,OAAO,CAAA;AAChC;AAwDA,MAAA,CAAO,iBAAiB,SAAA,EAAW;AAAA,EACjC,OAAA,EAAS;AAAA,IACP,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,OAAO,SAAA,CAAU;AAAA,GACnB;AAAA,EACA,QAAA,EAAU;AAAA,IACR,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,OAAO,SAAA,CAAU;AAAA;AAErB,CAAC,CAAA;;;;"}
+{"version":3,"file":"parseFile.js","sources":["../src/parseFile.ts"],"sourcesContent":["import type { CSVRecord, ParseBinaryOptions } from \"./common/types.ts\";\nimport { getOptionsFromFile } from \"./getOptionsFromFile.ts\";\nimport { parseBlob } from \"./parseBlob.ts\";\nimport { parseFileToArray } from \"./parseFileToArray.ts\";\nimport { parseFileToStream } from \"./parseFileToStream.ts\";\n\n/**\n * Parse CSV from a {@link !File} to records.\n *\n * @remarks\n * This function can parse CSV data from File objects (from file inputs or drag-and-drop).\n * If the File has a type with charset parameter, it will be used for decoding.\n *\n * Unlike {@link parseBlob}, this function automatically sets the file name as the\n * error source for better error reporting (unless explicitly overridden via options).\n *\n * @category Middle-level API\n * @param file - The file to parse\n * @param options - Parsing options\n * @returns Async iterable iterator of records.\n *\n * If you want array of records, use {@link parseFile.toArray} function.\n *\n * @example Parsing CSV from File (input element)\n *\n * ```ts\n * import { parseFile } from 'web-csv-toolbox';\n *\n * const input = document.querySelector('input[type=\"file\"]');\n * input.addEventListener('change', async (event) => {\n *   const file = event.target.files[0];\n *   for await (const record of parseFile(file)) {\n *     console.log(record);\n *   }\n * });\n * ```\n *\n * @example Parsing CSV from File (drag-and-drop)\n *\n * ```ts\n * import { parseFile } from 'web-csv-toolbox';\n *\n * dropZone.addEventListener('drop', async (event) => {\n *   event.preventDefault();\n *   const file = event.dataTransfer.files[0];\n *   for await (const record of parseFile(file)) {\n *     console.log(record);\n *   }\n * });\n * ```\n */\nexport function parseFile<Header extends ReadonlyArray<string>>(\n  file: File,\n  options?: ParseBinaryOptions<Header>,\n): AsyncIterableIterator<CSVRecord<Header>> {\n  const options_ = getOptionsFromFile(file, options);\n  return parseBlob(file, options_);\n}\n\nexport declare namespace parseFile {\n  /**\n   * Parse CSV from a {@link !File} to array of records.\n   *\n   * @returns Array of records\n   *\n   * @example Parsing CSV from File\n   *\n   * ```ts\n   * import { parseFile } from 'web-csv-toolbox';\n   *\n   * const input = document.querySelector('input[type=\"file\"]');\n   * input.addEventListener('change', async (event) => {\n   *   const file = event.target.files[0];\n   *   const records = await parseFile.toArray(file);\n   *   console.log(records);\n   * });\n   * ```\n   */\n  export function toArray<Header extends ReadonlyArray<string>>(\n    file: File,\n    options?: ParseBinaryOptions<Header>,\n  ): Promise<CSVRecord<Header>[]>;\n  /**\n   * Parse CSV from a {@link !File} to stream of records.\n   *\n   * @param file - File to parse\n   * @returns Stream of records\n   *\n   * @example Parsing CSV from File\n   *\n   * ```ts\n   * import { parseFile } from 'web-csv-toolbox';\n   *\n   * const input = document.querySelector('input[type=\"file\"]');\n   * input.addEventListener('change', async (event) => {\n   *   const file = event.target.files[0];\n   *   await parseFile.toStream(file)\n   *     .pipeTo(\n   *       new WritableStream({\n   *         write(record) {\n   *           console.log(record);\n   *         },\n   *      }),\n   *   );\n   * });\n   * ```\n   */\n  export function toStream<Header extends ReadonlyArray<string>>(\n    file: File,\n    options?: ParseBinaryOptions<Header>,\n  ): ReadableStream<CSVRecord<Header>>;\n}\n\nObject.defineProperties(parseFile, {\n  toArray: {\n    enumerable: true,\n    writable: false,\n    value: parseFileToArray,\n  },\n  toStream: {\n    enumerable: true,\n    writable: false,\n    value: parseFileToStream,\n  },\n});\n"],"names":[],"mappings":";;;;;AAmDO,SAAS,SAAA,CACd,MACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,IAAA,EAAM,OAAO,CAAA;AACjD,EAAA,OAAO,SAAA,CAAU,MAAM,QAAQ,CAAA;AACjC;AAwDA,MAAA,CAAO,iBAAiB,SAAA,EAAW;AAAA,EACjC,OAAA,EAAS;AAAA,IACP,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,KAAA,EAAO;AAAA,GACT;AAAA,EACA,QAAA,EAAU;AAAA,IACR,UAAA,EAAY,IAAA;AAAA,IACZ,QAAA,EAAU,KAAA;AAAA,IACV,KAAA,EAAO;AAAA;AAEX,CAAC,CAAA;;;;"}

package/dist/parseFileToArray.d.ts

@@ -0,0 +1,27 @@
+import { CSVRecord, ParseBinaryOptions } from './common/types.ts';
+/**
+ * Parse CSV from a {@link !File} to array of records.
+ *
+ * @remarks
+ * This function automatically sets the file name as the error source for better
+ * error reporting (unless explicitly overridden via options).
+ *
+ * @category Middle-level API
+ * @param file - The file to parse
+ * @param options - Parsing options
+ * @returns Promise of array of records
+ *
+ * @example Parsing CSV from File
+ *
+ * ```ts
+ * import { parseFileToArray } from 'web-csv-toolbox';
+ *
+ * const input = document.querySelector('input[type="file"]');
+ * input.addEventListener('change', async (event) => {
+ *   const file = event.target.files[0];
+ *   const records = await parseFileToArray(file);
+ *   console.log(records);
+ * });
+ * ```
+ */
+export declare function parseFileToArray<Header extends ReadonlyArray<string>>(file: File, options?: ParseBinaryOptions<Header>): Promise<CSVRecord<Header>[]>;

package/dist/parseFileToArray.js

@@ -0,0 +1,12 @@
+import { parseFile } from './parseFile.js';
+
+async function parseFileToArray(file, options) {
+  const rows = [];
+  for await (const row of parseFile(file, options)) {
+    rows.push(row);
+  }
+  return rows;
+}
+
+export { parseFileToArray };
+//# sourceMappingURL=parseFileToArray.js.map

package/dist/parseFileToArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFileToArray.js","sources":["../src/parseFileToArray.ts"],"sourcesContent":["import type { CSVRecord, ParseBinaryOptions } from \"./common/types.ts\";\nimport { parseFile } from \"./parseFile.ts\";\n\n/**\n * Parse CSV from a {@link !File} to array of records.\n *\n * @remarks\n * This function automatically sets the file name as the error source for better\n * error reporting (unless explicitly overridden via options).\n *\n * @category Middle-level API\n * @param file - The file to parse\n * @param options - Parsing options\n * @returns Promise of array of records\n *\n * @example Parsing CSV from File\n *\n * ```ts\n * import { parseFileToArray } from 'web-csv-toolbox';\n *\n * const input = document.querySelector('input[type=\"file\"]');\n * input.addEventListener('change', async (event) => {\n *   const file = event.target.files[0];\n *   const records = await parseFileToArray(file);\n *   console.log(records);\n * });\n * ```\n */\nexport async function parseFileToArray<Header extends ReadonlyArray<string>>(\n  file: File,\n  options?: ParseBinaryOptions<Header>,\n): Promise<CSVRecord<Header>[]> {\n  const rows: CSVRecord<Header>[] = [];\n  for await (const row of parseFile(file, options)) {\n    rows.push(row);\n  }\n  return rows;\n}\n"],"names":[],"mappings":";;AA4BA,eAAsB,gBAAA,CACpB,MACA,OAAA,EAC8B;AAC9B,EAAA,MAAM,OAA4B,EAAC;AACnC,EAAA,WAAA,MAAiB,GAAA,IAAO,SAAA,CAAU,IAAA,EAAM,OAAO,CAAA,EAAG;AAChD,IAAA,IAAA,CAAK,KAAK,GAAG,CAAA;AAAA,EACf;AACA,EAAA,OAAO,IAAA;AACT;;;;"}

package/dist/parseFileToStream.d.ts

@@ -0,0 +1,33 @@
+import { CSVRecord, ParseBinaryOptions } from './common/types.ts';
+/**
+ * Parse CSV from a {@link !File} to stream of records.
+ *
+ * @remarks
+ * This function automatically sets the file name as the error source for better
+ * error reporting (unless explicitly overridden via options).
+ *
+ * @category Middle-level API
+ * @param file - File to parse
+ * @param options - Parsing options
+ * @returns Stream of records
+ *
+ * @example Parsing CSV from File
+ *
+ * ```ts
+ * import { parseFileToStream } from 'web-csv-toolbox';
+ *
+ * const input = document.querySelector('input[type="file"]');
+ * input.addEventListener('change', async (event) => {
+ *   const file = event.target.files[0];
+ *   await parseFileToStream(file)
+ *     .pipeTo(
+ *       new WritableStream({
+ *         write(record) {
+ *           console.log(record);
+ *         },
+ *      }),
+ *   );
+ * });
+ * ```
+ */
+export declare function parseFileToStream<Header extends ReadonlyArray<string>>(file: File, options?: ParseBinaryOptions<Header>): ReadableStream<CSVRecord<Header>>;

package/dist/parseFileToStream.js

@@ -0,0 +1,10 @@
+import { getOptionsFromFile } from './getOptionsFromFile.js';
+import { parseUint8ArrayStreamToStream } from './parseUint8ArrayStreamToStream.js';
+
+function parseFileToStream(file, options) {
+  const options_ = getOptionsFromFile(file, options);
+  return parseUint8ArrayStreamToStream(file.stream(), options_);
+}
+
+export { parseFileToStream };
+//# sourceMappingURL=parseFileToStream.js.map

package/dist/parseFileToStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFileToStream.js","sources":["../src/parseFileToStream.ts"],"sourcesContent":["import type { CSVRecord, ParseBinaryOptions } from \"./common/types.ts\";\nimport { getOptionsFromFile } from \"./getOptionsFromFile.ts\";\nimport { parseUint8ArrayStreamToStream } from \"./parseUint8ArrayStreamToStream.ts\";\n\n/**\n * Parse CSV from a {@link !File} to stream of records.\n *\n * @remarks\n * This function automatically sets the file name as the error source for better\n * error reporting (unless explicitly overridden via options).\n *\n * @category Middle-level API\n * @param file - File to parse\n * @param options - Parsing options\n * @returns Stream of records\n *\n * @example Parsing CSV from File\n *\n * ```ts\n * import { parseFileToStream } from 'web-csv-toolbox';\n *\n * const input = document.querySelector('input[type=\"file\"]');\n * input.addEventListener('change', async (event) => {\n *   const file = event.target.files[0];\n *   await parseFileToStream(file)\n *     .pipeTo(\n *       new WritableStream({\n *         write(record) {\n *           console.log(record);\n *         },\n *      }),\n *   );\n * });\n * ```\n */\nexport function parseFileToStream<Header extends ReadonlyArray<string>>(\n  file: File,\n  options?: ParseBinaryOptions<Header>,\n): ReadableStream<CSVRecord<Header>> {\n  const options_ = getOptionsFromFile(file, options);\n  return parseUint8ArrayStreamToStream(file.stream(), options_);\n}\n"],"names":[],"mappings":";;;AAmCO,SAAS,iBAAA,CACd,MACA,OAAA,EACmC;AACnC,EAAA,MAAM,QAAA,GAAW,kBAAA,CAAmB,IAAA,EAAM,OAAO,CAAA;AACjD,EAAA,OAAO,6BAAA,CAA8B,IAAA,CAAK,MAAA,EAAO,EAAG,QAAQ,CAAA;AAC9D;;;;"}

package/dist/utils/types.d.ts

@@ -1,16 +1,21 @@
+import { CSVString } from '../common/types.ts';
 import { DEFAULT_DELIMITER, DEFAULT_QUOTATION, Newline } from '../constants.ts';
-import { CSVString } from '../web-csv-toolbox.ts';
 /**
- * Generate new string by concatenating all of the elements in array.
+ * Join CSV field array into a CSV-formatted string with proper escaping.
  *
  * @category Types
  *
+ * @remarks
+ * This type handles CSV-specific formatting:
+ * - Quotes fields containing delimiters, quotations, or newlines
+ * - Joins fields with the specified delimiter
+ *
  * @example Default
  *
  * ```ts
  * const header = ["name", "age", "city", "zip"];
  *
- * type _ = Join<typeof header>
+ * type _ = JoinCSVFields<typeof header>
  * // `name,age,city,zip`
  * ```
  *
@@ -19,22 +24,28 @@ import { CSVString } from '../web-csv-toolbox.ts';
  * ```ts
  * const header = ["name", "a\nge", "city", "zip"];
  *
- * type _ = Join<typeof header, "@", "$">
+ * type _ = JoinCSVFields<typeof header, "@", "$">
  * // `name@$a\nge$@city@zip`
  * ```
  */
-export type Join<Chars extends ReadonlyArray<string | number | boolean | bigint>, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Nl extends string = Exclude<Newline, Delimiter | Quotation>> = Chars extends readonly [infer F, ...infer R] ? F extends string ? R extends string[] ? `${F extends `${string}${Nl | Delimiter | Quotation}${string}` ? `${Quotation}${F}${Quotation}` : F}${R extends [] ? "" : Delimiter}${Join<R, Delimiter, Quotation>}` : string : string : "";
+export type JoinCSVFields<Chars extends ReadonlyArray<string | number | boolean | bigint>, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Nl extends string = Exclude<Newline, Delimiter | Quotation>> = Chars extends readonly [infer F, ...infer R] ? F extends string ? R extends string[] ? `${F extends `${string}${Nl | Delimiter | Quotation}${string}` ? `${Quotation}${F}${Quotation}` : F}${R extends [] ? "" : Delimiter}${JoinCSVFields<R, Delimiter, Quotation>}` : string : string : "";
 /**
- * Generate a delimiter-separated tuple from a string.
+ * Split CSV-formatted string into field array with proper unescaping.
  *
  * @category Types
  *
+ * @remarks
+ * This type handles CSV-specific parsing:
+ * - Unquotes quoted fields
+ * - Handles escaped quotation marks
+ * - Splits by the specified delimiter
+ *
  * @example Default
  *
  * ```ts
  * const header = `name,age,city,zip`;
  *
- * type _ = Split<typeof header>
+ * type _ = SplitCSVFields<typeof header>
  * // ["name", "age", "city", "zip"]
  * ```
  *
@@ -44,11 +55,11 @@ export type Join<Chars extends ReadonlyArray<string | number | boolean | bigint>
  * const header = `name@$a
  * ge$@city@zip`;
  *
- * type _ = Split<typeof header, "@", "$">
+ * type _ = SplitCSVFields<typeof header, "@", "$">
  * // ["name", "a\nge", "city", "zip"]
  * ```
  */
-export type Split<Char extends string, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Escaping extends boolean = false, Col extends string = "", Result extends string[] = []> = Char extends `${Delimiter}${infer R}` ? Escaping extends true ? Split<R, Delimiter, Quotation, true, `${Col}${Delimiter}`, Result> : Split<R, Delimiter, Quotation, false, "", [...Result, Col]> : Char extends `${Quotation}${infer R}` ? Escaping extends true ? R extends "" | Delimiter | `${Delimiter}${string}` ? Split<R, Delimiter, Quotation, false, Col, Result> : Split<R, Delimiter, Quotation, true, `${Col}${Quotation}`, Result> : Split<R, Delimiter, Quotation, true, Col, Result> : Char extends `${infer F}${infer R}` ? Split<R, Delimiter, Quotation, Escaping, `${Col}${F}`, Result> : [...Result, Col] extends [""] ? readonly string[] : readonly [...Result, Col];
+export type SplitCSVFields<Char extends string, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Escaping extends boolean = false, Col extends string = "", Result extends string[] = []> = Char extends `${Delimiter}${infer R}` ? Escaping extends true ? SplitCSVFields<R, Delimiter, Quotation, true, `${Col}${Delimiter}`, Result> : SplitCSVFields<R, Delimiter, Quotation, false, "", [...Result, Col]> : Char extends `${Quotation}${infer R}` ? Escaping extends true ? R extends "" | Delimiter | `${Delimiter}${string}` ? SplitCSVFields<R, Delimiter, Quotation, false, Col, Result> : SplitCSVFields<R, Delimiter, Quotation, true, `${Col}${Quotation}`, Result> : SplitCSVFields<R, Delimiter, Quotation, true, Col, Result> : Char extends `${infer F}${infer R}` ? SplitCSVFields<R, Delimiter, Quotation, Escaping, `${Col}${F}`, Result> : [...Result, Col] extends [""] ? readonly string[] : readonly [...Result, Col];
 type ExtractString<Source extends CSVString> = Source extends `${infer S}` | ReadableStream<infer S> ? S : string;
 type ExtractCSVBody<CSVSource extends CSVString, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION, Nl extends string = Exclude<Newline, Delimiter | Quotation>, Escaping extends boolean = false> = ExtractString<CSVSource> extends `${Quotation}${infer R}` ? Escaping extends true ? R extends Delimiter | Nl | `${Delimiter | Nl}${string}` ? ExtractCSVBody<R, Delimiter, Quotation, Nl, false> : ExtractCSVBody<R, Delimiter, Quotation, Nl, true> : ExtractCSVBody<R, Delimiter, Quotation, Nl, true> : ExtractString<CSVSource> extends `${infer _ extends Nl}${infer R}` ? Escaping extends true ? ExtractCSVBody<R, Delimiter, Quotation, Nl, true> : R : ExtractString<CSVSource> extends `${infer _}${infer R}` ? ExtractCSVBody<R, Delimiter, Quotation, Nl, Escaping> : "";
 /**
@@ -110,5 +121,5 @@ export type ExtractCSVHeader<CSVSource extends CSVString, Delimiter extends stri
  * // ["name", "a\nge"]
  * ```
  */
-export type PickCSVHeader<CSVSource extends CSVString, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> = ExtractString<CSVSource> extends `${infer S}` ? Split<ExtractCSVHeader<S, Delimiter, Quotation>, Delimiter, Quotation> : ReadonlyArray<string>;
+export type PickCSVHeader<CSVSource extends CSVString, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION> = ExtractString<CSVSource> extends `${infer S}` ? SplitCSVFields<ExtractCSVHeader<S, Delimiter, Quotation>, Delimiter, Quotation> : ReadonlyArray<string>;
 export {};

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

@@ -8,6 +8,9 @@ export * from './parse.ts';
 export * from './parseBinary.ts';
 export * from './parseBlob.ts';
 export * from './parseFile.ts';
+export * from './parseFileToArray.ts';
+export * from './parseFileToStream.ts';
+export * from './getOptionsFromFile.ts';
 export * from './parseRequest.ts';
 export * from './parseResponse.ts';
 export * from './parseString.ts';

package/dist/web-csv-toolbox.js

@@ -7,6 +7,9 @@ export { parse } from './parse.js';
 export { parseBinary } from './parseBinary.js';
 export { parseBlob } from './parseBlob.js';
 export { parseFile } from './parseFile.js';
+export { parseFileToArray } from './parseFileToArray.js';
+export { parseFileToStream } from './parseFileToStream.js';
+export { getOptionsFromFile } from './getOptionsFromFile.js';
 export { parseRequest } from './parseRequest.js';
 export { parseResponse } from './parseResponse.js';
 export { parseString } from './parseString.js';

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

@@ -1 +1 @@
-{"version":3,"file":"web-csv-toolbox.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"web-csv-toolbox.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-csv-toolbox",
-  "version": "0.14.0-next-e45bc4d089f1fb259a7596b9862b3b34e717dab7",
+  "version": "0.14.0-next-74f4486094d18dbaf4e7492f41a2860ba012985a",
   "description": "A CSV Toolbox utilizing Web Standard APIs.",
   "type": "module",
   "module": "dist/web-csv-toolbox.js",
@@ -147,6 +147,7 @@
   "scripts": {
     "doc": "typedoc",
     "test": "vitest",
+    "test:typecheck": "vitest --typecheck.only --project typecheck --run",
     "check:type": "tsc --noEmit",
     "check:format": "pnpm check:format:js",
     "check:format:js": "biome ci .",