web-csv-toolbox 0.13.0-next-bd865d6ddb1cf9691d7b9a83d0790651f074dd47 → 0.13.0-next-b21b6d89a7a3f18dcbf79ec04ffefde0d7ff4c4c

package/dist/execution/worker/strategies/WorkerStrategy.d.ts

@@ -0,0 +1,27 @@
+import { CSVBinary, ParseBinaryOptions, ParseOptions } from '../../../common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from '../../../constants.ts';
+import { InternalEngineConfig } from '../../InternalEngineConfig.ts';
+import { WorkerSession } from '../helpers/WorkerSession.ts';
+/**
+ * Worker strategy interface.
+ *
+ * Defines how data is communicated between main thread and worker thread.
+ *
+ * @internal
+ */
+export interface WorkerStrategy<T = any> {
+    /**
+     * Strategy name.
+     */
+    readonly name: string;
+    /**
+     * Execute parsing with this strategy.
+     *
+     * @param input - Input data (string, binary, or stream)
+     * @param options - Parse options
+     * @param session - Worker session (can be null for single-use worker)
+     * @param engineConfig - Engine configuration
+     * @returns Async iterable iterator of parsed records
+     */
+    execute<Header extends ReadonlyArray<string> = readonly string[], Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION>(input: string | CSVBinary | ReadableStream<string>, options: ParseOptions<Header, Delimiter, Quotation> | ParseBinaryOptions<Header, Delimiter, Quotation> | undefined, session: WorkerSession | null, engineConfig: InternalEngineConfig): AsyncIterableIterator<T>;
+}

package/dist/execution/worker/strategies/WorkerStrategySelector.d.ts

@@ -0,0 +1,43 @@
+import { CSVBinary, ParseBinaryOptions, ParseOptions } from '../../../common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from '../../../constants.ts';
+import { InternalEngineConfig } from '../../InternalEngineConfig.ts';
+import { WorkerSession } from '../helpers/WorkerSession.ts';
+import { WorkerStrategy } from './WorkerStrategy.ts';
+/**
+ * Worker strategy selector.
+ *
+ * Selects and executes the appropriate worker communication strategy based on engine configuration.
+ * Handles fallback from stream-transfer to message-streaming if needed.
+ *
+ * @internal
+ */
+export declare class WorkerStrategySelector {
+    private strategies;
+    constructor();
+    /**
+     * Register a worker strategy.
+     */
+    register(strategy: WorkerStrategy): void;
+    /**
+     * Execute with the appropriate strategy based on engine configuration.
+     *
+     * @param input - Input data
+     * @param options - Parse options
+     * @param session - Worker session (can be null)
+     * @param engineConfig - Engine configuration
+     * @returns Async iterable iterator of parsed records
+     */
+    execute<T, Header extends ReadonlyArray<string> = readonly string[], Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION>(input: string | CSVBinary | ReadableStream<string>, options: ParseOptions<Header, Delimiter, Quotation> | ParseBinaryOptions<Header, Delimiter, Quotation> | undefined, session: WorkerSession | null, engineConfig: InternalEngineConfig): AsyncIterableIterator<T>;
+}
+/**
+ * Execute parsing with worker strategy.
+ *
+ * @internal
+ */
+export declare function executeWithWorkerStrategy<T, Header extends ReadonlyArray<string> = readonly string[], Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION>(input: string | CSVBinary | ReadableStream<string>, options: ParseOptions<Header, Delimiter, Quotation> | ParseBinaryOptions<Header, Delimiter, Quotation> | undefined, session: WorkerSession | null, engineConfig: InternalEngineConfig): AsyncIterableIterator<T>;
+/**
+ * Register a custom worker strategy.
+ *
+ * @internal
+ */
+export declare function registerWorkerStrategy(strategy: WorkerStrategy): void;

package/dist/execution/worker/strategies/WorkerStrategySelector.js

@@ -0,0 +1,89 @@
+import { MessageStreamingStrategy } from './MessageStreamingStrategy.js';
+import { TransferableStreamStrategy } from './TransferableStreamStrategy.js';
+
+class WorkerStrategySelector {
+  strategies = /* @__PURE__ */ new Map();
+  constructor() {
+    this.register(new MessageStreamingStrategy());
+    this.register(new TransferableStreamStrategy());
+  }
+  /**
+   * Register a worker strategy.
+   */
+  register(strategy) {
+    this.strategies.set(strategy.name, strategy);
+  }
+  /**
+   * Execute with the appropriate strategy based on engine configuration.
+   *
+   * @param input - Input data
+   * @param options - Parse options
+   * @param session - Worker session (can be null)
+   * @param engineConfig - Engine configuration
+   * @returns Async iterable iterator of parsed records
+   */
+  async *execute(input, options, session, engineConfig) {
+    const requestedStrategy = engineConfig.hasStreamTransfer() ? "stream-transfer" : "message-streaming";
+    const strategy = this.strategies.get(requestedStrategy);
+    if (!strategy) {
+      if (requestedStrategy === "stream-transfer") {
+        const fallbackStrategy = this.strategies.get("message-streaming");
+        if (fallbackStrategy) {
+          if (engineConfig.onFallback) {
+            const fallbackConfig = engineConfig.createFallbackConfig();
+            engineConfig.onFallback({
+              requestedConfig: engineConfig.toConfig(),
+              actualConfig: fallbackConfig.toConfig(),
+              reason: "TransferableStream strategy not available",
+              error: void 0
+            });
+          }
+          yield* fallbackStrategy.execute(
+            input,
+            options,
+            session,
+            engineConfig
+          );
+          return;
+        }
+      }
+      throw new Error(`Worker strategy "${requestedStrategy}" not available`);
+    }
+    try {
+      yield* strategy.execute(input, options, session, engineConfig);
+    } catch (error) {
+      if (engineConfig.hasStrict()) {
+        throw error;
+      }
+      if (requestedStrategy === "stream-transfer") {
+        const fallbackStrategy = this.strategies.get("message-streaming");
+        if (fallbackStrategy) {
+          const fallbackConfig = engineConfig.createFallbackConfig();
+          if (engineConfig.onFallback) {
+            engineConfig.onFallback({
+              requestedConfig: engineConfig.toConfig(),
+              actualConfig: fallbackConfig.toConfig(),
+              reason: error instanceof Error ? error.message : String(error),
+              error: error instanceof Error ? error : void 0
+            });
+          }
+          yield* fallbackStrategy.execute(
+            input,
+            options,
+            session,
+            fallbackConfig
+          );
+          return;
+        }
+      }
+      throw error;
+    }
+  }
+}
+const globalSelector = new WorkerStrategySelector();
+function executeWithWorkerStrategy(input, options, session, engineConfig) {
+  return globalSelector.execute(input, options, session, engineConfig);
+}
+
+export { WorkerStrategySelector, executeWithWorkerStrategy };
+//# sourceMappingURL=WorkerStrategySelector.js.map

