@loaders.gl/parquet 4.4.5 → 5.0.0-alpha.2

package/dist/lib/sources/parquet-range-file.js

@@ -0,0 +1,261 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { RangeRequestScheduler } from '@loaders.gl/loader-utils';
+/** Strict HTTP range-backed file with Parquet object-version validation. */
+export class ParquetRangeFile {
+    /** URL used as the file handle. */
+    handle;
+    /** URL of the remote Parquet object. */
+    url;
+    /** Fetch implementation inherited from source loader options. */
+    fetch;
+    /** Headers inherited from source loader options. */
+    headers;
+    /** Source telemetry callback invoked after transport and cache operations. */
+    onTelemetry;
+    /** Scheduler used to coalesce later row-group reads. */
+    scheduler;
+    /** Aborts all active requests when the file is closed. */
+    closeController = new AbortController();
+    /** Exact ranges already loaded during initialization. */
+    cache = new Map();
+    /** Remote object byte length discovered from `Content-Range`. */
+    fileByteLength = 0;
+    /** Object validators captured by the opening range request. */
+    version = {};
+    /** Whether `close()` has been called. */
+    closed = false;
+    /** Creates an unopened remote Parquet file. Use `open()` before reading it. */
+    constructor(url, options) {
+        this.handle = url;
+        this.url = url;
+        this.fetch = options.fetch;
+        this.headers = options.headers;
+        this.onTelemetry = options.onTelemetry;
+        this.scheduler =
+            options.rangeRequests?.scheduler ||
+                new RangeRequestScheduler({
+                    batchDelayMs: options.rangeRequests?.batchDelayMs ?? 0,
+                    maxGapBytes: options.rangeRequests?.maxGapBytes,
+                    rangeExpansionBytes: options.rangeRequests?.rangeExpansionBytes,
+                    maxMergedBytes: options.rangeRequests?.maxMergedBytes,
+                    stats: options.rangeRequests?.stats,
+                    onEvent: options.rangeRequests?.onEvent
+                });
+    }
+    /** Total remote object byte length after `open()`. */
+    get size() {
+        return this.fileByteLength;
+    }
+    /** Total remote object byte length as a bigint after `open()`. */
+    get bigsize() {
+        return BigInt(this.fileByteLength);
+    }
+    /** Immutable copy of the HTTP validators captured when the object was opened. */
+    get objectVersion() {
+        return { ...this.version };
+    }
+    /** Opens the object with a four-byte range probe and caches the Parquet header. */
+    async open(signal) {
+        this.assertOpen();
+        const result = await this.fetchExactRange(0, 4, signal, false);
+        this.fileByteLength = result.contentRange.total;
+        this.version = getObjectVersion(result.response.headers);
+        this.cache.set(getRangeKey(0, 4), result.arrayBuffer);
+        return this;
+    }
+    /** Reads an exact byte range without downloading the complete object. */
+    async read(start = 0, length = this.size - Number(start), signal) {
+        this.assertOpen();
+        const offset = Number(start);
+        assertValidRange(offset, length, this.size);
+        if (length === 0) {
+            return new ArrayBuffer(0);
+        }
+        const cached = this.cache.get(getRangeKey(offset, length));
+        if (cached) {
+            this.onTelemetry?.({ type: 'cache-hit', cacheHits: 1 });
+            return cached.slice(0);
+        }
+        const abortContext = createCombinedAbortSignal(signal, this.closeController.signal);
+        try {
+            return await this.scheduler.scheduleRequest({
+                sourceId: getVersionedSourceId(this.url, this.version),
+                offset,
+                length,
+                signal: abortContext.signal,
+                fetchRange: async (transportOffset, transportLength, transportSignal) => {
+                    const result = await this.fetchExactRange(transportOffset, transportLength, transportSignal, true);
+                    return {
+                        arrayBuffer: result.arrayBuffer,
+                        status: result.response.status,
+                        transportBytes: result.arrayBuffer.byteLength
+                    };
+                }
+            });
+        }
+        finally {
+            abortContext.dispose();
+        }
+    }
+    /** Returns file length information without another HTTP request. */
+    async stat() {
+        this.assertOpen();
+        return { size: this.size, bigsize: this.bigsize, isDirectory: false };
+    }
+    /** Aborts active requests and prevents future reads. */
+    async close() {
+        if (!this.closed) {
+            this.closed = true;
+            this.closeController.abort();
+            this.cache.clear();
+        }
+    }
+    /** Fetches and validates one exact HTTP byte range. */
+    async fetchExactRange(offset, length, signal, validateVersion) {
+        const abortContext = createCombinedAbortSignal(signal, this.closeController.signal);
+        const startTime = getCurrentTime();
+        try {
+            const response = await this.fetch(this.url, {
+                headers: createRangeHeaders(this.headers, offset, length, validateVersion && this.version),
+                signal: abortContext.signal
+            });
+            if (response.status === 412) {
+                throw new Error('Parquet object changed while it was being read');
+            }
+            if (response.status !== 206) {
+                await response.body?.cancel().catch(() => { });
+                throw new Error(`ParquetSource requires HTTP byte ranges (expected 206, received ${response.status})`);
+            }
+            const contentRange = parseContentRange(response.headers.get('Content-Range'));
+            if (contentRange.start !== offset ||
+                contentRange.end !== offset + length - 1 ||
+                (this.fileByteLength > 0 && contentRange.total !== this.fileByteLength)) {
+                await response.body?.cancel().catch(() => { });
+                throw new Error('Parquet range response does not match the requested object range');
+            }
+            if (validateVersion) {
+                assertObjectVersion(this.version, getObjectVersion(response.headers));
+            }
+            const arrayBuffer = await response.arrayBuffer();
+            if (arrayBuffer.byteLength !== length) {
+                throw new Error(`Parquet range response returned ${arrayBuffer.byteLength} bytes; expected ${length}`);
+            }
+            this.onTelemetry?.({
+                type: 'range-request',
+                rangeRequestCount: 1,
+                requestedBytes: length,
+                downloadedBytes: arrayBuffer.byteLength,
+                networkDurationMs: getCurrentTime() - startTime
+            });
+            return { response, arrayBuffer, contentRange };
+        }
+        catch (error) {
+            this.onTelemetry?.({
+                type: 'range-request',
+                rangeRequestCount: 1,
+                requestedBytes: length,
+                networkDurationMs: getCurrentTime() - startTime,
+                failedRangeRequestCount: 1,
+                abortedRangeRequestCount: abortContext.signal.aborted || isAbortError(error) ? 1 : undefined,
+                error
+            });
+            throw error;
+        }
+        finally {
+            abortContext.dispose();
+        }
+    }
+    /** Throws when the file has already been closed. */
+    assertOpen() {
+        if (this.closed) {
+            throw new Error('Parquet source is closed');
+        }
+    }
+}
+/** Returns a monotonic timestamp when available and falls back to wall-clock time. */
+function getCurrentTime() {
+    return globalThis.performance?.now() ?? Date.now();
+}
+/** Returns true for DOM and cross-runtime abort errors. */
+function isAbortError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+/** Validates a requested range against the known object byte length. */
+function assertValidRange(offset, length, fileByteLength) {
+    if (!Number.isSafeInteger(offset) || !Number.isSafeInteger(length) || offset < 0 || length < 0) {
+        throw new Error('Parquet byte range must use non-negative safe integers');
+    }
+    if (offset + length > fileByteLength) {
+        throw new Error('Parquet byte range exceeds the object length');
+    }
+}
+/** Creates request headers for one byte range and optional object precondition. */
+function createRangeHeaders(defaultHeaders, offset, length, version) {
+    const headers = new Headers(defaultHeaders);
+    headers.set('Range', `bytes=${offset}-${offset + length - 1}`);
+    if (version && version.etag && !version.etag.startsWith('W/')) {
+        headers.set('If-Match', version.etag);
+    }
+    else if (version && version.lastModified) {
+        headers.set('If-Unmodified-Since', version.lastModified);
+    }
+    return headers;
+}
+/** Parses a satisfied single-range `Content-Range` header. */
+function parseContentRange(value) {
+    const match = value?.match(/^bytes (\d+)-(\d+)\/(\d+)$/);
+    if (!match) {
+        throw new Error(`Invalid Parquet Content-Range header: ${value}`);
+    }
+    return { start: Number(match[1]), end: Number(match[2]), total: Number(match[3]) };
+}
+/** Reads supported object validators from response headers. */
+function getObjectVersion(headers) {
+    const etag = headers.get('ETag') || undefined;
+    const lastModified = headers.get('Last-Modified') || undefined;
+    return { etag, lastModified };
+}
+/** Rejects a response that identifies a different remote object version. */
+function assertObjectVersion(expected, actual) {
+    if (expected.etag && actual.etag && expected.etag !== actual.etag) {
+        throw new Error('Parquet object ETag changed while it was being read');
+    }
+    if (!expected.etag &&
+        expected.lastModified &&
+        actual.lastModified &&
+        expected.lastModified !== actual.lastModified) {
+        throw new Error('Parquet object Last-Modified changed while it was being read');
+    }
+}
+/** Creates a cache key for one exact range. */
+function getRangeKey(offset, length) {
+    return `${offset}:${length}`;
+}
+/** Creates a scheduler identity that isolates object versions. */
+function getVersionedSourceId(url, version) {
+    return `${url}#${version.etag || version.lastModified || 'unversioned'}`;
+}
+/** Combines two abort signals and returns cleanup for installed listeners. */
+function createCombinedAbortSignal(firstSignal, secondSignal) {
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    const signals = [firstSignal, secondSignal].filter(Boolean);
+    for (const signal of signals) {
+        if (signal.aborted) {
+            controller.abort();
+            break;
+        }
+        signal.addEventListener('abort', abort, { once: true });
+    }
+    return {
+        signal: controller.signal,
+        dispose: () => {
+            for (const signal of signals) {
+                signal.removeEventListener('abort', abort);
+            }
+        }
+    };
+}
+//# sourceMappingURL=parquet-range-file.js.map

