convert-buddy-js 0.11.2 → 0.12.0

package/dist/browser.d.ts

@@ -1,6 +1,5 @@
-import { C as ConvertOptions, F as Format } from './index-DiYloo2I.js';
-export { G as CSVSplitter, f as Coerce, j as ConvertBuddy, a as ConvertBuddyOptions, p as ConvertBuddyTransformStream, j as Converter, d as CsvConfig, b as CsvDetection, D as DetectInput, c as DetectOptions, g as FieldMap, H as JSONSplitter, J as JsonDetection, E as NDJSONSplitter, N as NdjsonDetection, B as ParsedRecord, P as ProgressCallback, i as Stats, A as StreamControllerOptions, S as StructureDetection, h as TransformConfig, T as TransformMode, I as XMLSplitter, e as XmlConfig, X as XmlDetection, o as autoDetectConfig, q as convertAny, r as convertAnyToString, K as createSplitter, m as detectCsvFieldsAndDelimiter, k as detectFormat, l as detectStructure, n as detectXmlElements, t as getExtension, s as getMimeType, x as getOptimalThreadCount, u as getSuggestedFilename, y as getThreadingInfo, w as isWasmThreadingSupported } from './index-DiYloo2I.js';
-export { BrowserStreamController, BrowserStreamInput, processStream } from './browser-stream-controller.js';
+import { ConvertOptions, Format } from './index.js';
+export { Coerce, ConvertBuddy, ConvertBuddyOptions, ConvertBuddyTransformStream, ConvertBuddy as Converter, CsvConfig, CsvDetection, DetectInput, DetectOptions, FieldMap, JsonDetection, NdjsonDetection, ProgressCallback, Stats, StreamController, StreamInput, StreamOptions, StreamResult, StructureDetection, TransformConfig, TransformMode, XmlConfig, XmlDetection, autoDetectConfig, convertAny, convertAnyToString, createStreamController, detectCsvFieldsAndDelimiter, detectFormat, detectStructure, detectXmlElements, getExtension, getMimeType, getOptimalThreadCount, getSuggestedFilename, getThreadingInfo, isWasmThreadingSupported, processStream, streamRecords } from './index.js';
 
 /**
  * Browser entry point for convert-buddy-js

package/dist/browser.js

@@ -1,6 +1,4 @@
 export * from "./index.js";
-export * from "./stream-controller.js";
-export * from "./browser-stream-controller.js";
 import {
   convertToString as coreConvertToString,
   convert as coreConvert,

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/browser.ts"],"sourcesContent":["/**\r\n * Browser entry point for convert-buddy-js\r\n * Re-exports the main API but optimized for browser environments\r\n */\r\n\r\n// Re-export all the main functionality from index\r\nexport * from \"./index.js\";\r\n\r\n// Export browser-specific streaming controllers\r\nexport * from \"./stream-controller.js\";\r\nexport * from \"./browser-stream-controller.js\";\r\n\r\n// Export browser-specific utilities\r\nimport {\r\n  type Format,\r\n  type ConvertOptions,\r\n  type ConvertBuddyOptions,\r\n  convertToString as coreConvertToString,\r\n  convert as coreConvert,\r\n  ConvertBuddy,\r\n  getMimeType,\r\n  getExtension,\r\n  getSuggestedFilename,\r\n} from \"./index.js\";\r\n\r\n/**\r\n * Browser-optimized convert function for strings\r\n */\r\nexport async function convertToString(\r\n  input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>,\r\n  opts: ConvertOptions\r\n): Promise<string> {\r\n  if (typeof input === \"string\" || input instanceof Uint8Array) {\r\n    return coreConvertToString(input, opts);\r\n  }\r\n  \r\n  if (typeof File !== \"undefined\" && input instanceof File) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvertToString(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof Blob !== \"undefined\" && input instanceof Blob) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvertToString(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof ReadableStream !== \"undefined\" && input instanceof ReadableStream) {\r\n    const chunks: Uint8Array[] = [];\r\n    const reader = input.getReader();\r\n    \r\n    try {\r\n      while (true) {\r\n        const { done, value } = await reader.read();\r\n        if (done) break;\r\n        chunks.push(value);\r\n      }\r\n    } finally {\r\n      reader.releaseLock();\r\n    }\r\n    \r\n    // Combine chunks\r\n    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);\r\n    const combined = new Uint8Array(totalLength);\r\n    let offset = 0;\r\n    for (const chunk of chunks) {\r\n      combined.set(chunk, offset);\r\n      offset += chunk.length;\r\n    }\r\n    \r\n    return coreConvertToString(combined, opts);\r\n  }\r\n  \r\n  throw new Error(\"Unsupported input type for browser environment\");\r\n}\r\n\r\n/**\r\n * Browser-optimized convert function for bytes\r\n */\r\nexport async function convert(\r\n  input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>,\r\n  opts: ConvertOptions\r\n): Promise<Uint8Array> {\r\n  if (typeof input === \"string\" || input instanceof Uint8Array) {\r\n    return coreConvert(input, opts);\r\n  }\r\n  \r\n  if (typeof File !== \"undefined\" && input instanceof File) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvert(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof Blob !== \"undefined\" && input instanceof Blob) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvert(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof ReadableStream !== \"undefined\" && input instanceof ReadableStream) {\r\n    const chunks: Uint8Array[] = [];\r\n    const reader = input.getReader();\r\n    \r\n    try {\r\n      while (true) {\r\n        const { done, value } = await reader.read();\r\n        if (done) break;\r\n        chunks.push(value);\r\n      }\r\n    } finally {\r\n      reader.releaseLock();\r\n    }\r\n    \r\n    // Combine chunks\r\n    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);\r\n    const combined = new Uint8Array(totalLength);\r\n    let offset = 0;\r\n    for (const chunk of chunks) {\r\n      combined.set(chunk, offset);\r\n      offset += chunk.length;\r\n    }\r\n    \r\n    return coreConvert(combined, opts);\r\n  }\r\n  \r\n  throw new Error(\"Unsupported input type for browser environment\");\r\n}\r\n\r\n/**\r\n * Convert a browser File or Blob and trigger download of the result\r\n */\r\nexport async function convertFileToFile(\r\n  inputFile: File | Blob,\r\n  outputFilename: string,\r\n  opts: ConvertOptions\r\n): Promise<void> {\r\n  const result = await convert(inputFile, opts);\r\n  \r\n  // Create download\r\n  const mimeType = getMimeType(opts.outputFormat);\r\n  const blob = new Blob([result.buffer as ArrayBuffer], { type: mimeType });\r\n  const url = URL.createObjectURL(blob);\r\n  \r\n  const link = document.createElement(\"a\");\r\n  link.href = url;\r\n  link.download = outputFilename;\r\n  link.style.display = \"none\";\r\n  \r\n  document.body.appendChild(link);\r\n  link.click();\r\n  \r\n  // Cleanup\r\n  setTimeout(() => {\r\n    document.body.removeChild(link);\r\n    URL.revokeObjectURL(url);\r\n  }, 100);\r\n}\r\n\r\n/**\r\n * Get file type configuration for browser file pickers\r\n */\r\nexport function getFileTypeConfig(format: Format): Array<{\r\n  description: string;\r\n  accept: Record<string, string[]>;\r\n}> {\r\n  const mimeType = getMimeType(format);\r\n  const extension = `.${getExtension(format)}`;\r\n\r\n  return [\r\n    {\r\n      description: `${format.toUpperCase()} Files`,\r\n      accept: { [mimeType]: [extension] },\r\n    },\r\n  ];\r\n}\r\n\r\n// Legacy exports for backward compatibility\r\nexport { ConvertBuddy as Converter };"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/browser.ts"],"sourcesContent":["/**\r\n * Browser entry point for convert-buddy-js\r\n * Re-exports the main API but optimized for browser environments\r\n */\r\n\r\n// Re-export all the main functionality from index\r\nexport * from \"./index.js\";\r\n\r\n// Export browser-specific utilities\r\nimport {\r\n  type Format,\r\n  type ConvertOptions,\r\n  type ConvertBuddyOptions,\r\n  convertToString as coreConvertToString,\r\n  convert as coreConvert,\r\n  ConvertBuddy,\r\n  getMimeType,\r\n  getExtension,\r\n  getSuggestedFilename,\r\n} from \"./index.js\";\r\n\r\n/**\r\n * Browser-optimized convert function for strings\r\n */\r\nexport async function convertToString(\r\n  input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>,\r\n  opts: ConvertOptions\r\n): Promise<string> {\r\n  if (typeof input === \"string\" || input instanceof Uint8Array) {\r\n    return coreConvertToString(input, opts);\r\n  }\r\n  \r\n  if (typeof File !== \"undefined\" && input instanceof File) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvertToString(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof Blob !== \"undefined\" && input instanceof Blob) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvertToString(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof ReadableStream !== \"undefined\" && input instanceof ReadableStream) {\r\n    const chunks: Uint8Array[] = [];\r\n    const reader = input.getReader();\r\n    \r\n    try {\r\n      while (true) {\r\n        const { done, value } = await reader.read();\r\n        if (done) break;\r\n        chunks.push(value);\r\n      }\r\n    } finally {\r\n      reader.releaseLock();\r\n    }\r\n    \r\n    // Combine chunks\r\n    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);\r\n    const combined = new Uint8Array(totalLength);\r\n    let offset = 0;\r\n    for (const chunk of chunks) {\r\n      combined.set(chunk, offset);\r\n      offset += chunk.length;\r\n    }\r\n    \r\n    return coreConvertToString(combined, opts);\r\n  }\r\n  \r\n  throw new Error(\"Unsupported input type for browser environment\");\r\n}\r\n\r\n/**\r\n * Browser-optimized convert function for bytes\r\n */\r\nexport async function convert(\r\n  input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>,\r\n  opts: ConvertOptions\r\n): Promise<Uint8Array> {\r\n  if (typeof input === \"string\" || input instanceof Uint8Array) {\r\n    return coreConvert(input, opts);\r\n  }\r\n  \r\n  if (typeof File !== \"undefined\" && input instanceof File) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvert(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof Blob !== \"undefined\" && input instanceof Blob) {\r\n    const arrayBuffer = await input.arrayBuffer();\r\n    return coreConvert(new Uint8Array(arrayBuffer), opts);\r\n  }\r\n  \r\n  if (typeof ReadableStream !== \"undefined\" && input instanceof ReadableStream) {\r\n    const chunks: Uint8Array[] = [];\r\n    const reader = input.getReader();\r\n    \r\n    try {\r\n      while (true) {\r\n        const { done, value } = await reader.read();\r\n        if (done) break;\r\n        chunks.push(value);\r\n      }\r\n    } finally {\r\n      reader.releaseLock();\r\n    }\r\n    \r\n    // Combine chunks\r\n    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);\r\n    const combined = new Uint8Array(totalLength);\r\n    let offset = 0;\r\n    for (const chunk of chunks) {\r\n      combined.set(chunk, offset);\r\n      offset += chunk.length;\r\n    }\r\n    \r\n    return coreConvert(combined, opts);\r\n  }\r\n  \r\n  throw new Error(\"Unsupported input type for browser environment\");\r\n}\r\n\r\n/**\r\n * Convert a browser File or Blob and trigger download of the result\r\n */\r\nexport async function convertFileToFile(\r\n  inputFile: File | Blob,\r\n  outputFilename: string,\r\n  opts: ConvertOptions\r\n): Promise<void> {\r\n  const result = await convert(inputFile, opts);\r\n  \r\n  // Create download\r\n  const mimeType = getMimeType(opts.outputFormat);\r\n  const blob = new Blob([result.buffer as ArrayBuffer], { type: mimeType });\r\n  const url = URL.createObjectURL(blob);\r\n  \r\n  const link = document.createElement(\"a\");\r\n  link.href = url;\r\n  link.download = outputFilename;\r\n  link.style.display = \"none\";\r\n  \r\n  document.body.appendChild(link);\r\n  link.click();\r\n  \r\n  // Cleanup\r\n  setTimeout(() => {\r\n    document.body.removeChild(link);\r\n    URL.revokeObjectURL(url);\r\n  }, 100);\r\n}\r\n\r\n/**\r\n * Get file type configuration for browser file pickers\r\n */\r\nexport function getFileTypeConfig(format: Format): Array<{\r\n  description: string;\r\n  accept: Record<string, string[]>;\r\n}> {\r\n  const mimeType = getMimeType(format);\r\n  const extension = `.${getExtension(format)}`;\r\n\r\n  return [\r\n    {\r\n      description: `${format.toUpperCase()} Files`,\r\n      accept: { [mimeType]: [extension] },\r\n    },\r\n  ];\r\n}\r\n\r\n// Legacy exports for backward compatibility\r\nexport { ConvertBuddy as Converter };"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1 +1,458 @@
-export { f as Coerce, j as ConvertBuddy, a as ConvertBuddyOptions, p as ConvertBuddyTransformStream, C as ConvertOptions, z as Converter, d as CsvConfig, b as CsvDetection, D as DetectInput, c as DetectOptions, g as FieldMap, F as Format, J as JsonDetection, N as NdjsonDetection, B as ParsedRecord, P as ProgressCallback, i as Stats, A as StreamControllerOptions, S as StructureDetection, h as TransformConfig, T as TransformMode, e as XmlConfig, X as XmlDetection, o as autoDetectConfig, L as convert, q as convertAny, r as convertAnyToString, M as convertToString, m as detectCsvFieldsAndDelimiter, k as detectFormat, l as detectStructure, n as detectXmlElements, t as getExtension, v as getFileTypeConfig, s as getMimeType, x as getOptimalThreadCount, u as getSuggestedFilename, y as getThreadingInfo, w as isWasmThreadingSupported } from './index-DiYloo2I.js';
+/**
+ * Unified Streaming API for ConvertBuddy
+ *
+ * This is the PRODUCTION-READY isomorphic streaming interface.
+ * Works identically in browser and Node.js environments.
+ *
+ * Design Principles:
+ * 1. Batch-based processing for high performance
+ * 2. Full backpressure control (pause/resume/abort)
+ * 3. Direct stats access through controller
+ * 4. Zero-copy when possible (WASM-parsed records preferred)
+ */
+
+/**
+ * Unified input type - works in both Node.js and Browser
+ */
+type StreamInput = string | Uint8Array | ArrayBuffer | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array> | Blob | NodeReadableCompat;
+/**
+ * Minimal interface for Node.js Readable stream compatibility
+ * We use duck-typing to avoid importing node:stream in browser builds
+ */
+interface NodeReadableCompat {
+    read?: () => unknown;
+    on?: (event: string, listener: (...args: unknown[]) => void) => unknown;
+    [Symbol.asyncIterator]?: () => AsyncIterator<unknown>;
+}
+/**
+ * Options for stream processing
+ */
+interface StreamOptions extends Omit<ConvertBuddyOptions, 'onProgress'> {
+    /**
+     * Called with batches of parsed records. If async, backpressure is automatically applied.
+     * Return `false` to pause processing (call controller.resume() to continue).
+     *
+     * @param records - Array of records (batch size controlled by recordBatchSize)
+     * @param stats - Current conversion statistics
+     */
+    onRecords?: (records: unknown[], stats: Stats) => void | boolean | Promise<void | boolean>;
+    /**
+     * Called with raw output bytes before parsing into records.
+     * Useful for writing directly to a file/stream while also processing records.
+     */
+    onData?: (bytes: Uint8Array) => void | Promise<void>;
+    /**
+     * Called periodically with progress stats.
+     * Frequency controlled by `progressIntervalRecords`.
+     */
+    onProgress?: (stats: Stats, recordCount: number) => void;
+    /**
+     * Trigger onProgress callback every N records. Default: 1000
+     */
+    progressIntervalRecords?: number;
+    /**
+     * Number of records per batch when using onRecords callback or iterator.
+     * Lower = more responsive, Higher = better throughput
+     * Default: 100
+     */
+    recordBatchSize?: number;
+}
+/**
+ * Stream controller returned by ConvertBuddy.stream()
+ * Provides pause/resume/abort controls and stats access
+ */
+interface StreamController {
+    /** Pause the stream processing */
+    pause(): void;
+    /** Resume the stream processing */
+    resume(): void;
+    /** Abort the stream processing */
+    abort(): void;
+    /** Get current statistics */
+    stats(): Stats | null;
+    /** Get current record count */
+    recordCount: number;
+    /** Check if currently paused */
+    isPaused: boolean;
+    /** Check if aborted */
+    isAborted: boolean;
+    /** Async iterator over record batches */
+    [Symbol.asyncIterator](): AsyncIterator<unknown[]>;
+}
+/**
+ * Result from processing a stream
+ */
+interface StreamResult {
+    stats: Stats;
+    recordCount: number;
+    aborted: boolean;
+}
+/**
+ * Process a stream with callbacks
+ * Returns controller for pause/resume/stats access
+ *
+ * @example
+ * ```ts
+ * const result = await processStream(file, {
+ *   inputFormat: 'csv',
+ *   outputFormat: 'json',
+ *   onRecords: (records, stats) => {
+ *     console.log(`Batch of ${records.length} records`);
+ *     console.log(`Throughput: ${stats.throughputMbPerSec} MB/s`);
+ *   },
+ * });
+ * console.log('Total records:', result.recordCount);
+ * ```
+ */
+declare function processStream(input: StreamInput, options: StreamOptions): Promise<StreamResult>;
+/**
+ * Create a stream controller for manual control
+ *
+ * @example
+ * ```ts
+ * const controller = createStreamController(file, {
+ *   inputFormat: 'csv',
+ *   outputFormat: 'json',
+ * });
+ *
+ * // Process with full control
+ * for await (const batch of controller) {
+ *   console.log(`Processing ${batch.length} records`);
+ *   console.log('Stats:', controller.stats());
+ *
+ *   if (needsSlowdown) {
+ *     controller.pause();
+ *     await sleep(1000);
+ *     controller.resume();
+ *   }
+ * }
+ * ```
+ */
+declare function createStreamController(input: StreamInput, options: StreamOptions): StreamController;
+/**
+ * Helper: Create an async iterator over record batches
+ *
+ * @example
+ * ```ts
+ * for await (const batch of streamRecords(file, {
+ *   inputFormat: 'csv',
+ *   outputFormat: 'json',
+ *   recordBatchSize: 50, // 50 records per batch
+ * })) {
+ *   await Promise.all(batch.map(r => saveRecord(r)));
+ * }
+ * ```
+ */
+declare function streamRecords(input: StreamInput, options: StreamOptions): AsyncIterableIterator<unknown[]>;
+
+type Format = "csv" | "ndjson" | "json" | "xml";
+type DetectInput = Uint8Array | ArrayBuffer | string | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
+type CsvDetection = {
+    delimiter: string;
+    fields: string[];
+};
+type XmlDetection = {
+    elements: string[];
+    recordElement?: string;
+};
+type JsonDetection = {
+    fields: string[];
+};
+type NdjsonDetection = {
+    fields: string[];
+};
+type StructureDetection = {
+    format: Format;
+    fields: string[];
+    delimiter?: string;
+    recordElement?: string;
+};
+type DetectOptions = {
+    maxBytes?: number;
+    debug?: boolean;
+};
+type ProgressCallback = (stats: Stats) => void;
+type ConvertBuddyOptions = {
+    debug?: boolean;
+    profile?: boolean;
+    inputFormat?: Format | "auto";
+    outputFormat?: Format;
+    chunkTargetBytes?: number;
+    parallelism?: number;
+    maxMemoryMB?: number;
+    csvConfig?: CsvConfig;
+    xmlConfig?: XmlConfig;
+    transform?: TransformConfig;
+    onProgress?: ProgressCallback;
+    progressIntervalBytes?: number;
+};
+type ConvertOptions = {
+    inputFormat?: Format | "auto";
+    outputFormat: Format;
+    csvConfig?: CsvConfig;
+    xmlConfig?: XmlConfig;
+    transform?: TransformConfig;
+    onProgress?: ProgressCallback;
+};
+type CsvConfig = {
+    delimiter?: string;
+    quote?: string;
+    hasHeaders?: boolean;
+    trimWhitespace?: boolean;
+};
+type XmlConfig = {
+    recordElement?: string;
+    trimText?: boolean;
+    includeAttributes?: boolean;
+    expandEntities?: boolean;
+};
+type TransformMode = "replace" | "augment";
+type Coerce = {
+    type: "string";
+} | {
+    type: "i64";
+} | {
+    type: "f64";
+} | {
+    type: "bool";
+} | {
+    type: "timestamp_ms";
+    format?: "iso8601" | "unix_ms" | "unix_s";
+};
+type FieldMap = {
+    targetFieldName: string;
+    originFieldName?: string;
+    required?: boolean;
+    defaultValue?: string | number | boolean | null;
+    coerce?: Coerce;
+    compute?: string;
+};
+type TransformConfig = {
+    mode?: TransformMode;
+    fields: FieldMap[];
+    onMissingField?: "error" | "null" | "drop";
+    onMissingRequired?: "error" | "abort";
+    onCoerceError?: "error" | "null" | "dropRecord";
+};
+type Stats = {
+    bytesIn: number;
+    bytesOut: number;
+    chunksIn: number;
+    recordsProcessed: number;
+    parseTimeMs: number;
+    transformTimeMs: number;
+    writeTimeMs: number;
+    maxBufferSize: number;
+    currentPartialSize: number;
+    throughputMbPerSec: number;
+};
+declare class ConvertBuddy {
+    private converter;
+    private debug;
+    private profile;
+    private aborted;
+    private paused;
+    private onProgress?;
+    private progressIntervalBytes;
+    private lastProgressBytes;
+    private globalConfig;
+    private initialized;
+    simd: boolean;
+    /**
+     * Create a new ConvertBuddy instance with global configuration.
+     * This is useful when you want to set memory limits, debug mode, or other global settings.
+     *
+     * @example
+     * const buddy = new ConvertBuddy({ maxMemoryMB: 512, debug: true });
+     * const result = await buddy.convert(input, { outputFormat: "json" });
+     */
+    constructor(opts?: ConvertBuddyOptions);
+    /**
+     * Convert input (string, Buffer, File, URL, etc.) to the desired output format.
+     * This is the main method for the new simplified API.
+     *
+     * @example
+     * // Auto-detect everything
+     * const buddy = new ConvertBuddy();
+     * const result = await buddy.convert("https://example.com/data.csv", { outputFormat: "json" });
+     *
+     * @example
+     * // With configuration
+     * const buddy = new ConvertBuddy({ maxMemoryMB: 512 });
+     * const result = await buddy.convert(file, { inputFormat: "csv", outputFormat: "json" });
+     */
+    convert(input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>, opts: ConvertOptions): Promise<Uint8Array>;
+    /**
+     * Stream conversion with full control (pause/resume/abort/stats).
+     * Returns a controller that implements AsyncIterator for batch processing.
+     *
+     * @example
+     * // Process in batches
+     * const controller = cb.stream(file, { outputFormat: 'json', recordBatchSize: 100 });
+     * for await (const batch of controller) {
+     *   await processBatch(batch);
+     *   console.log('Stats:', controller.stats());
+     * }
+     *
+     * @example
+     * // With callbacks
+     * const controller = cb.stream(file, {
+     *   outputFormat: 'json',
+     *   onRecords: (records, stats) => {
+     *     console.log(`Got ${records.length} records`);
+     *   }
+     * });
+     */
+    stream(input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>, opts?: ConvertOptions & {
+        onRecords?: (records: unknown[], stats: Stats) => void | boolean | Promise<void | boolean>;
+        onData?: (bytes: Uint8Array) => void | Promise<void>;
+        onProgress?: (stats: Stats, recordCount: number) => void;
+        progressIntervalRecords?: number;
+        recordBatchSize?: number;
+    }): StreamController;
+    private convertFromUrl;
+    private convertFromString;
+    private convertFromBuffer;
+    private convertFromBufferParallel;
+    private convertUsingNodejsThreadPool;
+    private convertUsingWasmThreadPool;
+    private convertUsingJsParallelism;
+    private splitIntoChunks;
+    private convertFromFile;
+    private convertFromBlob;
+    private convertFromStream;
+    /**
+     * Legacy create method for backward compatibility.
+     * Prefer using the constructor: new ConvertBuddy(opts)
+     */
+    static create(opts?: ConvertBuddyOptions): Promise<ConvertBuddy>;
+    push(chunk: Uint8Array): Uint8Array;
+    /**
+     * Push a chunk and optionally get pre-parsed records.
+     * This is more efficient than parsing the output yourself.
+     *
+     * @param chunk - Input chunk to process
+     * @param includeRecords - If true, returns { output, records }, otherwise just output bytes
+     * @returns Either Uint8Array or { output: Uint8Array, records: any[] }
+     */
+    pushWithRecords(chunk: Uint8Array, includeRecords?: boolean): Uint8Array | {
+        output: Uint8Array;
+        records: any[];
+    };
+    finish(): Uint8Array;
+    stats(): Stats;
+    abort(): void;
+    pause(): void;
+    resume(): void;
+    isAborted(): boolean;
+    isPaused(): boolean;
+}
+declare function detectFormat(input: DetectInput, opts?: DetectOptions): Promise<Format | "unknown">;
+declare function detectStructure(input: DetectInput, formatHint?: Format, opts?: DetectOptions): Promise<StructureDetection | null>;
+declare function detectCsvFieldsAndDelimiter(input: DetectInput, opts?: DetectOptions): Promise<CsvDetection | null>;
+declare function detectXmlElements(input: DetectInput, opts?: DetectOptions): Promise<XmlDetection | null>;
+declare function autoDetectConfig(input: DetectInput, opts?: DetectOptions): Promise<{
+    format: Format | "unknown";
+    csvConfig?: CsvConfig;
+    xmlConfig?: XmlConfig;
+}>;
+declare class ConvertBuddyTransformStream extends TransformStream<Uint8Array, Uint8Array> {
+    constructor(opts?: ConvertBuddyOptions);
+}
+declare function convert(input: Uint8Array | string, opts?: ConvertBuddyOptions): Promise<Uint8Array>;
+declare function convertToString(input: Uint8Array | string, opts?: ConvertBuddyOptions): Promise<string>;
+/**
+ * Ultra-simple standalone convert function with auto-detection.
+ * Accepts any input type (URL, File, Buffer, string, stream) and automatically detects format.
+ *
+ * @example
+ * // From URL
+ * import { convertAny } from "convert-buddy-js";
+ * const result = await convertAny("https://example.com/data.csv", { outputFormat: "json" });
+ *
+ * @example
+ * // From File (browser)
+ * const file = fileInput.files[0];
+ * const result = await convertAny(file, { outputFormat: "ndjson" });
+ *
+ * @example
+ * // From string data
+ * const result = await convertAny('{"name":"Ada"}', { outputFormat: "csv" });
+ */
+declare function convertAny(input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>, opts: ConvertOptions): Promise<Uint8Array>;
+/**
+ * Ultra-simple standalone convert function that returns a string.
+ * Same as convertAny but decodes the output to a string.
+ *
+ * @example
+ * import { convertAnyToString } from "convert-buddy-js";
+ * const json = await convertAnyToString("https://example.com/data.csv", { outputFormat: "json" });
+ * console.log(JSON.parse(json));
+ */
+declare function convertAnyToString(input: string | Uint8Array | File | Blob | ReadableStream<Uint8Array>, opts: ConvertOptions): Promise<string>;
+/**
+ * Get MIME type for a given format
+ *
+ * @example
+ * const mimeType = getMimeType("json"); // "application/json"
+ */
+declare function getMimeType(format: Format): string;
+/**
+ * Get file extension for a given format (without the dot)
+ *
+ * @example
+ * const ext = getExtension("json"); // "json"
+ */
+declare function getExtension(format: Format): string;
+/**
+ * Get suggested filename for a converted file
+ *
+ * @param originalName - Original filename
+ * @param outputFormat - Target format
+ * @param includeTimestamp - Whether to include a timestamp (default: false)
+ *
+ * @example
+ * const name = getSuggestedFilename("data.csv", "json"); // "data.json"
+ * const name = getSuggestedFilename("data.csv", "json", true); // "data_converted_1234567890.json"
+ */
+declare function getSuggestedFilename(originalName: string, outputFormat: Format, includeTimestamp?: boolean): string;
+/**
+ * Get File System Access API file type configuration for showSaveFilePicker
+ *
+ * @example
+ * const types = getFileTypeConfig("json");
+ * const handle = await showSaveFilePicker({ types });
+ */
+declare function getFileTypeConfig(format: Format): Array<{
+    description: string;
+    accept: Record<string, string[]>;
+}>;
+/**
+ * Check if WASM threading is supported in the current environment
+ * @returns true if SharedArrayBuffer and Atomics are available (required for WASM threads)
+ */
+declare function isWasmThreadingSupported(): boolean;
+/**
+ * Get the optimal number of worker threads based on CPU cores and WASM capabilities
+ * @returns Recommended thread count for optimal performance
+ */
+declare function getOptimalThreadCount(): number;
+/**
+ * Get current threading capabilities and configuration
+ * @returns Object with threading information
+ */
+declare function getThreadingInfo(): {
+    wasmThreadingSupported: boolean;
+    customThreadPoolAvailable: boolean;
+    nodejsWasmThreading: boolean;
+    recommendedThreads: number;
+    currentThreads: number;
+    approach: string;
+};
+/**
+ * Backward compatibility alias for ConvertBuddy
+ * @deprecated Use ConvertBuddy instead
+ */
+declare const Converter: typeof ConvertBuddy;
+
+export { type Coerce, ConvertBuddy, type ConvertBuddyOptions, ConvertBuddyTransformStream, type ConvertOptions, Converter, type CsvConfig, type CsvDetection, type DetectInput, type DetectOptions, type FieldMap, type Format, type JsonDetection, type NdjsonDetection, type ProgressCallback, type Stats, type StreamController, type StreamInput, type StreamOptions, type StreamResult, type StructureDetection, type TransformConfig, type TransformMode, type XmlConfig, type XmlDetection, autoDetectConfig, convert, convertAny, convertAnyToString, convertToString, createStreamController, detectCsvFieldsAndDelimiter, detectFormat, detectStructure, detectXmlElements, getExtension, getFileTypeConfig, getMimeType, getOptimalThreadCount, getSuggestedFilename, getThreadingInfo, isWasmThreadingSupported, processStream, streamRecords };