package/dist/execution/worker/strategies/WorkerStrategySelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerStrategySelector.js","sources":["../../../../src/execution/worker/strategies/WorkerStrategySelector.ts"],"sourcesContent":["import type {\n  CSVBinary,\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../../common/types.ts\";\nimport type {\n  DEFAULT_DELIMITER,\n  DEFAULT_QUOTATION,\n} from \"../../../constants.ts\";\nimport type { InternalEngineConfig } from \"../../InternalEngineConfig.ts\";\nimport type { WorkerSession } from \"../helpers/WorkerSession.ts\";\nimport { MessageStreamingStrategy } from \"./MessageStreamingStrategy.ts\";\nimport { TransferableStreamStrategy } from \"./TransferableStreamStrategy.ts\";\nimport type { WorkerStrategy } from \"./WorkerStrategy.ts\";\n\n/**\n * Worker strategy selector.\n *\n * Selects and executes the appropriate worker communication strategy based on engine configuration.\n * Handles fallback from stream-transfer to message-streaming if needed.\n *\n * @internal\n */\nexport class WorkerStrategySelector {\n  private strategies = new Map<string, WorkerStrategy>();\n\n  constructor() {\n    // Register default strategies\n    this.register(new MessageStreamingStrategy());\n    this.register(new TransferableStreamStrategy());\n  }\n\n  /**\n   * Register a worker strategy.\n   */\n  register(strategy: WorkerStrategy): void {\n    this.strategies.set(strategy.name, strategy);\n  }\n\n  /**\n   * Execute with the appropriate strategy based on engine configuration.\n   *\n   * @param input - Input data\n   * @param options - Parse options\n   * @param session - Worker session (can be null)\n   * @param engineConfig - Engine configuration\n   * @returns Async iterable iterator of parsed records\n   */\n  async *execute<\n    T,\n    Header extends ReadonlyArray<string> = readonly string[],\n    Delimiter extends string = DEFAULT_DELIMITER,\n    Quotation extends string = DEFAULT_QUOTATION,\n  >(\n    input: string | CSVBinary | ReadableStream<string>,\n    options:\n      | ParseOptions<Header, Delimiter, Quotation>\n      | ParseBinaryOptions<Header, Delimiter, Quotation>\n      | undefined,\n    session: WorkerSession | null,\n    engineConfig: InternalEngineConfig,\n  ): AsyncIterableIterator<T> {\n    // Determine which strategy to use\n    const requestedStrategy = engineConfig.hasStreamTransfer()\n      ? \"stream-transfer\"\n      : \"message-streaming\";\n\n    const strategy = this.strategies.get(requestedStrategy);\n\n    if (!strategy) {\n      // If stream-transfer is not available, fallback to message-streaming\n      if (requestedStrategy === \"stream-transfer\") {\n        const fallbackStrategy = this.strategies.get(\"message-streaming\");\n        if (fallbackStrategy) {\n          // Notify about fallback\n          if (engineConfig.onFallback) {\n            const fallbackConfig = engineConfig.createFallbackConfig();\n            engineConfig.onFallback({\n              requestedConfig: engineConfig.toConfig(),\n              actualConfig: fallbackConfig.toConfig(),\n              reason: \"TransferableStream strategy not available\",\n              error: undefined,\n            });\n          }\n\n          yield* fallbackStrategy.execute(\n            input,\n            options,\n            session,\n            engineConfig,\n          );\n          return;\n        }\n      }\n\n      throw new Error(`Worker strategy \"${requestedStrategy}\" not available`);\n    }\n\n    try {\n      // Execute with the requested strategy\n      yield* strategy.execute(input, options, session, engineConfig);\n    } catch (error) {\n      // Handle fallback if not in strict mode\n      if (engineConfig.hasStrict()) {\n        // Strict mode: re-throw error\n        throw error;\n      }\n\n      // Auto-fallback to message-streaming\n      if (requestedStrategy === \"stream-transfer\") {\n        const fallbackStrategy = this.strategies.get(\"message-streaming\");\n        if (fallbackStrategy) {\n          // Notify about fallback\n          const fallbackConfig = engineConfig.createFallbackConfig();\n          if (engineConfig.onFallback) {\n            engineConfig.onFallback({\n              requestedConfig: engineConfig.toConfig(),\n              actualConfig: fallbackConfig.toConfig(),\n              reason: error instanceof Error ? error.message : String(error),\n              error: error instanceof Error ? error : undefined,\n            });\n          }\n\n          // Execute with fallback strategy\n          yield* fallbackStrategy.execute(\n            input,\n            options,\n            session,\n            fallbackConfig,\n          );\n          return;\n        }\n      }\n\n      // No fallback available, re-throw\n      throw error;\n    }\n  }\n}\n\n// Global instance\nconst globalSelector = new WorkerStrategySelector();\n\n/**\n * Execute parsing with worker strategy.\n *\n * @internal\n */\nexport function executeWithWorkerStrategy<\n  T,\n  Header extends ReadonlyArray<string> = readonly string[],\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  input: string | CSVBinary | ReadableStream<string>,\n  options:\n    | ParseOptions<Header, Delimiter, Quotation>\n    | ParseBinaryOptions<Header, Delimiter, Quotation>\n    | undefined,\n  session: WorkerSession | null,\n  engineConfig: InternalEngineConfig,\n): AsyncIterableIterator<T> {\n  return globalSelector.execute(input, options, session, engineConfig);\n}\n\n/**\n * Register a custom worker strategy.\n *\n * @internal\n */\nexport function registerWorkerStrategy(strategy: WorkerStrategy): void {\n  globalSelector.register(strategy);\n}\n"],"names":[],"mappings":";;;AAuBO,MAAM,sBAAA,CAAuB;AAAA,EAC1B,UAAA,uBAAiB,GAAA,EAA4B;AAAA,EAErD,WAAA,GAAc;AAEZ,IAAA,IAAA,CAAK,QAAA,CAAS,IAAI,wBAAA,EAA0B,CAAA;AAC5C,IAAA,IAAA,CAAK,QAAA,CAAS,IAAI,0BAAA,EAA4B,CAAA;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,QAAA,EAAgC;AACvC,IAAA,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,QAAA,CAAS,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,OAAO,OAAA,CAML,KAAA,EACA,OAAA,EAIA,SACA,YAAA,EAC0B;AAE1B,IAAA,MAAM,iBAAA,GAAoB,YAAA,CAAa,iBAAA,EAAkB,GACrD,iBAAA,GACA,mBAAA;AAEJ,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,iBAAiB,CAAA;AAEtD,IAAA,IAAI,CAAC,QAAA,EAAU;AAEb,MAAA,IAAI,sBAAsB,iBAAA,EAAmB;AAC3C,QAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,mBAAmB,CAAA;AAChE,QAAA,IAAI,gBAAA,EAAkB;AAEpB,UAAA,IAAI,aAAa,UAAA,EAAY;AAC3B,YAAA,MAAM,cAAA,GAAiB,aAAa,oBAAA,EAAqB;AACzD,YAAA,YAAA,CAAa,UAAA,CAAW;AAAA,cACtB,eAAA,EAAiB,aAAa,QAAA,EAAS;AAAA,cACvC,YAAA,EAAc,eAAe,QAAA,EAAS;AAAA,cACtC,MAAA,EAAQ,2CAAA;AAAA,cACR,KAAA,EAAO;AAAA,aACR,CAAA;AAAA,UACH;AAEA,UAAA,OAAO,gBAAA,CAAiB,OAAA;AAAA,YACtB,KAAA;AAAA,YACA,OAAA;AAAA,YACA,OAAA;AAAA,YACA;AAAA,WACF;AACA,UAAA;AAAA,QACF;AAAA,MACF;AAEA,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,iBAAA,EAAoB,iBAAiB,CAAA,eAAA,CAAiB,CAAA;AAAA,IACxE;AAEA,IAAA,IAAI;AAEF,MAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,KAAA,EAAO,OAAA,EAAS,SAAS,YAAY,CAAA;AAAA,IAC/D,SAAS,KAAA,EAAO;AAEd,MAAA,IAAI,YAAA,CAAa,WAAU,EAAG;AAE5B,QAAA,MAAM,KAAA;AAAA,MACR;AAGA,MAAA,IAAI,sBAAsB,iBAAA,EAAmB;AAC3C,QAAA,MAAM,gBAAA,GAAmB,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,mBAAmB,CAAA;AAChE,QAAA,IAAI,gBAAA,EAAkB;AAEpB,UAAA,MAAM,cAAA,GAAiB,aAAa,oBAAA,EAAqB;AACzD,UAAA,IAAI,aAAa,UAAA,EAAY;AAC3B,YAAA,YAAA,CAAa,UAAA,CAAW;AAAA,cACtB,eAAA,EAAiB,aAAa,QAAA,EAAS;AAAA,cACvC,YAAA,EAAc,eAAe,QAAA,EAAS;AAAA,cACtC,QAAQ,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAAA,cAC7D,KAAA,EAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,GAAQ;AAAA,aACzC,CAAA;AAAA,UACH;AAGA,UAAA,OAAO,gBAAA,CAAiB,OAAA;AAAA,YACtB,KAAA;AAAA,YACA,OAAA;AAAA,YACA,OAAA;AAAA,YACA;AAAA,WACF;AACA,UAAA;AAAA,QACF;AAAA,MACF;AAGA,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AACF;AAGA,MAAM,cAAA,GAAiB,IAAI,sBAAA,EAAuB;AAO3C,SAAS,yBAAA,CAMd,KAAA,EACA,OAAA,EAIA,OAAA,EACA,YAAA,EAC0B;AAC1B,EAAA,OAAO,cAAA,CAAe,OAAA,CAAQ,KAAA,EAAO,OAAA,EAAS,SAAS,YAAY,CAAA;AACrE;;;;"}