package/dist/lib/sources/parquet-range-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet-range-file.js","sourceRoot":"","sources":["../../../src/lib/sources/parquet-range-file.ts"],"names":[],"mappings":"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"}

package/dist/lib/sources/single-batch-queue.d.ts

@@ -0,0 +1,24 @@
+/** One-slot asynchronous queue that applies backpressure between a producer and ordered output. */
+export declare class SingleBatchQueue<Value> implements AsyncIterable<Value> {
+    /** Buffered batch, limited to one value. */
+    private value;
+    /** Whether the producer completed successfully. */
+    private finished;
+    /** Producer failure rethrown by the consumer. */
+    private error;
+    /** Wakes a consumer waiting for a value. */
+    private wakeConsumer;
+    /** Wakes a producer after its buffered value is consumed. */
+    private wakeProducer;
+    /** Buffers one value and waits until it has been consumed. */
+    push(value: Value, signal: AbortSignal): Promise<void>;
+    /** Marks the queue complete and wakes its consumer. */
+    finish(): void;
+    /** Stores a producer error and wakes its consumer. */
+    fail(error: unknown): void;
+    /** Returns the ordered asynchronous batch iterator. */
+    [Symbol.asyncIterator](): AsyncIterator<Value>;
+    /** Waits for a producer or consumer queue transition and supports read cancellation. */
+    private waitForWakeup;
+}
+//# sourceMappingURL=single-batch-queue.d.ts.map

