compress-utils 0.7.0-rc.1

package/dist/core/dispatch.js

@@ -0,0 +1,370 @@
+/**
+ * Generic JS→C ABI dispatcher.
+ *
+ * Per-algorithm modules (algorithms/<algo>/index.ts) call `createBindings`
+ * with their algorithm enum + wasm URL; that factory returns the public
+ * surface (compress, decompress, streams, version, etc.) bound to a
+ * lazily-instantiated wasm module. The dispatcher itself doesn't ship in
+ * any user bundle — only the slice of it the algorithm uses, after
+ * tree-shaking.
+ */
+import { checkStatus, decodeCString, loadModule, } from "./loader.js";
+import { CompressError, Status, } from "./types.js";
+const DEFAULT_LEVEL = 5;
+const STREAM_DRAIN_CHUNK = 64 * 1024;
+/* Safety cap on drain() iterations. A correct codec returns Ok within a
+ * few iterations per write — anything past this many BUF_TOO_SMALL retries
+ * means the C side is stuck in a state where it neither emits output nor
+ * signals completion. Throw rather than spin forever. */
+const DRAIN_MAX_ITERATIONS = 1 << 16;
+/** Tracks allocations so a single try/finally can free them all. */
+class Arena {
+    exports;
+    ptrs = [];
+    constructor(exports) { this.exports = exports; }
+    alloc(bytes, algoName) {
+        // Empty-input compress/decompress is a valid edge case (codecs
+        // produce a non-empty header/footer for an empty payload). Bump
+        // zero-byte requests to 1 so cu_alloc returns a real pointer
+        // backing zero useful bytes — passing the resulting (ptr, 0) to
+        // the C ABI is well-defined; passing (NULL, 0) is not.
+        if (bytes === 0)
+            bytes = 1;
+        const ptr = this.exports.cu_alloc(bytes);
+        if (ptr === 0) {
+            throw new CompressError(Status.Oom, algoName, `cu_alloc(${bytes}) returned NULL`);
+        }
+        this.ptrs.push(ptr);
+        return ptr;
+    }
+    freeAll() {
+        for (const p of this.ptrs)
+            this.exports.cu_free(p);
+        this.ptrs.length = 0;
+    }
+}
+export class Dispatcher {
+    algorithm;
+    algorithmName;
+    /** @internal */ exports;
+    constructor(exports, algorithm, algorithmName) {
+        this.exports = exports;
+        this.algorithm = algorithm;
+        this.algorithmName = algorithmName;
+        if (exports.cu_algorithm_available(algorithm) === 0) {
+            throw new CompressError(Status.UnsupportedAlgo, algorithmName, `algorithm "${algorithmName}" not compiled into this .wasm module`);
+        }
+    }
+    version() {
+        return decodeCString(this.exports.memory, this.exports.cu_version());
+    }
+    setMaxDecompressedSize(bytes) {
+        this.exports.cu_set_max_decompressed_size?.(bytes);
+    }
+    /* ---------- one-shot ---------- */
+    compress(input, opts = {}) {
+        const level = opts.level ?? DEFAULT_LEVEL;
+        const inLen = input.byteLength;
+        const bound = this.exports.cu_compress_bound(inLen, this.algorithm);
+        const arena = new Arena(this.exports);
+        try {
+            const inPtr = arena.alloc(inLen, this.algorithmName);
+            const outPtr = arena.alloc(bound, this.algorithmName);
+            const outLenPtr = arena.alloc(4, this.algorithmName);
+            this.writeBytes(inPtr, input);
+            this.writeU32(outLenPtr, bound);
+            const status = this.exports.cu_compress(this.algorithm, inPtr, inLen, outPtr, outLenPtr, level);
+            checkStatus(this.exports, status, this.algorithmName);
+            return this.readBytes(outPtr, this.readU32(outLenPtr));
+        }
+        finally {
+            arena.freeAll();
+        }
+    }
+    decompress(input, opts = {}) {
+        const inLen = input.byteLength;
+        const arena = new Arena(this.exports);
+        try {
+            const inPtr = arena.alloc(inLen, this.algorithmName);
+            this.writeBytes(inPtr, input);
+            const outSize = opts.expectedSize ?? this.tryProbeSize(arena, inPtr, inLen);
+            if (outSize === undefined) {
+                // Wire format doesn't carry size (bz2, brotli, raw deflate,
+                // raw LZ4, current xz size_hint impl). Fall through to a
+                // streaming decode so the one-shot API still works.
+                return this.decompressStreaming(input);
+            }
+            const outPtr = arena.alloc(outSize, this.algorithmName);
+            const outLenPtr = arena.alloc(4, this.algorithmName);
+            this.writeU32(outLenPtr, outSize);
+            const status = this.exports.cu_decompress(this.algorithm, inPtr, inLen, outPtr, outLenPtr);
+            checkStatus(this.exports, status, this.algorithmName);
+            return this.readBytes(outPtr, this.readU32(outLenPtr));
+        }
+        finally {
+            arena.freeAll();
+        }
+    }
+    decompressStreaming(input) {
+        const stream = this.createDecompressStream();
+        try {
+            const body = stream.write(input);
+            const tail = stream.finish();
+            if (tail.byteLength === 0)
+                return body;
+            const out = new Uint8Array(body.byteLength + tail.byteLength);
+            out.set(body, 0);
+            out.set(tail, body.byteLength);
+            return out;
+        }
+        finally {
+            stream.destroy();
+        }
+    }
+    tryProbeSize(arena, inPtr, inLen) {
+        const sizePtr = arena.alloc(4, this.algorithmName);
+        this.writeU32(sizePtr, 0);
+        const status = this.exports.cu_decompress_size_hint(this.algorithm, inPtr, inLen, sizePtr);
+        if (status === Status.Ok)
+            return this.readU32(sizePtr);
+        if (status === Status.SizeUnknown)
+            return undefined;
+        checkStatus(this.exports, status, this.algorithmName);
+        return undefined;
+    }
+    /* ---------- streaming ---------- */
+    createCompressStream(opts = {}) {
+        const level = opts.level ?? DEFAULT_LEVEL;
+        const arena = new Arena(this.exports);
+        try {
+            const streamPP = arena.alloc(4, this.algorithmName);
+            this.writeU32(streamPP, 0);
+            const status = this.exports.cu_compress_stream_create(this.algorithm, level, streamPP);
+            checkStatus(this.exports, status, this.algorithmName);
+            return new CompressStream(this, this.readU32(streamPP));
+        }
+        finally {
+            arena.freeAll();
+        }
+    }
+    createDecompressStream() {
+        const arena = new Arena(this.exports);
+        try {
+            const streamPP = arena.alloc(4, this.algorithmName);
+            this.writeU32(streamPP, 0);
+            const status = this.exports.cu_decompress_stream_create(this.algorithm, streamPP);
+            checkStatus(this.exports, status, this.algorithmName);
+            return new DecompressStream(this, this.readU32(streamPP));
+        }
+        finally {
+            arena.freeAll();
+        }
+    }
+    /* ---------- internal helpers (used by stream classes) ---------- */
+    /** @internal */ writeBytes(ptr, src) {
+        new Uint8Array(this.exports.memory.buffer, ptr, src.byteLength).set(src);
+    }
+    /** @internal */ readBytes(ptr, len) {
+        return new Uint8Array(new Uint8Array(this.exports.memory.buffer, ptr, len));
+    }
+    /** @internal */ writeU32(ptr, value) {
+        new DataView(this.exports.memory.buffer).setUint32(ptr, value, true);
+    }
+    /** @internal */ readU32(ptr) {
+        return new DataView(this.exports.memory.buffer).getUint32(ptr, true);
+    }
+    /** @internal */ newArena() { return new Arena(this.exports); }
+}
+const streamFinalizer = new FinalizationRegistry((c) => {
+    if (c.handle !== 0)
+        c.destroy(c.handle);
+});
+class StreamBase {
+    dispatcher;
+    handle;
+    finished = false;
+    cleanup;
+    constructor(dispatcher, handle, destroyFn) {
+        this.dispatcher = dispatcher;
+        this.handle = handle;
+        this.cleanup = { destroy: destroyFn, handle };
+        streamFinalizer.register(this, this.cleanup, this);
+    }
+    ensureLive() {
+        if (this.handle === 0) {
+            throw new CompressError(Status.StreamState, this.dispatcher.algorithmName, "stream has been destroyed");
+        }
+    }
+    destroy() {
+        if (this.handle !== 0) {
+            this.cleanup.destroy(this.handle);
+            this.handle = 0;
+            this.cleanup.handle = 0;
+            streamFinalizer.unregister(this);
+        }
+    }
+    /** Symbol.dispose — enables `using stream = await create*()`. */
+    [Symbol.dispose]() { this.destroy(); }
+}
+export class CompressStream extends StreamBase {
+    constructor(dispatcher, handle) {
+        super(dispatcher, handle, (h) => dispatcher.exports.cu_compress_stream_destroy(h));
+    }
+    write(chunk) {
+        this.ensureLive();
+        if (this.finished) {
+            throw new CompressError(Status.StreamFinished, this.dispatcher.algorithmName, "write after finish");
+        }
+        return drain(this.dispatcher, chunk, (inPtr, inLen, outPtr, outLenPtr) => this.dispatcher.exports.cu_compress_stream_write(this.handle, inPtr, inLen, outPtr, outLenPtr));
+    }
+    finish() {
+        this.ensureLive();
+        this.finished = true;
+        return drain(this.dispatcher, null, (_in, _len, outPtr, outLenPtr) => this.dispatcher.exports.cu_compress_stream_finish(this.handle, outPtr, outLenPtr));
+    }
+}
+export class DecompressStream extends StreamBase {
+    constructor(dispatcher, handle) {
+        super(dispatcher, handle, (h) => dispatcher.exports.cu_decompress_stream_destroy(h));
+    }
+    write(chunk) {
+        this.ensureLive();
+        return drain(this.dispatcher, chunk, (inPtr, inLen, outPtr, outLenPtr) => this.dispatcher.exports.cu_decompress_stream_write(this.handle, inPtr, inLen, outPtr, outLenPtr));
+    }
+    finish() {
+        this.ensureLive();
+        this.finished = true;
+        return drain(this.dispatcher, null, (_in, _len, outPtr, outLenPtr) => this.dispatcher.exports.cu_decompress_stream_finish(this.handle, outPtr, outLenPtr));
+    }
+}
+/**
+ * Drain protocol: repeat the call until it returns Ok with no overflow.
+ * BUF_TOO_SMALL means the stream has more output buffered; the C side
+ * remembers any unconsumed input, so on retry we pass (NULL, 0).
+ */
+function drain(dispatcher, input, call) {
+    const arena = dispatcher.newArena();
+    const chunks = [];
+    let total = 0;
+    try {
+        const inLen = input?.byteLength ?? 0;
+        const inPtr0 = inLen > 0 ? arena.alloc(inLen, dispatcher.algorithmName) : 0;
+        if (inPtr0 !== 0 && input)
+            dispatcher.writeBytes(inPtr0, input);
+        const outPtr = arena.alloc(STREAM_DRAIN_CHUNK, dispatcher.algorithmName);
+        const outLenPtr = arena.alloc(4, dispatcher.algorithmName);
+        let inPtr = inPtr0;
+        let remainingIn = inLen;
+        for (let i = 0;; i++) {
+            if (i >= DRAIN_MAX_ITERATIONS) {
+                throw new CompressError(Status.StreamState, dispatcher.algorithmName, `drain exceeded ${DRAIN_MAX_ITERATIONS} iterations without completion`);
+            }
+            dispatcher.writeU32(outLenPtr, STREAM_DRAIN_CHUNK);
+            const status = call(inPtr, remainingIn, outPtr, outLenPtr);
+            const produced = dispatcher.readU32(outLenPtr);
+            if (produced > 0) {
+                chunks.push(dispatcher.readBytes(outPtr, produced));
+                total += produced;
+            }
+            if (status === Status.Ok)
+                break;
+            if (status !== Status.BufTooSmall) {
+                checkStatus(dispatcher.exports, status, dispatcher.algorithmName);
+            }
+            inPtr = 0;
+            remainingIn = 0;
+        }
+    }
+    finally {
+        arena.freeAll();
+    }
+    if (chunks.length === 1)
+        return chunks[0];
+    const merged = new Uint8Array(total);
+    let off = 0;
+    for (const c of chunks) {
+        merged.set(c, off);
+        off += c.byteLength;
+    }
+    return merged;
+}
+export function createBindings(algorithm, name, wasmUrl, resolveWasm) {
+    let dispatcherPromise = null;
+    const getDispatcher = () => {
+        if (!dispatcherPromise) {
+            dispatcherPromise = (async () => {
+                const source = await resolveWasm(wasmUrl);
+                const exports = await loadModule(source);
+                return new Dispatcher(exports, algorithm, name);
+            })();
+        }
+        return dispatcherPromise;
+    };
+    return {
+        async compress(input, opts) {
+            return (await getDispatcher()).compress(input, opts);
+        },
+        async decompress(input, opts) {
+            return (await getDispatcher()).decompress(input, opts);
+        },
+        async createCompressStream(opts) {
+            return (await getDispatcher()).createCompressStream(opts);
+        },
+        async createDecompressStream() {
+            return (await getDispatcher()).createDecompressStream();
+        },
+        compressionStream(opts) {
+            let stream;
+            return new TransformStream({
+                async start() {
+                    stream = (await getDispatcher()).createCompressStream(opts);
+                },
+                transform(chunk, controller) {
+                    const out = stream.write(chunk);
+                    if (out.byteLength > 0)
+                        controller.enqueue(out);
+                },
+                flush(controller) {
+                    try {
+                        const tail = stream.finish();
+                        if (tail.byteLength > 0)
+                            controller.enqueue(tail);
+                    }
+                    finally {
+                        stream.destroy();
+                    }
+                },
+            });
+        },
+        decompressionStream() {
+            let stream;
+            return new TransformStream({
+                async start() {
+                    stream = (await getDispatcher()).createDecompressStream();
+                },
+                transform(chunk, controller) {
+                    const out = stream.write(chunk);
+                    if (out.byteLength > 0)
+                        controller.enqueue(out);
+                },
+                flush(controller) {
+                    try {
+                        const tail = stream.finish();
+                        if (tail.byteLength > 0)
+                            controller.enqueue(tail);
+                    }
+                    finally {
+                        stream.destroy();
+                    }
+                },
+            });
+        },
+        async version() {
+            return (await getDispatcher()).version();
+        },
+        async setMaxDecompressedSize(bytes) {
+            (await getDispatcher()).setMaxDecompressedSize(bytes);
+        },
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/core/dispatch.js.map

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

package/dist/core/loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * WASM module loader + minimal WASI reactor shim.
+ *
+ * Our .wasm modules are built as `wasm32-wasi -mexec-model=reactor`. This
+ * means they (a) export their full ABI under default names, (b) expect a
+ * `_initialize` call after instantiation, and (c) import a handful of WASI
+ * preview1 functions even though our code paths don't actually use them
+ * (libc startup pulls in a few stubs).
+ *
+ * The shim below implements just enough WASI to keep the imports resolved.
+ * Real WASI operations (fd_write, random_get) are stubbed with safe
+ * defaults — the codec paths don't hit them in practice, but if a future
+ * upstream lib starts logging to stderr we'll see "fd_write: not
+ * implemented" instead of a cryptic trap.
+ *
+ * If we ever need actual WASI (e.g. for `wasi:filesystem`), swap this for
+ * @bjorn3/browser_wasi_shim or @cloudflare/workers-types.
+ */
+import { type AlgorithmName } from "./types.js";
+export interface WasmExports {
+    readonly memory: WebAssembly.Memory;
+    readonly _initialize: () => void;
+    readonly cu_alloc: (bytes: number) => number;
+    readonly cu_free: (ptr: number) => void;
+    readonly cu_version: () => number;
+    readonly cu_algorithm_available: (algo: number) => number;
+    readonly cu_last_error: () => number;
+    readonly cu_strerror: (code: number) => number;
+    readonly cu_compress_bound: (in_len: number, algo: number) => number;
+    readonly cu_compress: (algo: number, in_ptr: number, in_len: number, out_ptr: number, out_len_ptr: number, level: number) => number;
+    readonly cu_decompress: (algo: number, in_ptr: number, in_len: number, out_ptr: number, out_len_ptr: number) => number;
+    readonly cu_decompress_size_hint: (algo: number, in_ptr: number, in_len: number, out_size_ptr: number) => number;
+    readonly cu_compress_stream_create: (algo: number, level: number, out_stream_pp: number) => number;
+    readonly cu_compress_stream_write: (stream: number, in_ptr: number, in_len: number, out_ptr: number, out_len_ptr: number) => number;
+    readonly cu_compress_stream_finish: (stream: number, out_ptr: number, out_len_ptr: number) => number;
+    readonly cu_compress_stream_destroy: (stream: number) => void;
+    readonly cu_decompress_stream_create: (algo: number, out_stream_pp: number) => number;
+    readonly cu_decompress_stream_write: (stream: number, in_ptr: number, in_len: number, out_ptr: number, out_len_ptr: number) => number;
+    readonly cu_decompress_stream_finish: (stream: number, out_ptr: number, out_len_ptr: number) => number;
+    readonly cu_decompress_stream_destroy: (stream: number) => void;
+    readonly cu_set_max_decompressed_size?: (bytes: number) => void;
+}
+export declare function loadModule(source: BufferSource | Response | PromiseLike<Response>): Promise<WasmExports>;
+export declare function decodeCString(memory: WebAssembly.Memory, ptr: number, maxLen?: number): string;
+/** Convert a non-Ok status into a thrown CompressError using the C side's message. */
+export declare function checkStatus(exports: WasmExports, status: number, algorithm: AlgorithmName): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/loader.d.ts.map

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

package/dist/core/loader.js

@@ -0,0 +1,121 @@
+/**
+ * WASM module loader + minimal WASI reactor shim.
+ *
+ * Our .wasm modules are built as `wasm32-wasi -mexec-model=reactor`. This
+ * means they (a) export their full ABI under default names, (b) expect a
+ * `_initialize` call after instantiation, and (c) import a handful of WASI
+ * preview1 functions even though our code paths don't actually use them
+ * (libc startup pulls in a few stubs).
+ *
+ * The shim below implements just enough WASI to keep the imports resolved.
+ * Real WASI operations (fd_write, random_get) are stubbed with safe
+ * defaults — the codec paths don't hit them in practice, but if a future
+ * upstream lib starts logging to stderr we'll see "fd_write: not
+ * implemented" instead of a cryptic trap.
+ *
+ * If we ever need actual WASI (e.g. for `wasi:filesystem`), swap this for
+ * @bjorn3/browser_wasi_shim or @cloudflare/workers-types.
+ */
+import { CompressError, Status } from "./types.js";
+const ERRNO_BADF = 8;
+const ERRNO_IO = 29;
+const ERRNO_NOSYS = 52;
+/* crypto.getRandomValues caps each call at 65536 bytes (per WebCrypto spec).
+ * Larger random_get requests get split. We've never seen a codec ask for
+ * more than a few bytes, but the loop is cheap insurance. */
+const CRYPTO_MAX_CHUNK = 65536;
+/* Resolved once, lazily: globalThis.crypto is present in browsers, Deno,
+ * Bun, and Node ≥19. Node 18 has it behind `node:crypto`'s webcrypto
+ * export — we don't try to load that here because our `engines.node` is
+ * ≥18 but the test matrix only covers Node 20+. Falling back to `null`
+ * makes random_get fail loudly instead of returning all-zeros. */
+const webCrypto = typeof globalThis.crypto !== "undefined" &&
+    typeof globalThis.crypto.getRandomValues === "function"
+    ? globalThis.crypto
+    : null;
+function wasiImports(getMemory) {
+    return {
+        // proc_exit: codec code paths shouldn't call this, but if libc
+        // startup hits an unrecoverable error it does. Throw so callers
+        // see a real stack instead of a silent exit.
+        proc_exit(code) {
+            throw new Error(`wasm proc_exit(${code})`);
+        },
+        // fd_write: silently swallow. zstd/etc don't log; if they did,
+        // we'd want to wire this to console.warn — but that needs us to
+        // read iovs out of linear memory, which the caller doesn't have
+        // a handle to at import-resolution time.
+        fd_write() { return ERRNO_NOSYS; },
+        fd_close() { return ERRNO_NOSYS; },
+        fd_seek() { return ERRNO_NOSYS; },
+        fd_read() { return ERRNO_NOSYS; },
+        fd_fdstat_get() { return ERRNO_NOSYS; },
+        fd_fdstat_set_flags() { return ERRNO_NOSYS; },
+        // EBADF terminates the wasi-libc preopen scan cleanly. ENOSYS
+        // makes the libc init path think the syscall is implemented but
+        // failed unexpectedly, and on some libc builds aborts.
+        fd_prestat_get() { return ERRNO_BADF; },
+        fd_prestat_dir_name() { return ERRNO_BADF; },
+        fd_filestat_get() { return ERRNO_NOSYS; },
+        path_open() { return ERRNO_NOSYS; },
+        poll_oneoff() { return ERRNO_NOSYS; },
+        sched_yield() { return 0; },
+        environ_sizes_get() { return 0; },
+        environ_get() { return 0; },
+        clock_time_get() { return ERRNO_NOSYS; },
+        // random_get: fill `len` bytes at `buf` with CSPRNG output.
+        // Fails loud (ERRNO_IO) if no crypto is available — the previous
+        // silent zero-fill was a correctness footgun for any future codec
+        // that actually seeds from entropy.
+        random_get(buf, len) {
+            if (!webCrypto)
+                return ERRNO_IO;
+            const memory = getMemory();
+            for (let off = 0; off < len; off += CRYPTO_MAX_CHUNK) {
+                const chunk = Math.min(CRYPTO_MAX_CHUNK, len - off);
+                webCrypto.getRandomValues(new Uint8Array(memory.buffer, buf + off, chunk));
+            }
+            return 0;
+        },
+    };
+}
+export async function loadModule(source) {
+    // random_get needs `instance.exports.memory`, which doesn't exist
+    // until after `WebAssembly.instantiate` returns. The closure captures
+    // a lazy accessor; the import object itself is built first.
+    let instance;
+    const imports = {
+        wasi_snapshot_preview1: wasiImports(() => instance.exports.memory),
+    };
+    if (source instanceof ArrayBuffer || ArrayBuffer.isView(source)) {
+        const { instance: inst } = await WebAssembly.instantiate(source, imports);
+        instance = inst;
+    }
+    else {
+        const { instance: inst } = await WebAssembly.instantiateStreaming(source, imports);
+        instance = inst;
+    }
+    const exports = instance.exports;
+    exports._initialize?.();
+    return exports;
+}
+export function decodeCString(memory, ptr, maxLen = 4096) {
+    if (ptr === 0)
+        return "";
+    const view = new Uint8Array(memory.buffer, ptr);
+    let end = 0;
+    while (end < maxLen && view[end] !== 0)
+        end++;
+    return new TextDecoder("utf-8").decode(view.subarray(0, end));
+}
+/** Convert a non-Ok status into a thrown CompressError using the C side's message. */
+export function checkStatus(exports, status, algorithm) {
+    if (status === Status.Ok)
+        return;
+    const lastErrPtr = exports.cu_last_error();
+    let msg = decodeCString(exports.memory, lastErrPtr);
+    if (!msg)
+        msg = decodeCString(exports.memory, exports.cu_strerror(status));
+    throw new CompressError(status, algorithm, msg || `status ${status}`);
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/loader.js.map

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

package/dist/core/resolve-browser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Browser / Deno / Bun resolver: fetch returns a Response, the loader
+ * passes it to `WebAssembly.instantiateStreaming` for concurrent
+ * download+compile.
+ *
+ * This file contains zero references to `node:*` modules, so bundlers
+ * targeting the browser never see them in the import graph — no
+ * `external: ["node:*"]` config required at the consumer.
+ */
+import type { WasmResolver } from "./dispatch.js";
+export declare const resolveWasm: WasmResolver;
+//# sourceMappingURL=resolve-browser.d.ts.map

package/dist/core/resolve-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-browser.d.ts","sourceRoot":"","sources":["../../src/core/resolve-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,eAAO,MAAM,WAAW,EAAE,YAAkC,CAAC"}

package/dist/core/resolve-browser.js

@@ -0,0 +1,11 @@
+/**
+ * Browser / Deno / Bun resolver: fetch returns a Response, the loader
+ * passes it to `WebAssembly.instantiateStreaming` for concurrent
+ * download+compile.
+ *
+ * This file contains zero references to `node:*` modules, so bundlers
+ * targeting the browser never see them in the import graph — no
+ * `external: ["node:*"]` config required at the consumer.
+ */
+export const resolveWasm = (url) => fetch(url);
+//# sourceMappingURL=resolve-browser.js.map

package/dist/core/resolve-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-browser.js","sourceRoot":"","sources":["../../src/core/resolve-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAiB,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC"}

package/dist/core/resolve-default.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default resolver: detects the runtime at module load and picks fetch
+ * vs. fs.readFile. Used as a fallback when the consumer doesn't honor
+ * the package.json `browser` / `node` / `deno` / `bun` export conditions.
+ *
+ * Modern bundlers and runtimes hit the conditional exports instead and
+ * never load this file. It's a belt-and-braces fallback.
+ */
+import type { WasmResolver } from "./dispatch.js";
+export declare const resolveWasm: WasmResolver;
+//# sourceMappingURL=resolve-default.d.ts.map

package/dist/core/resolve-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-default.d.ts","sourceRoot":"","sources":["../../src/core/resolve-default.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,eAAO,MAAM,WAAW,EAAE,YAkBzB,CAAC"}

package/dist/core/resolve-default.js

@@ -0,0 +1,27 @@
+/**
+ * Default resolver: detects the runtime at module load and picks fetch
+ * vs. fs.readFile. Used as a fallback when the consumer doesn't honor
+ * the package.json `browser` / `node` / `deno` / `bun` export conditions.
+ *
+ * Modern bundlers and runtimes hit the conditional exports instead and
+ * never load this file. It's a belt-and-braces fallback.
+ */
+export const resolveWasm = async (url) => {
+    const hasFetch = typeof fetch === "function";
+    const isDeno = typeof Deno !== "undefined";
+    const isBun = typeof Bun !== "undefined";
+    const isNode = typeof process !== "undefined" &&
+        process.versions?.node !== undefined &&
+        !isDeno && !isBun;
+    // Node's fetch can't do file://. Everyone else's can (Deno + Bun
+    // natively; browsers only see http(s)). So Node is the only path
+    // that needs fs.readFile.
+    if (isNode && url.protocol === "file:") {
+        const { readFile } = await import("node:fs/promises");
+        return readFile(url);
+    }
+    if (hasFetch)
+        return fetch(url);
+    throw new Error("no wasm resolver available in this runtime");
+};
+//# sourceMappingURL=resolve-default.js.map