package/dist/execution/worker/utils/messageHandler.d.ts

@@ -0,0 +1,21 @@
+import { ParseBinaryOptions, ParseOptions, CSVBinary } from '../../../common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from '../../../constants.ts';
+/**
+ * Message to send to worker.
+ *
+ * @internal
+ */
+export interface WorkerMessage {
+    id: number;
+    type: string;
+    data: string | CSVBinary | ReadableStream<string>;
+    options?: Record<string, unknown>;
+    useWASM?: boolean;
+}
+/**
+ * Send a message to worker and receive streaming response.
+ * Handles abort signals, cleanup, and error handling.
+ *
+ * @internal
+ */
+export declare function sendWorkerMessage<T, Header extends ReadonlyArray<string> = readonly string[], Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION>(worker: Worker, message: WorkerMessage, options?: ParseOptions<Header, Delimiter, Quotation> | ParseBinaryOptions<Header, Delimiter, Quotation>, transfer?: Transferable[]): AsyncIterableIterator<T>;

package/dist/execution/worker/utils/messageHandler.js

@@ -0,0 +1,109 @@
+import { addListener, removeListener } from './workerUtils.js';
+
+async function* sendWorkerMessage(worker, message, options, transfer) {
+  let resolveNext = null;
+  let done = false;
+  let error = null;
+  const handler = (event) => {
+    const data = event.data;
+    if (data.id === message.id) {
+      if (data.type === "record" && data.record !== void 0) {
+        if (resolveNext) {
+          const resolve = resolveNext;
+          resolveNext = null;
+          resolve({ value: data.record, done: false });
+        }
+      } else if (data.type === "done") {
+        done = true;
+        if (resolveNext) {
+          const resolve = resolveNext;
+          resolveNext = null;
+          resolve({ value: void 0, done: true });
+        }
+      } else if (data.type === "error") {
+        error = new Error(data.error);
+        done = true;
+        if (resolveNext) {
+          const resolve = resolveNext;
+          resolveNext = null;
+          resolve({ value: void 0, done: true });
+        }
+      }
+    }
+  };
+  let cleanedUp = false;
+  const cleanup = () => {
+    if (cleanedUp) return;
+    cleanedUp = true;
+    removeListener(worker, "message", handler);
+    removeListener(worker, "error", errorHandler);
+    if (options?.signal) {
+      options.signal.removeEventListener("abort", abortHandler);
+    }
+  };
+  const errorHandler = (err) => {
+    error = new Error(err.message);
+    done = true;
+    if (resolveNext) {
+      const resolve = resolveNext;
+      resolveNext = null;
+      resolve({ value: void 0, done: true });
+    }
+  };
+  const abortHandler = () => {
+    try {
+      worker.postMessage({ id: message.id, type: "abort" });
+    } catch {
+    }
+    error = new DOMException("Aborted", "AbortError");
+    done = true;
+    if (resolveNext) {
+      const resolve = resolveNext;
+      resolveNext = null;
+      resolve({ value: void 0, done: true });
+    }
+  };
+  addListener(worker, "message", handler);
+  addListener(worker, "error", errorHandler);
+  if (options?.signal) {
+    if (options.signal.aborted) {
+      cleanup();
+      throw new DOMException("Aborted", "AbortError");
+    }
+    options.signal.addEventListener("abort", abortHandler);
+  }
+  try {
+    if (transfer) {
+      worker.postMessage(message, transfer);
+    } else {
+      worker.postMessage(message);
+    }
+  } catch (err) {
+    cleanup();
+    throw err;
+  }
+  try {
+    while (!done) {
+      if (error) {
+        throw error;
+      }
+      const result = await new Promise((resolve) => {
+        resolveNext = resolve;
+      });
+      if (error) {
+        throw error;
+      }
+      if (!result.done && result.value !== void 0) {
+        yield result.value;
+      }
+      if (result.done) {
+        break;
+      }
+    }
+  } finally {
+    cleanup();
+  }
+}
+
+export { sendWorkerMessage };
+//# sourceMappingURL=messageHandler.js.map