package/dist/lib/sources/single-batch-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-batch-queue.d.ts","sourceRoot":"","sources":["../../../src/lib/sources/single-batch-queue.ts"],"names":[],"mappings":"AAIA,mGAAmG;AACnG,qBAAa,gBAAgB,CAAC,KAAK,CAAE,YAAW,aAAa,CAAC,KAAK,CAAC;IAClE,4CAA4C;IAC5C,OAAO,CAAC,KAAK,CAAoB;IACjC,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAS;IACzB,iDAAiD;IACjD,OAAO,CAAC,KAAK,CAAU;IACvB,4CAA4C;IAC5C,OAAO,CAAC,YAAY,CAA6B;IACjD,6DAA6D;IAC7D,OAAO,CAAC,YAAY,CAA6B;IAEjD,8DAA8D;IACxD,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D,uDAAuD;IACvD,MAAM,IAAI,IAAI;IAMd,sDAAsD;IACtD,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAO1B,uDAAuD;IAChD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC;IAoBrD,wFAAwF;IACxF,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/lib/sources/single-batch-queue.js

@@ -0,0 +1,91 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** One-slot asynchronous queue that applies backpressure between a producer and ordered output. */
+export class SingleBatchQueue {
+    /** Buffered batch, limited to one value. */
+    value;
+    /** Whether the producer completed successfully. */
+    finished = false;
+    /** Producer failure rethrown by the consumer. */
+    error;
+    /** Wakes a consumer waiting for a value. */
+    wakeConsumer = null;
+    /** Wakes a producer after its buffered value is consumed. */
+    wakeProducer = null;
+    /** Buffers one value and waits until it has been consumed. */
+    async push(value, signal) {
+        throwIfAborted(signal);
+        while (this.value !== undefined) {
+            await this.waitForWakeup('producer', signal);
+        }
+        this.value = value;
+        this.wakeConsumer?.();
+        this.wakeConsumer = null;
+        while (this.value !== undefined) {
+            await this.waitForWakeup('producer', signal);
+        }
+    }
+    /** Marks the queue complete and wakes its consumer. */
+    finish() {
+        this.finished = true;
+        this.wakeConsumer?.();
+        this.wakeConsumer = null;
+    }
+    /** Stores a producer error and wakes its consumer. */
+    fail(error) {
+        this.error = error;
+        this.finished = true;
+        this.wakeConsumer?.();
+        this.wakeConsumer = null;
+    }
+    /** Returns the ordered asynchronous batch iterator. */
+    async *[Symbol.asyncIterator]() {
+        while (true) {
+            if (this.value !== undefined) {
+                const value = this.value;
+                this.value = undefined;
+                this.wakeProducer?.();
+                this.wakeProducer = null;
+                yield value;
+                continue;
+            }
+            if (this.error !== undefined) {
+                throw this.error;
+            }
+            if (this.finished) {
+                return;
+            }
+            await this.waitForWakeup('consumer');
+        }
+    }
+    /** Waits for a producer or consumer queue transition and supports read cancellation. */
+    waitForWakeup(type, signal) {
+        return new Promise((resolve, reject) => {
+            const abort = () => reject(signal?.reason || new DOMException('Aborted', 'AbortError'));
+            const wakeup = () => {
+                signal?.removeEventListener('abort', abort);
+                resolve();
+            };
+            if (type === 'producer') {
+                this.wakeProducer = wakeup;
+            }
+            else {
+                this.wakeConsumer = wakeup;
+            }
+            if (signal?.aborted) {
+                abort();
+            }
+            else {
+                signal?.addEventListener('abort', abort, { once: true });
+            }
+        });
+    }
+}
+/** Throws a standard abort failure when a queued operation has been cancelled. */
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw signal.reason || new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=single-batch-queue.js.map