package/dist/index.js

@@ -157,6 +157,35 @@ class ConvertBuddy {
       throw new Error("Unsupported input type");
     }
   }
+  /**
+   * Stream conversion with full control (pause/resume/abort/stats).
+   * Returns a controller that implements AsyncIterator for batch processing.
+   * 
+   * @example
+   * // Process in batches
+   * const controller = cb.stream(file, { outputFormat: 'json', recordBatchSize: 100 });
+   * for await (const batch of controller) {
+   *   await processBatch(batch);
+   *   console.log('Stats:', controller.stats());
+   * }
+   * 
+   * @example
+   * // With callbacks
+   * const controller = cb.stream(file, {
+   *   outputFormat: 'json',
+   *   onRecords: (records, stats) => {
+   *     console.log(`Got ${records.length} records`);
+   *   }
+   * });
+   */
+  stream(input, opts = {}) {
+    const mergedOpts = {
+      ...this.globalConfig,
+      ...opts,
+      inputFormat: opts.inputFormat || this.globalConfig.inputFormat || "auto"
+    };
+    return __createStreamController(input, mergedOpts);
+  }
   async convertFromUrl(url, opts) {
     const response = await fetch(url);
     if (!response.ok) {
@@ -998,6 +1027,9 @@ function getThreadingInfo() {
   };
 }
 const Converter = ConvertBuddy;
+import { createStreamController as _createStreamController } from "./unified-stream.js";
+import { processStream, streamRecords } from "./unified-stream.js";
+const __createStreamController = _createStreamController;
 export {
   ConvertBuddy,
   ConvertBuddyTransformStream,
@@ -1007,6 +1039,7 @@ export {
   convertAny,
   convertAnyToString,
   convertToString,
+  _createStreamController as createStreamController,
   detectCsvFieldsAndDelimiter,
   detectFormat,
   detectStructure,
@@ -1017,6 +1050,8 @@ export {
   getOptimalThreadCount,
   getSuggestedFilename,
   getThreadingInfo,
-  isWasmThreadingSupported
+  isWasmThreadingSupported,
+  processStream,
+  streamRecords
 };
 //# sourceMappingURL=index.js.map