package/dist/execution/worker/utils/messageHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageHandler.js","sources":["../../../../src/execution/worker/utils/messageHandler.ts"],"sourcesContent":["import type {\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../../common/types.ts\";\nimport type {\n  DEFAULT_DELIMITER,\n  DEFAULT_QUOTATION,\n} from \"../../../constants.ts\";\nimport { addListener, removeListener } from \"./workerUtils.ts\";\n\nimport type { CSVBinary } from \"../../../common/types.ts\";\n\n/**\n * Message to send to worker.\n *\n * @internal\n */\nexport interface WorkerMessage {\n  id: number;\n  type: string;\n  data: string | CSVBinary | ReadableStream<string>;\n  options?: Record<string, unknown>;\n  useWASM?: boolean;\n}\n\n/**\n * Stream response from worker.\n * @internal\n */\ninterface StreamResponse<T = unknown> {\n  id: number;\n  type: \"record\" | \"done\" | \"error\";\n  record?: T;\n  error?: string;\n}\n\n/**\n * Send a message to worker and receive streaming response.\n * Handles abort signals, cleanup, and error handling.\n *\n * @internal\n */\nexport async function* sendWorkerMessage<\n  T,\n  Header extends ReadonlyArray<string> = readonly string[],\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  worker: Worker,\n  message: WorkerMessage,\n  options?:\n    | ParseOptions<Header, Delimiter, Quotation>\n    | ParseBinaryOptions<Header, Delimiter, Quotation>,\n  transfer?: Transferable[],\n): AsyncIterableIterator<T> {\n  let resolveNext: ((value: IteratorResult<T>) => void) | null = null;\n  let done = false;\n  let error: Error | null = null;\n\n  const handler = (event: MessageEvent) => {\n    const data = event.data as StreamResponse<T>;\n    if (data.id === message.id) {\n      if (data.type === \"record\" && data.record !== undefined) {\n        if (resolveNext) {\n          const resolve = resolveNext;\n          resolveNext = null;\n          resolve({ value: data.record, done: false });\n        }\n      } else if (data.type === \"done\") {\n        done = true;\n        if (resolveNext) {\n          const resolve = resolveNext;\n          resolveNext = null;\n          resolve({ value: undefined!, done: true });\n        }\n      } else if (data.type === \"error\") {\n        error = new Error(data.error);\n        done = true;\n        if (resolveNext) {\n          const resolve = resolveNext;\n          resolveNext = null;\n          resolve({ value: undefined!, done: true });\n        }\n      }\n    }\n  };\n\n  let cleanedUp = false;\n  const cleanup = () => {\n    if (cleanedUp) return;\n    cleanedUp = true;\n    removeListener(worker, \"message\", handler);\n    removeListener(worker, \"error\", errorHandler);\n    if (options?.signal) {\n      options.signal.removeEventListener(\"abort\", abortHandler);\n    }\n  };\n\n  const errorHandler = (err: ErrorEvent) => {\n    error = new Error(err.message);\n    done = true;\n    if (resolveNext) {\n      const resolve = resolveNext;\n      resolveNext = null;\n      resolve({ value: undefined as any, done: true });\n    }\n  };\n\n  const abortHandler = () => {\n    try {\n      worker.postMessage({ id: message.id, type: \"abort\" });\n    } catch {\n      // Ignore errors if worker is already terminated\n    }\n    error = new DOMException(\"Aborted\", \"AbortError\");\n    done = true;\n    if (resolveNext) {\n      const resolve = resolveNext;\n      resolveNext = null;\n      resolve({ value: undefined as any, done: true });\n    }\n  };\n\n  addListener(worker, \"message\", handler);\n  addListener(worker, \"error\", errorHandler);\n\n  // Wire abort signal if present\n  if (options?.signal) {\n    if (options.signal.aborted) {\n      cleanup();\n      throw new DOMException(\"Aborted\", \"AbortError\");\n    }\n    options.signal.addEventListener(\"abort\", abortHandler);\n  }\n\n  // Send message\n  try {\n    if (transfer) {\n      worker.postMessage(message, transfer);\n    } else {\n      worker.postMessage(message);\n    }\n  } catch (err) {\n    cleanup();\n    throw err;\n  }\n\n  // Yield records as they arrive\n  try {\n    while (!done) {\n      if (error) {\n        throw error;\n      }\n      // Wait for next record\n      const result = await new Promise<IteratorResult<T>>((resolve) => {\n        resolveNext = resolve;\n      });\n      if (error) {\n        throw error;\n      }\n      // If we got a record, yield it\n      if (!result.done && result.value !== undefined) {\n        yield result.value;\n      }\n      // If done, exit\n      if (result.done) {\n        break;\n      }\n    }\n  } finally {\n    cleanup();\n  }\n}\n"],"names":[],"mappings":";;AA0CA,gBAAuB,iBAAA,CAMrB,MAAA,EACA,OAAA,EACA,OAAA,EAGA,QAAA,EAC0B;AAC1B,EAAA,IAAI,WAAA,GAA2D,IAAA;AAC/D,EAAA,IAAI,IAAA,GAAO,KAAA;AACX,EAAA,IAAI,KAAA,GAAsB,IAAA;AAE1B,EAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAAwB;AACvC,IAAA,MAAM,OAAO,KAAA,CAAM,IAAA;AACnB,IAAA,IAAI,IAAA,CAAK,EAAA,KAAO,OAAA,CAAQ,EAAA,EAAI;AAC1B,MAAA,IAAI,IAAA,CAAK,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,WAAW,MAAA,EAAW;AACvD,QAAA,IAAI,WAAA,EAAa;AACf,UAAA,MAAM,OAAA,GAAU,WAAA;AAChB,UAAA,WAAA,GAAc,IAAA;AACd,UAAA,OAAA,CAAQ,EAAE,KAAA,EAAO,IAAA,CAAK,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AAAA,QAC7C;AAAA,MACF,CAAA,MAAA,IAAW,IAAA,CAAK,IAAA,KAAS,MAAA,EAAQ;AAC/B,QAAA,IAAA,GAAO,IAAA;AACP,QAAA,IAAI,WAAA,EAAa;AACf,UAAA,MAAM,OAAA,GAAU,WAAA;AAChB,UAAA,WAAA,GAAc,IAAA;AACd,UAAA,OAAA,CAAQ,EAAE,KAAA,EAAO,MAAA,EAAY,IAAA,EAAM,MAAM,CAAA;AAAA,QAC3C;AAAA,MACF,CAAA,MAAA,IAAW,IAAA,CAAK,IAAA,KAAS,OAAA,EAAS;AAChC,QAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,IAAA,CAAK,KAAK,CAAA;AAC5B,QAAA,IAAA,GAAO,IAAA;AACP,QAAA,IAAI,WAAA,EAAa;AACf,UAAA,MAAM,OAAA,GAAU,WAAA;AAChB,UAAA,WAAA,GAAc,IAAA;AACd,UAAA,OAAA,CAAQ,EAAE,KAAA,EAAO,MAAA,EAAY,IAAA,EAAM,MAAM,CAAA;AAAA,QAC3C;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAA;AAEA,EAAA,IAAI,SAAA,GAAY,KAAA;AAChB,EAAA,MAAM,UAAU,MAAM;AACpB,IAAA,IAAI,SAAA,EAAW;AACf,IAAA,SAAA,GAAY,IAAA;AACZ,IAAA,cAAA,CAAe,MAAA,EAAQ,WAAW,OAAO,CAAA;AACzC,IAAA,cAAA,CAAe,MAAA,EAAQ,SAAS,YAAY,CAAA;AAC5C,IAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,MAAA,OAAA,CAAQ,MAAA,CAAO,mBAAA,CAAoB,OAAA,EAAS,YAAY,CAAA;AAAA,IAC1D;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,YAAA,GAAe,CAAC,GAAA,KAAoB;AACxC,IAAA,KAAA,GAAQ,IAAI,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AAC7B,IAAA,IAAA,GAAO,IAAA;AACP,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,MAAM,OAAA,GAAU,WAAA;AAChB,MAAA,WAAA,GAAc,IAAA;AACd,MAAA,OAAA,CAAQ,EAAE,KAAA,EAAO,MAAA,EAAkB,IAAA,EAAM,MAAM,CAAA;AAAA,IACjD;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,eAAe,MAAM;AACzB,IAAA,IAAI;AACF,MAAA,MAAA,CAAO,YAAY,EAAE,EAAA,EAAI,QAAQ,EAAA,EAAI,IAAA,EAAM,SAAS,CAAA;AAAA,IACtD,CAAA,CAAA,MAAQ;AAAA,IAER;AACA,IAAA,KAAA,GAAQ,IAAI,YAAA,CAAa,SAAA,EAAW,YAAY,CAAA;AAChD,IAAA,IAAA,GAAO,IAAA;AACP,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,MAAM,OAAA,GAAU,WAAA;AAChB,MAAA,WAAA,GAAc,IAAA;AACd,MAAA,OAAA,CAAQ,EAAE,KAAA,EAAO,MAAA,EAAkB,IAAA,EAAM,MAAM,CAAA;AAAA,IACjD;AAAA,EACF,CAAA;AAEA,EAAA,WAAA,CAAY,MAAA,EAAQ,WAAW,OAAO,CAAA;AACtC,EAAA,WAAA,CAAY,MAAA,EAAQ,SAAS,YAAY,CAAA;AAGzC,EAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,IAAA,IAAI,OAAA,CAAQ,OAAO,OAAA,EAAS;AAC1B,MAAA,OAAA,EAAQ;AACR,MAAA,MAAM,IAAI,YAAA,CAAa,SAAA,EAAW,YAAY,CAAA;AAAA,IAChD;AACA,IAAA,OAAA,CAAQ,MAAA,CAAO,gBAAA,CAAiB,OAAA,EAAS,YAAY,CAAA;AAAA,EACvD;AAGA,EAAA,IAAI;AACF,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,MAAA,CAAO,WAAA,CAAY,SAAS,QAAQ,CAAA;AAAA,IACtC,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,YAAY,OAAO,CAAA;AAAA,IAC5B;AAAA,EACF,SAAS,GAAA,EAAK;AACZ,IAAA,OAAA,EAAQ;AACR,IAAA,MAAM,GAAA;AAAA,EACR;AAGA,EAAA,IAAI;AACF,IAAA,OAAO,CAAC,IAAA,EAAM;AACZ,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,MAAM,KAAA;AAAA,MACR;AAEA,MAAA,MAAM,MAAA,GAAS,MAAM,IAAI,OAAA,CAA2B,CAAC,OAAA,KAAY;AAC/D,QAAA,WAAA,GAAc,OAAA;AAAA,MAChB,CAAC,CAAA;AACD,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,MAAM,KAAA;AAAA,MACR;AAEA,MAAA,IAAI,CAAC,MAAA,CAAO,IAAA,IAAQ,MAAA,CAAO,UAAU,KAAA,CAAA,EAAW;AAC9C,QAAA,MAAM,MAAA,CAAO,KAAA;AAAA,MACf;AAEA,MAAA,IAAI,OAAO,IAAA,EAAM;AACf,QAAA;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAA,SAAE;AACA,IAAA,OAAA,EAAQ;AAAA,EACV;AACF;;;;"}