package/dist/lib/sources/single-batch-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-batch-queue.js","sourceRoot":"","sources":["../../../src/lib/sources/single-batch-queue.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/load-wasm-node.d.ts

@@ -0,0 +1,3 @@
+/** Loads the installed parquet-wasm binary in Node.js or defers to browser asset resolution. */
+export declare function loadNodeWasmInput(): Promise<Uint8Array | undefined>;
+//# sourceMappingURL=load-wasm-node.d.ts.map

package/dist/lib/utils/load-wasm-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-wasm-node.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/load-wasm-node.ts"],"names":[],"mappings":"AAIA,gGAAgG;AAChG,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAczE"}

package/dist/lib/utils/load-wasm-node.js

@@ -0,0 +1,23 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Loads the installed parquet-wasm binary in Node.js or defers to browser asset resolution. */
+export async function loadNodeWasmInput() {
+    if (!isNodeRuntime()) {
+        return undefined;
+    }
+    // Keep these specifiers dynamic so browser bundles do not include Node.js built-ins.
+    const nodeProtocol = 'node:';
+    const { readFile } = await import(/* @vite-ignore */ `${nodeProtocol}fs/promises`);
+    const { createRequire } = await import(/* @vite-ignore */ `${nodeProtocol}module`);
+    const { pathToFileURL } = await import(/* @vite-ignore */ `${nodeProtocol}url`);
+    const moduleUrl = typeof __filename === 'string' ? pathToFileURL(__filename).toString() : import.meta.url;
+    const require = createRequire(moduleUrl);
+    const wasmPath = require.resolve('parquet-wasm/esm/parquet_wasm_bg.wasm');
+    return await readFile(wasmPath);
+}
+/** Returns true when Node.js built-ins are available in the current runtime. */
+function isNodeRuntime() {
+    return Boolean(globalThis.process?.versions?.node);
+}
+//# sourceMappingURL=load-wasm-node.js.map