package/dist/execution/worker/utils/serializeOptions.d.ts

@@ -0,0 +1,9 @@
+import { ParseBinaryOptions, ParseOptions } from '../../../common/types.ts';
+import { DEFAULT_DELIMITER, DEFAULT_QUOTATION } from '../../../constants.ts';
+/**
+ * Extract serializable options by removing non-serializable fields.
+ * Removes: signal, engine, workerPool, workerURL (contains non-serializable objects)
+ *
+ * @internal
+ */
+export declare function serializeOptions<Header extends ReadonlyArray<string> = readonly string[], Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = DEFAULT_QUOTATION>(options?: ParseOptions<Header, Delimiter, Quotation> | ParseBinaryOptions<Header, Delimiter, Quotation>): Omit<typeof options, "signal" | "engine" | "workerPool" | "workerURL"> | undefined;

package/dist/execution/worker/utils/serializeOptions.js

@@ -0,0 +1,14 @@
+function serializeOptions(options) {
+  if (!options) return void 0;
+  const {
+    signal: _signal,
+    engine: _engine,
+    workerPool: _workerPool,
+    workerURL: _workerURL,
+    ...serializableOptions
+  } = options;
+  return serializableOptions;
+}
+
+export { serializeOptions };
+//# sourceMappingURL=serializeOptions.js.map

package/dist/execution/worker/utils/serializeOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeOptions.js","sources":["../../../../src/execution/worker/utils/serializeOptions.ts"],"sourcesContent":["import type {\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../../common/types.ts\";\nimport type {\n  DEFAULT_DELIMITER,\n  DEFAULT_QUOTATION,\n} from \"../../../constants.ts\";\n\n/**\n * Extract serializable options by removing non-serializable fields.\n * Removes: signal, engine, workerPool, workerURL (contains non-serializable objects)\n *\n * @internal\n */\nexport function serializeOptions<\n  Header extends ReadonlyArray<string> = readonly string[],\n  Delimiter extends string = DEFAULT_DELIMITER,\n  Quotation extends string = DEFAULT_QUOTATION,\n>(\n  options?:\n    | ParseOptions<Header, Delimiter, Quotation>\n    | ParseBinaryOptions<Header, Delimiter, Quotation>,\n):\n  | Omit<typeof options, \"signal\" | \"engine\" | \"workerPool\" | \"workerURL\">\n  | undefined {\n  if (!options) return undefined;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const {\n    signal: _signal,\n    engine: _engine,\n    workerPool: _workerPool,\n    workerURL: _workerURL,\n    ...serializableOptions\n  } = options as any;\n\n  return serializableOptions;\n}\n"],"names":[],"mappings":"AAeO,SAAS,iBAKd,OAAA,EAKY;AACZ,EAAA,IAAI,CAAC,SAAS,OAAO,MAAA;AAGrB,EAAA,MAAM;AAAA,IACJ,MAAA,EAAQ,OAAA;AAAA,IACR,MAAA,EAAQ,OAAA;AAAA,IACR,UAAA,EAAY,WAAA;AAAA,IACZ,SAAA,EAAW,UAAA;AAAA,IACX,GAAG;AAAA,GACL,GAAI,OAAA;AAEJ,EAAA,OAAO,mBAAA;AACT;;;;"}

package/dist/execution/worker/utils/streamCollector.node.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Collect ReadableStream<string> into a single string.
+ * Node.js does not support Transferable Streams, so we need to collect the stream first.
+ *
+ * @internal
+ */
+export declare function collectStringStream(stream: ReadableStream<string>, signal?: AbortSignal): Promise<string>;
+/**
+ * Collect ReadableStream<Uint8Array> into a single Uint8Array.
+ * Node.js does not support Transferable Streams, so we need to collect the stream first.
+ *
+ * @internal
+ */
+export declare function collectUint8ArrayStream(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): Promise<Uint8Array>;

package/dist/execution/worker/utils/streamCollector.node.js