package/dist/lib/utils/load-wasm-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-wasm-node.js","sourceRoot":"","sources":["../../../src/lib/utils/load-wasm-node.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,qFAAqF;IACrF,MAAM,YAAY,GAAG,OAAO,CAAC;IAC7B,MAAM,EAAC,QAAQ,EAAC,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,GAAG,YAAY,aAAa,CAAC,CAAC;IACjF,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,GAAG,YAAY,QAAQ,CAAC,CAAC;IACjF,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC;IAC9E,MAAM,SAAS,GACb,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1F,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC;IAC1E,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,gFAAgF;AAChF,SAAS,aAAa;IACpB,OAAO,OAAO,CAAE,UAAuD,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AACnG,CAAC"}

package/dist/lib/utils/load-wasm.d.ts

@@ -1,3 +1,3 @@
-import * as parquetWasm from 'parquet-wasm';
-export declare function loadWasm(wasmUrl?: string): Promise<typeof parquetWasm>;
+import type * as ParquetWasm from 'parquet-wasm/esm/parquet_wasm.js';
+export declare function loadWasm(wasmUrl?: ParquetWasm.InitInput | Promise<ParquetWasm.InitInput>): Promise<typeof ParquetWasm>;
 //# sourceMappingURL=load-wasm.d.ts.map

package/dist/lib/utils/load-wasm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-wasm.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/load-wasm.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAK5C,wBAAsB,QAAQ,CAAC,OAAO,GAAE,MAAyB,+BAUhE"}
+{"version":3,"file":"load-wasm.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/load-wasm.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,WAAW,MAAM,kCAAkC,CAAC;AAKrE,wBAAsB,QAAQ,CAC5B,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,GAC/D,OAAO,CAAC,OAAO,WAAW,CAAC,CAa7B"}

package/dist/lib/utils/load-wasm.js

@@ -1,20 +1,36 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-// eslint-disable-next-line import/default
-import initWasm from 'parquet-wasm';
-import * as parquetWasm from 'parquet-wasm';
-import { PARQUET_WASM_URL } from "../constants.js";
+import { loadNodeWasmInput } from "./load-wasm-node.js";
 let initializePromise;