@@ -0,0 +1,78 @@
+async function collectStringStream(stream, signal) {
+  const chunks = [];
+  const reader = stream.getReader();
+  const abortHandler = () => {
+    void reader.cancel().catch(() => {
+    });
+  };
+  try {
+    if (signal?.aborted) {
+      reader.releaseLock();
+      throw new DOMException("Aborted", "AbortError");
+    }
+    if (signal) {
+      signal.addEventListener("abort", abortHandler);
+    }
+    try {
+      while (true) {
+        if (signal?.aborted) {
+          throw new DOMException("Aborted", "AbortError");
+        }
+        const { done, value } = await reader.read();
+        if (done) break;
+        chunks.push(value);
+      }
+    } finally {
+      if (signal) {
+        signal.removeEventListener("abort", abortHandler);
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+  return chunks.join("");
+}
+async function collectUint8ArrayStream(stream, signal) {
+  const chunks = [];
+  const reader = stream.getReader();
+  const abortHandler = () => {
+    void reader.cancel().catch(() => {
+    });
+  };
+  try {
+    if (signal?.aborted) {
+      reader.releaseLock();
+      throw new DOMException("Aborted", "AbortError");
+    }
+    if (signal) {
+      signal.addEventListener("abort", abortHandler);
+    }
+    try {
+      while (true) {
+        if (signal?.aborted) {
+          throw new DOMException("Aborted", "AbortError");
+        }
+        const { done, value } = await reader.read();
+        if (done) break;
+        chunks.push(Uint8Array.from(value));
+      }
+    } finally {
+      if (signal) {
+        signal.removeEventListener("abort", abortHandler);
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+  const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
+  const combined = new Uint8Array(totalLength);
+  let offset = 0;
+  for (const chunk of chunks) {
+    combined.set(chunk, offset);
+    offset += chunk.length;
+  }
+  return combined;
+}
+
+export { collectStringStream, collectUint8ArrayStream };
+//# sourceMappingURL=streamCollector.node.js.map

package/dist/execution/worker/utils/streamCollector.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamCollector.node.js","sources":["../../../../src/execution/worker/utils/streamCollector.node.ts"],"sourcesContent":["import type {\n  ParseBinaryOptions,\n  ParseOptions,\n} from \"../../../common/types.ts\";\n\n/**\n * Collect ReadableStream<string> into a single string.\n * Node.js does not support Transferable Streams, so we need to collect the stream first.\n *\n * @internal\n */\nexport async function collectStringStream(\n  stream: ReadableStream<string>,\n  signal?: AbortSignal,\n): Promise<string> {\n  const chunks: string[] = [];\n  const reader = stream.getReader();\n\n  // AbortSignal handler for cancelling the stream\n  const abortHandler = () => {\n    void reader.cancel().catch(() => {\n      // Ignore errors during cancellation\n    });\n  };\n\n  try {\n    // Check if already aborted before starting\n    if (signal?.aborted) {\n      reader.releaseLock();\n      throw new DOMException(\"Aborted\", \"AbortError\");\n    }\n\n    // Register abort listener\n    if (signal) {\n      signal.addEventListener(\"abort\", abortHandler);\n    }\n\n    try {\n      while (true) {\n        // Check abort status before reading\n        if (signal?.aborted) {\n          throw new DOMException(\"Aborted\", \"AbortError\");\n        }\n\n        const { done, value } = await reader.read();\n        if (done) break;\n        chunks.push(value);\n      }\n    } finally {\n      // Clean up abort listener\n      if (signal) {\n        signal.removeEventListener(\"abort\", abortHandler);\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n\n  return chunks.join(\"\");\n}\n\n/**\n * Collect ReadableStream<Uint8Array> into a single Uint8Array.\n * Node.js does not support Transferable Streams, so we need to collect the stream first.\n *\n * @internal\n */\nexport async function collectUint8ArrayStream(\n  stream: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n): Promise<Uint8Array> {\n  const chunks: Uint8Array[] = [];\n  const reader = stream.getReader();\n\n  // AbortSignal handler for cancelling the stream\n  const abortHandler = () => {\n    void reader.cancel().catch(() => {\n      // Ignore errors during cancellation\n    });\n  };\n\n  try {\n    // Check if already aborted before starting\n    if (signal?.aborted) {\n      reader.releaseLock();\n      throw new DOMException(\"Aborted\", \"AbortError\");\n    }\n\n    // Register abort listener\n    if (signal) {\n      signal.addEventListener(\"abort\", abortHandler);\n    }\n\n    try {\n      while (true) {\n        // Check abort status before reading\n        if (signal?.aborted) {\n          throw new DOMException(\"Aborted\", \"AbortError\");\n        }\n\n        const { done, value } = await reader.read();\n        if (done) break;\n        // Copy the chunk to avoid detached buffer issues\n        chunks.push(Uint8Array.from(value));\n      }\n    } finally {\n      // Clean up abort listener\n      if (signal) {\n        signal.removeEventListener(\"abort\", abortHandler);\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n\n  // Concatenate all chunks into a single Uint8Array\n  const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);\n  const combined = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    combined.set(chunk, offset);\n    offset += chunk.length;\n  }\n\n  return combined;\n}\n"],"names":[],"mappings":"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"}

package/dist/execution/worker/utils/workerUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cross-platform event listener utilities for Web Workers and Node.js Worker Threads.
+ * @internal
+ */
+type EventHandler = (event: any) => void;
+/**
+ * Add event listener to worker (compatible with both Web Workers and Node.js Worker Threads)
+ */
+export declare function addListener(worker: Worker, event: "message" | "error", handler: EventHandler): void;
+/**
+ * Remove event listener from worker (compatible with both Web Workers and Node.js Worker Threads)
+ */
+export declare function removeListener(worker: Worker, event: "message" | "error", handler: EventHandler): void;
+export {};

package/dist/execution/worker/utils/workerUtils.js

@@ -0,0 +1,25 @@
+const handlerMap = /* @__PURE__ */ new WeakMap();
+function addListener(worker, event, handler) {
+  if ("addEventListener" in worker) {
+    worker.addEventListener(event, handler);
+  } else {
+    const normalizedHandler = event === "message" ? (data) => handler({ data }) : handler;
+    if (!handlerMap.has(worker)) {
+      handlerMap.set(worker, /* @__PURE__ */ new Map());
+    }
+    handlerMap.get(worker).set(handler, normalizedHandler);
+    worker.on(event, normalizedHandler);
+  }
+}
+function removeListener(worker, event, handler) {
+  if ("removeEventListener" in worker) {
+    worker.removeEventListener(event, handler);
+  } else {
+    const normalizedHandler = handlerMap.get(worker)?.get(handler) || handler;
+    worker.off(event, normalizedHandler);
+    handlerMap.get(worker)?.delete(handler);
+  }
+}
+
+export { addListener, removeListener };
+//# sourceMappingURL=workerUtils.js.map

package/dist/execution/worker/utils/workerUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerUtils.js","sources":["../../../../src/execution/worker/utils/workerUtils.ts"],"sourcesContent":["/**\n * Cross-platform event listener utilities for Web Workers and Node.js Worker Threads.\n * @internal\n */\n\ntype EventHandler = (event: any) => void;\n\n// Store mapping of original handlers to normalized handlers for Node.js\nconst handlerMap = new WeakMap<object, Map<EventHandler, EventHandler>>();\n\n/**\n * Add event listener to worker (compatible with both Web Workers and Node.js Worker Threads)\n */\nexport function addListener(\n  worker: Worker,\n  event: \"message\" | \"error\",\n  handler: EventHandler,\n): void {\n  if (\"addEventListener\" in worker) {\n    // Web Workers API (browser, Deno)\n    worker.addEventListener(event, handler);\n  } else {\n    // Node.js Worker Threads API\n    // In Node.js, message data is passed directly, not wrapped in event.data\n    // We need to normalize it to match the Web Workers API\n    const normalizedHandler =\n      event === \"message\" ? (data: any) => handler({ data }) : handler;\n\n    // Store the mapping so we can remove it later\n    if (!handlerMap.has(worker)) {\n      handlerMap.set(worker, new Map());\n    }\n    handlerMap.get(worker)!.set(handler, normalizedHandler);\n\n    // @ts-ignore - Node.js Worker has different API\n    worker.on(event, normalizedHandler);\n  }\n}\n\n/**\n * Remove event listener from worker (compatible with both Web Workers and Node.js Worker Threads)\n */\nexport function removeListener(\n  worker: Worker,\n  event: \"message\" | \"error\",\n  handler: EventHandler,\n): void {\n  if (\"removeEventListener\" in worker) {\n    // Web Workers API (browser, Deno)\n    worker.removeEventListener(event, handler);\n  } else {\n    // Node.js Worker Threads API\n    // Get the normalized handler from the map\n    const normalizedHandler = handlerMap.get(worker)?.get(handler) || handler;\n    // @ts-ignore - Node.js Worker has different API\n    worker.off(event, normalizedHandler);\n\n    // Clean up the mapping\n    handlerMap.get(worker)?.delete(handler);\n  }\n}\n"],"names":[],"mappings":"AAQA,MAAM,UAAA,uBAAiB,OAAA,EAAiD;AAKjE,SAAS,WAAA,CACd,MAAA,EACA,KAAA,EACA,OAAA,EACM;AACN,EAAA,IAAI,sBAAsB,MAAA,EAAQ;AAEhC,IAAA,MAAA,CAAO,gBAAA,CAAiB,OAAO,OAAO,CAAA;AAAA,EACxC,CAAA,MAAO;AAIL,IAAA,MAAM,iBAAA,GACJ,UAAU,SAAA,GAAY,CAAC,SAAc,OAAA,CAAQ,EAAE,IAAA,EAAM,CAAA,GAAI,OAAA;AAG3D,IAAA,IAAI,CAAC,UAAA,CAAW,GAAA,CAAI,MAAM,CAAA,EAAG;AAC3B,MAAA,UAAA,CAAW,GAAA,CAAI,MAAA,kBAAQ,IAAI,GAAA,EAAK,CAAA;AAAA,IAClC;AACA,IAAA,UAAA,CAAW,GAAA,CAAI,MAAM,CAAA,CAAG,GAAA,CAAI,SAAS,iBAAiB,CAAA;AAGtD,IAAA,MAAA,CAAO,EAAA,CAAG,OAAO,iBAAiB,CAAA;AAAA,EACpC;AACF;AAKO,SAAS,cAAA,CACd,MAAA,EACA,KAAA,EACA,OAAA,EACM;AACN,EAAA,IAAI,yBAAyB,MAAA,EAAQ;AAEnC,IAAA,MAAA,CAAO,mBAAA,CAAoB,OAAO,OAAO,CAAA;AAAA,EAC3C,CAAA,MAAO;AAGL,IAAA,MAAM,oBAAoB,UAAA,CAAW,GAAA,CAAI,MAAM,CAAA,EAAG,GAAA,CAAI,OAAO,CAAA,IAAK,OAAA;AAElE,IAAA,MAAA,CAAO,GAAA,CAAI,OAAO,iBAAiB,CAAA;AAGnC,IAAA,UAAA,CAAW,GAAA,CAAI,MAAM,CAAA,EAAG,MAAA,CAAO,OAAO,CAAA;AAAA,EACxC;AACF;;;;"}

package/dist/getOptionsFromResponse.constants.node.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Supported compression formats for CSV decompression in Node.js environments.
+ *
+ * @remarks
+ * Node.js 20+ supports gzip and deflate via the Compression Streams API.
+ * deflate-raw may not be reliably supported in all Node.js versions.
+ *
+ * @see {@link https://nodejs.org/api/webstreams.html#compressionstream | Node.js CompressionStream}
+ */
+export declare const SUPPORTED_COMPRESSIONS: ReadonlySet<CompressionFormat>;

package/dist/getOptionsFromResponse.constants.node.js

@@ -0,0 +1,8 @@
+const SUPPORTED_COMPRESSIONS = /* @__PURE__ */ new Set([
+  "gzip",
+  "deflate"
+  // Note: deflate-raw is not included as it may not be supported in Node.js 20
+]);
+
+export { SUPPORTED_COMPRESSIONS };
+//# sourceMappingURL=getOptionsFromResponse.constants.node.js.map

package/dist/getOptionsFromResponse.constants.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOptionsFromResponse.constants.node.js","sources":["../src/getOptionsFromResponse.constants.node.ts"],"sourcesContent":["/**\n * Supported compression formats for CSV decompression in Node.js environments.\n *\n * @remarks\n * Node.js 20+ supports gzip and deflate via the Compression Streams API.\n * deflate-raw may not be reliably supported in all Node.js versions.\n *\n * @see {@link https://nodejs.org/api/webstreams.html#compressionstream | Node.js CompressionStream}\n */\nexport const SUPPORTED_COMPRESSIONS: ReadonlySet<CompressionFormat> = new Set([\n  \"gzip\",\n  \"deflate\",\n  // Note: deflate-raw is not included as it may not be supported in Node.js 20\n]);\n"],"names":[],"mappings":"AASO,MAAM,sBAAA,uBAA6D,GAAA,CAAI;AAAA,EAC5E,MAAA;AAAA,EACA;AAAA;AAEF,CAAC;;;;"}

package/dist/getOptionsFromResponse.constants.web.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Supported compression formats for CSV decompression in browser environments.
+ *
+ * @remarks
+ * By default, only universally supported compression formats (gzip and deflate) are included
+ * to ensure cross-browser compatibility. These formats are part of the standard Compression
+ * Streams API and work reliably across all modern browsers (Chrome, Firefox, Safari, Edge).
+ *
+ * ### Experimental Compression Support
+ *
+ * Additional compression formats like `deflate-raw` may be supported in some browsers
+ * (e.g., Chromium-based browsers such as Chrome and Edge), but are not guaranteed to work
+ * across all environments. To use experimental compression formats:
+ *
+ * 1. Set the `allowExperimentalCompressions` option to `true` in your parse function
+ * 2. Be aware that this may cause errors in browsers that don't support the format
+ * 3. Consider implementing fallback handling for unsupported formats
+ *
+ * @example
+ * ```typescript
+ * // Use experimental compressions (may fail in some browsers)
+ * const records = parseResponse(response, {
+ *   allowExperimentalCompressions: true
+ * });
+ * ```
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/CompressionFormat | CompressionFormat}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DecompressionStream | DecompressionStream}
+ */
+export declare const SUPPORTED_COMPRESSIONS: ReadonlySet<CompressionFormat>;

package/dist/getOptionsFromResponse.constants.web.js

@@ -0,0 +1,7 @@
+const SUPPORTED_COMPRESSIONS = /* @__PURE__ */ new Set([
+  "gzip",
+  "deflate"
+]);
+
+export { SUPPORTED_COMPRESSIONS };
+//# sourceMappingURL=getOptionsFromResponse.constants.web.js.map

package/dist/getOptionsFromResponse.constants.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOptionsFromResponse.constants.web.js","sources":["../src/getOptionsFromResponse.constants.web.ts"],"sourcesContent":["/**\n * Supported compression formats for CSV decompression in browser environments.\n *\n * @remarks\n * By default, only universally supported compression formats (gzip and deflate) are included\n * to ensure cross-browser compatibility. These formats are part of the standard Compression\n * Streams API and work reliably across all modern browsers (Chrome, Firefox, Safari, Edge).\n *\n * ### Experimental Compression Support\n *\n * Additional compression formats like `deflate-raw` may be supported in some browsers\n * (e.g., Chromium-based browsers such as Chrome and Edge), but are not guaranteed to work\n * across all environments. To use experimental compression formats:\n *\n * 1. Set the `allowExperimentalCompressions` option to `true` in your parse function\n * 2. Be aware that this may cause errors in browsers that don't support the format\n * 3. Consider implementing fallback handling for unsupported formats\n *\n * @example\n * ```typescript\n * // Use experimental compressions (may fail in some browsers)\n * const records = parseResponse(response, {\n *   allowExperimentalCompressions: true\n * });\n * ```\n *\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/CompressionFormat | CompressionFormat}\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DecompressionStream | DecompressionStream}\n */\nexport const SUPPORTED_COMPRESSIONS: ReadonlySet<CompressionFormat> = new Set([\n  \"gzip\",\n  \"deflate\",\n]);\n"],"names":[],"mappings":"AA6BO,MAAM,sBAAA,uBAA6D,GAAA,CAAI;AAAA,EAC5E,MAAA;AAAA,EACA;AACF,CAAC;;;;"}

package/dist/getOptionsFromResponse.d.ts

@@ -1,4 +1,5 @@
 import { ParseBinaryOptions } from './common/types.ts';
+import { DEFAULT_DELIMITER } from './constants.ts';
 /**
  * Extracts the options from the response object.
  *
@@ -7,4 +8,4 @@ import { ParseBinaryOptions } from './common/types.ts';
  * @returns The options extracted from the response.
  * @throws {TypeError} - The content type is not supported or the content-encoding is invalid.
  */
-export declare function getOptionsFromResponse<Header extends ReadonlyArray<string>>(response: Response, options?: ParseBinaryOptions<Header>): ParseBinaryOptions<Header>;
+export declare function getOptionsFromResponse<Header extends ReadonlyArray<string>, Delimiter extends string = DEFAULT_DELIMITER, Quotation extends string = '"'>(response: Response, options?: ParseBinaryOptions<Header, Delimiter, Quotation>): ParseBinaryOptions<Header, Delimiter, Quotation>;