-export async function loadWasm(wasmUrl = PARQUET_WASM_URL) {
-    if (!initializePromise && typeof initWasm === 'function') {
-        if (!wasmUrl) {
-            throw new Error('ParquetLoader: No wasmUrl provided');
-        }
-        // @ts-ignore
-        initializePromise = initWasm(wasmUrl);
+export async function loadWasm(wasmUrl) {
+    if (!initializePromise) {
+        const nextInitializePromise = loadAndInitializeWasm(wasmUrl);
+        const cachedInitializePromise = nextInitializePromise.catch(error => {
+            if (initializePromise === cachedInitializePromise) {
+                initializePromise = undefined;
+            }
+            throw error;
+        });
+        initializePromise = cachedInitializePromise;
+    }
+    return await initializePromise;
+}
+async function loadAndInitializeWasm(wasmUrl) {
+    const parquetWasm = await import('parquet-wasm/esm/parquet_wasm.js');
+    const moduleOrPath = wasmUrl ? await wasmUrl : await loadDefaultWasmInput();
+    if (moduleOrPath) {
+        await parquetWasm.default({ module_or_path: moduleOrPath });
+    }
+    else {
+        // parquet-wasm resolves its sibling asset with new URL(..., import.meta.url), which allows
+        // browser bundlers to copy and fingerprint the WASM file without a network CDN default.
+        await parquetWasm.default();
     }
-    await initializePromise;
     return parquetWasm;
 }
+/** Loads a local Node asset or defers to parquet-wasm's browser import.meta resolver. */
+async function loadDefaultWasmInput() {
+    return await loadNodeWasmInput();
+}
 //# sourceMappingURL=load-wasm.js.map

package/dist/lib/utils/load-wasm.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-wasm.js","sourceRoot":"","sources":["../../../src/lib/utils/load-wasm.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,0CAA0C;AAC1C,OAAO,QAAQ,MAAM,cAAc,CAAC;AACpC,OAAO,KAAK,WAAW,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAC,gBAAgB,EAAC,wBAAqB;AAE9C,IAAI,iBAAsB,CAAC;AAE3B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB,gBAAgB;IAC/D,IAAI,CAAC,iBAAiB,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACzD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,aAAa;QACb,iBAAiB,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,iBAAiB,CAAC;IACxB,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"load-wasm.js","sourceRoot":"","sources":["../../../src/lib/utils/load-wasm.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,iBAAiB,EAAC,4BAAyB;AAEnD,IAAI,iBAA0D,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAgE;IAEhE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,uBAAuB,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAClE,IAAI,iBAAiB,KAAK,uBAAuB,EAAE,CAAC;gBAClD,iBAAiB,GAAG,SAAS,CAAC;YAChC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,iBAAiB,GAAG,uBAAuB,CAAC;IAC9C,CAAC;IAED,OAAO,MAAM,iBAAiB,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,OAAgE;IAEhE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,MAAM,oBAAoB,EAAE,CAAC;IAC5E,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,WAAW,CAAC,OAAO,CAAC,EAAC,cAAc,EAAE,YAAY,EAAC,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,2FAA2F;QAC3F,wFAAwF;QACxF,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,yFAAyF;AACzF,KAAK,UAAU,oBAAoB;IACjC,OAAO,MAAM,iBAAiB,EAAE,CAAC;AACnC,CAAC"}

package/dist/lib/utils/make-stream-iterator.d.ts

@@ -1,6 +1,8 @@
 import type { Readable } from 'stream';
 export type StreamIteratorOptions = {
     _streamReadAhead?: boolean;
+    /** Cancels the active stream read and rejects iteration with the signal reason. */
+    signal?: AbortSignal;
 };
 /**
  * Returns an async iterable that reads from a stream (works in both Node.js and browsers)

package/dist/lib/utils/make-stream-iterator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make-stream-iterator.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/make-stream-iterator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAGrC,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,QAAQ,EACpC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,CAAC,CAAC,CAIlB"}
+{"version":3,"file":"make-stream-iterator.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/make-stream-iterator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAGrC,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mFAAmF;IACnF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,QAAQ,EACpC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAAC,CAAC,CAAC,CAIlB"}