node-liblzma 2.2.0 → 3.0.0

package/lib/wasm/bindings.d.ts

@@ -0,0 +1,109 @@
+/**
+ * TypeScript bindings for the Emscripten-compiled liblzma WASM module.
+ *
+ * Provides typed wrappers around the raw C functions exported by liblzma.wasm,
+ * with proper memory management and error handling.
+ */
+import { type WasmLzmaStream } from './memory.js';
+import { type LZMAModule } from './types.js';
+/**
+ * Initialize the WASM module. Must be called before any operation.
+ *
+ * The module is loaded once and cached. Subsequent calls return
+ * the same instance. Can be called with a custom loader for
+ * inline/bundled WASM scenarios.
+ *
+ * @param loader - Optional custom module loader (for inline WASM)
+ * @returns The initialized Emscripten module
+ */
+export declare function initModule(loader?: () => Promise<LZMAModule>): Promise<LZMAModule>;
+/**
+ * Get the initialized module, throwing if not yet loaded.
+ */
+export declare function getModule(): LZMAModule;
+/**
+ * Reset module state (for testing purposes).
+ */
+export declare function resetModule(): void;
+/**
+ * Initialize an easy encoder on the given lzma_stream.
+ *
+ * @param stream - Allocated WasmLzmaStream
+ * @param preset - Compression preset (0-9, optionally OR'd with EXTREME flag)
+ * @param check - Integrity check type (default: CRC64)
+ * @throws LZMAError on initialization failure
+ */
+export declare function encoderInit(stream: WasmLzmaStream, preset: number, check?: number): void;
+/**
+ * Initialize a stream decoder on the given lzma_stream.
+ *
+ * @param stream - Allocated WasmLzmaStream
+ * @param memlimit - Memory limit in bytes (default: 256MB)
+ * @throws LZMAError on initialization failure
+ */
+export declare function decoderInit(stream: WasmLzmaStream, memlimit?: number | bigint): void;
+/**
+ * Initialize an auto decoder (detects format) on the given lzma_stream.
+ *
+ * @param stream - Allocated WasmLzmaStream
+ * @param memlimit - Memory limit in bytes (default: 256MB)
+ * @throws LZMAError on initialization failure
+ */
+export declare function autoDecoderInit(stream: WasmLzmaStream, memlimit?: number | bigint): void;
+/**
+ * Run lzma_code on a stream (one step of encoding/decoding).
+ *
+ * @param stream - Active WasmLzmaStream
+ * @param action - LZMA_RUN, LZMA_FINISH, etc.
+ * @returns The lzma return code (LZMA_OK, LZMA_STREAM_END, or error)
+ */
+export declare function code(stream: WasmLzmaStream, action: number): number;
+/**
+ * Finalize a stream and free its internal resources.
+ */
+export declare function end(stream: WasmLzmaStream): void;
+/**
+ * Get the memory usage of a stream (in bytes).
+ */
+export declare function memusage(stream: WasmLzmaStream): number;
+/**
+ * Compress a buffer using lzma_easy_buffer_encode.
+ *
+ * @param input - Data to compress
+ * @param preset - Compression preset (0-9)
+ * @param check - Integrity check type (default: CRC64)
+ * @returns Compressed data
+ * @throws LZMAError on compression failure
+ */
+export declare function easyBufferEncode(input: Uint8Array, preset: number, check?: number): Uint8Array;
+/**
+ * Decompress a buffer using lzma_stream_buffer_decode.
+ *
+ * @param input - XZ compressed data
+ * @param memlimit - Memory limit in bytes (default: 256MB)
+ * @returns Decompressed data
+ * @throws LZMAError on decompression failure
+ */
+export declare function streamBufferDecode(input: Uint8Array, memlimit?: number | bigint): Uint8Array;
+/**
+ * Process a full input buffer through an initialized encoder/decoder stream,
+ * collecting all output chunks.
+ *
+ * This is used by the buffer APIs (xzAsync/unxzAsync) for streaming
+ * encoding/decoding within a single call.
+ *
+ * @param stream - Initialized WasmLzmaStream (encoder or decoder)
+ * @param input - Input data
+ * @returns Concatenated output
+ * @throws LZMAError on processing failure
+ */
+export declare function processStream(stream: WasmLzmaStream, input: Uint8Array): Uint8Array;
+/**
+ * Get the liblzma version string (e.g. "5.6.3").
+ */
+export declare function versionString(): string;
+/**
+ * Check if a given integrity check type is supported.
+ */
+export declare function checkIsSupported(check: number): boolean;
+//# sourceMappingURL=bindings.d.ts.map

package/lib/wasm/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/wasm/bindings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAA4B,KAAK,cAAc,EAAuB,MAAM,aAAa,CAAC;AACjG,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAWpB;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BxF;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,UAAU,CAKtC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAID;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,SAAmB,GACvB,IAAI,CAMN;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,QAAQ,GAAE,MAAM,GAAG,MAAyB,GAC3C,IAAI,CAON;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,QAAQ,GAAE,MAAM,GAAG,MAAyB,GAC3C,IAAI,CAON;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAGhD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAGvD;AAID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,SAAmB,GACvB,UAAU,CAoCZ;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,MAAM,GAAG,MAAyB,GAC3C,UAAU,CA0DZ;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,UAAU,CAoDnF;AAID;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAStC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/lib/wasm/bindings.js

@@ -0,0 +1,307 @@
+/**
+ * TypeScript bindings for the Emscripten-compiled liblzma WASM module.
+ *
+ * Provides typed wrappers around the raw C functions exported by liblzma.wasm,
+ * with proper memory management and error handling.
+ */
+import { createLZMAError, LZMAError } from '../errors.js';
+import { copyFromWasm, copyToWasm, wasmAlloc, wasmFree } from './memory.js';
+import { LZMA_BUF_ERROR, LZMA_CHECK_CRC64, LZMA_FINISH, LZMA_OK, LZMA_RUN, LZMA_STREAM_END, } from './types.js';
+// Default output buffer size for streaming operations (256KB)
+const DEFAULT_OUT_BUF_SIZE = 256 * 1024;
+// Maximum memory limit for decoder (256MB, matching WASM max)
+const DEFAULT_MEMLIMIT = BigInt(256 * 1024 * 1024);
+/** Singleton module instance (lazy-initialized) */
+let moduleInstance = null;
+let modulePromise = null;
+/**
+ * Initialize the WASM module. Must be called before any operation.
+ *
+ * The module is loaded once and cached. Subsequent calls return
+ * the same instance. Can be called with a custom loader for
+ * inline/bundled WASM scenarios.
+ *
+ * @param loader - Optional custom module loader (for inline WASM)
+ * @returns The initialized Emscripten module
+ */
+export async function initModule(loader) {
+    if (moduleInstance) {
+        return moduleInstance;
+    }
+    if (modulePromise) {
+        return modulePromise;
+    }
+    modulePromise = (async () => {
+        if (loader) {
+            moduleInstance = await loader();
+        }
+        else {
+            // Dynamic import of the Emscripten glue code
+            const { default: createLZMA } = await import('./liblzma.js');
+            moduleInstance = (await createLZMA());
+        }
+        return moduleInstance;
+    })();
+    try {
+        return await modulePromise;
+    }
+    catch (err) {
+        modulePromise = null;
+        throw new LZMAError(`Failed to load WASM module: ${err instanceof Error ? err.message : String(err)}`, -1);
+    }
+}
+/**
+ * Get the initialized module, throwing if not yet loaded.
+ */
+export function getModule() {
+    if (!moduleInstance) {
+        throw new LZMAError('WASM module not initialized. Call initModule() first.', -1);
+    }
+    return moduleInstance;
+}
+/**
+ * Reset module state (for testing purposes).
+ */
+export function resetModule() {
+    moduleInstance = null;
+    modulePromise = null;
+}
+// --- Encoding ---
+/**
+ * Initialize an easy encoder on the given lzma_stream.
+ *
+ * @param stream - Allocated WasmLzmaStream
+ * @param preset - Compression preset (0-9, optionally OR'd with EXTREME flag)
+ * @param check - Integrity check type (default: CRC64)
+ * @throws LZMAError on initialization failure
+ */
+export function encoderInit(stream, preset, check = LZMA_CHECK_CRC64) {
+    const module = getModule();
+    const ret = module._lzma_easy_encoder(stream.ptr, preset, check);
+    if (ret !== LZMA_OK) {
+        throw createLZMAError(ret);
+    }
+}
+/**
+ * Initialize a stream decoder on the given lzma_stream.
+ *
+ * @param stream - Allocated WasmLzmaStream
+ * @param memlimit - Memory limit in bytes (default: 256MB)
+ * @throws LZMAError on initialization failure
+ */
+export function decoderInit(stream, memlimit = DEFAULT_MEMLIMIT) {
+    const module = getModule();
+    const limit = typeof memlimit === 'number' ? BigInt(memlimit) : memlimit;
+    const ret = module._lzma_stream_decoder(stream.ptr, limit, 0);
+    if (ret !== LZMA_OK) {
+        throw createLZMAError(ret);
+    }
+}
+/**
+ * Initialize an auto decoder (detects format) on the given lzma_stream.
+ *
+ * @param stream - Allocated WasmLzmaStream
+ * @param memlimit - Memory limit in bytes (default: 256MB)
+ * @throws LZMAError on initialization failure
+ */
+export function autoDecoderInit(stream, memlimit = DEFAULT_MEMLIMIT) {
+    const module = getModule();
+    const limit = typeof memlimit === 'number' ? BigInt(memlimit) : memlimit;
+    const ret = module._lzma_auto_decoder(stream.ptr, limit, 0);
+    if (ret !== LZMA_OK) {
+        throw createLZMAError(ret);
+    }
+}
+/**
+ * Run lzma_code on a stream (one step of encoding/decoding).
+ *
+ * @param stream - Active WasmLzmaStream
+ * @param action - LZMA_RUN, LZMA_FINISH, etc.
+ * @returns The lzma return code (LZMA_OK, LZMA_STREAM_END, or error)
+ */
+export function code(stream, action) {
+    const module = getModule();
+    return module._lzma_code(stream.ptr, action);
+}
+/**
+ * Finalize a stream and free its internal resources.
+ */
+export function end(stream) {
+    const module = getModule();
+    module._lzma_end(stream.ptr);
+}
+/**
+ * Get the memory usage of a stream (in bytes).
+ */
+export function memusage(stream) {
+    const module = getModule();
+    return Number(module._lzma_memusage(stream.ptr));
+}
+// --- Buffer API (one-shot) ---
+/**
+ * Compress a buffer using lzma_easy_buffer_encode.
+ *
+ * @param input - Data to compress
+ * @param preset - Compression preset (0-9)
+ * @param check - Integrity check type (default: CRC64)
+ * @returns Compressed data
+ * @throws LZMAError on compression failure
+ */
+export function easyBufferEncode(input, preset, check = LZMA_CHECK_CRC64) {
+    const module = getModule();
+    const inPtr = copyToWasm(module, input);
+    // Worst case: XZ header (12) + block header (~32) + data + padding + index + footer
+    // For incompressible data, output can be slightly larger than input
+    const outSize = input.byteLength + 1024;
+    const outPtr = wasmAlloc(module, outSize);
+    const outPosPtr = wasmAlloc(module, 4);
+    try {
+        // outPos starts at 0
+        module.setValue(outPosPtr, 0, 'i32');
+        const ret = module._lzma_easy_buffer_encode(preset, check, 0, // allocator (NULL = default)
+        inPtr, input.byteLength, outPtr, outPosPtr, outSize);
+        if (ret !== LZMA_OK) {
+            throw createLZMAError(ret);
+        }
+        const outPos = module.getValue(outPosPtr, 'i32');
+        return copyFromWasm(module, outPtr, outPos);
+    }
+    finally {
+        wasmFree(module, inPtr);
+        wasmFree(module, outPtr);
+        wasmFree(module, outPosPtr);
+    }
+}
+/**
+ * Decompress a buffer using lzma_stream_buffer_decode.
+ *
+ * @param input - XZ compressed data
+ * @param memlimit - Memory limit in bytes (default: 256MB)
+ * @returns Decompressed data
+ * @throws LZMAError on decompression failure
+ */
+export function streamBufferDecode(input, memlimit = DEFAULT_MEMLIMIT) {
+    const module = getModule();
+    const inPtr = copyToWasm(module, input);
+    const inPosPtr = wasmAlloc(module, 4);
+    const outPosPtr = wasmAlloc(module, 4);
+    const memlimitPtr = wasmAlloc(module, 8);
+    // Start with 4x input size as estimate, will grow if needed
+    let outSize = input.byteLength * 4;
+    if (outSize < 4096)
+        outSize = 4096;
+    let outPtr = wasmAlloc(module, outSize);
+    try {
+        const limit = typeof memlimit === 'number' ? BigInt(memlimit) : memlimit;
+        module.setValue(memlimitPtr, limit, 'i64');
+        // Retry with larger buffer if BUF_ERROR
+        for (let attempt = 0; attempt < 5; attempt++) {
+            module.setValue(inPosPtr, 0, 'i32');
+            module.setValue(outPosPtr, 0, 'i32');
+            const ret = module._lzma_stream_buffer_decode(memlimitPtr, 0, // flags
+            0, // allocator (NULL)
+            inPtr, inPosPtr, input.byteLength, outPtr, outPosPtr, outSize);
+            if (ret === LZMA_OK) {
+                const outPos = module.getValue(outPosPtr, 'i32');
+                return copyFromWasm(module, outPtr, outPos);
+            }
+            // Buffer too small — grow and retry
+            if (ret === LZMA_BUF_ERROR) {
+                wasmFree(module, outPtr);
+                outSize *= 4;
+                outPtr = wasmAlloc(module, outSize);
+                continue;
+            }
+            throw createLZMAError(ret);
+        }
+        throw new LZMAError('Decompression failed: output buffer exhausted', 10);
+    }
+    finally {
+        wasmFree(module, inPtr);
+        wasmFree(module, outPtr);
+        wasmFree(module, inPosPtr);
+        wasmFree(module, outPosPtr);
+        wasmFree(module, memlimitPtr);
+    }
+}
+// --- Streaming helpers ---
+/**
+ * Process a full input buffer through an initialized encoder/decoder stream,
+ * collecting all output chunks.
+ *
+ * This is used by the buffer APIs (xzAsync/unxzAsync) for streaming
+ * encoding/decoding within a single call.
+ *
+ * @param stream - Initialized WasmLzmaStream (encoder or decoder)
+ * @param input - Input data
+ * @returns Concatenated output
+ * @throws LZMAError on processing failure
+ */
+export function processStream(stream, input) {
+    const module = getModule();
+    const inPtr = copyToWasm(module, input);
+    const outBufSize = DEFAULT_OUT_BUF_SIZE;
+    const outPtr = wasmAlloc(module, outBufSize);
+    try {
+        stream.setInput(inPtr, input.byteLength);
+        const chunks = [];
+        let action = LZMA_RUN;
+        while (true) {
+            // Once all input consumed, switch to FINISH
+            if (stream.availIn === 0) {
+                action = LZMA_FINISH;
+            }
+            stream.setOutput(outPtr, outBufSize);
+            const ret = code(stream, action);
+            // Collect output produced
+            const produced = outBufSize - stream.availOut;
+            if (produced > 0) {
+                chunks.push(copyFromWasm(module, outPtr, produced));
+            }
+            if (ret === LZMA_STREAM_END) {
+                break;
+            }
+            if (ret !== LZMA_OK) {
+                throw createLZMAError(ret);
+            }
+        }
+        // Concatenate all output chunks
+        const totalSize = chunks.reduce((sum, c) => sum + c.byteLength, 0);
+        const result = new Uint8Array(totalSize);
+        let offset = 0;
+        for (const chunk of chunks) {
+            result.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return result;
+    }
+    finally {
+        wasmFree(module, inPtr);
+        wasmFree(module, outPtr);
+        end(stream);
+        stream.free();
+    }
+}
+// --- Utility bindings ---
+/**
+ * Get the liblzma version string (e.g. "5.6.3").
+ */
+export function versionString() {
+    const module = getModule();
+    const ptr = module._lzma_version_string();
+    // Read null-terminated C string from WASM memory
+    const bytes = module.HEAPU8;
+    let end = ptr;
+    while (bytes[end] !== 0)
+        end++;
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes.subarray(ptr, end));
+}
+/**
+ * Check if a given integrity check type is supported.
+ */
+export function checkIsSupported(check) {
+    const module = getModule();
+    return module._lzma_check_is_supported(check) !== 0;
+}
+//# sourceMappingURL=bindings.js.map

package/lib/wasm/bindings.js.map

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

package/lib/wasm/compress.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WASM compression functions for browser usage.
+ *
+ * Provides xzAsync, xz (callback), and xzSync (throws in browser)
+ * matching the Node.js API signatures.
+ */
+import type { CompressionCallback, LZMAOptions } from '../types.js';
+/**
+ * Compress a buffer to XZ format (async, Promise-based).
+ *
+ * @param buffer - Data to compress (Uint8Array, ArrayBuffer, or string)
+ * @param opts - Compression options (preset, check)
+ * @returns Compressed XZ data
+ */
+export declare function xzAsync(buffer: Uint8Array | ArrayBuffer | string, opts?: LZMAOptions): Promise<Uint8Array>;
+/**
+ * Compress a buffer to XZ format (callback-based).
+ *
+ * @param buffer - Data to compress
+ * @param optsOrCallback - Options or callback
+ * @param callback - Callback (if opts provided)
+ */
+export declare function xz(buffer: Uint8Array | ArrayBuffer | string, callback: CompressionCallback): void;
+export declare function xz(buffer: Uint8Array | ArrayBuffer | string, opts: LZMAOptions, callback: CompressionCallback): void;
+/**
+ * Synchronous XZ compression — **throws in browser**.
+ *
+ * Sync operations are not supported in WASM because they would block
+ * the main thread. Use xzAsync() instead.
+ */
+export declare function xzSync(_buffer: Uint8Array | ArrayBuffer | string, _opts?: LZMAOptions): never;
+//# sourceMappingURL=compress.d.ts.map

package/lib/wasm/compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../src/wasm/compress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAKpE;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACzC,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;;;GAMG;AACH,wBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;AACnG,wBAAgB,EAAE,CAChB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACzC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAAC;AAsBR;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAE7F"}

package/lib/wasm/compress.js

@@ -0,0 +1,47 @@
+/**
+ * WASM compression functions for browser usage.
+ *
+ * Provides xzAsync, xz (callback), and xzSync (throws in browser)
+ * matching the Node.js API signatures.
+ */
+import { LZMAError } from '../errors.js';
+import { easyBufferEncode, initModule } from './bindings.js';
+import { LZMA_CHECK_CRC64 } from './types.js';
+import { toUint8Array } from './utils.js';
+/**
+ * Compress a buffer to XZ format (async, Promise-based).
+ *
+ * @param buffer - Data to compress (Uint8Array, ArrayBuffer, or string)
+ * @param opts - Compression options (preset, check)
+ * @returns Compressed XZ data
+ */
+export async function xzAsync(buffer, opts) {
+    await initModule();
+    const input = toUint8Array(buffer);
+    const preset = opts?.preset ?? 6;
+    const check = opts?.check ?? LZMA_CHECK_CRC64;
+    return easyBufferEncode(input, preset, check);
+}
+export function xz(buffer, optsOrCallback, callback) {
+    let opts;
+    let cb;
+    if (typeof optsOrCallback === 'function') {
+        cb = optsOrCallback;
+        opts = {};
+    }
+    else {
+        opts = optsOrCallback;
+        cb = callback;
+    }
+    xzAsync(buffer, opts).then((result) => cb(null, result), (error) => cb(error instanceof Error ? error : new Error(String(error))));
+}
+/**
+ * Synchronous XZ compression — **throws in browser**.
+ *
+ * Sync operations are not supported in WASM because they would block
+ * the main thread. Use xzAsync() instead.
+ */
+export function xzSync(_buffer, _opts) {
+    throw new LZMAError('Sync operations not supported in browser. Use xzAsync() instead.', -1);
+}
+//# sourceMappingURL=compress.js.map

package/lib/wasm/compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.js","sourceRoot":"","sources":["../../src/wasm/compress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAyC,EACzC,IAAkB;IAElB,MAAM,UAAU,EAAE,CAAC;IACnB,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,gBAAgB,CAAC;IAC9C,OAAO,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAeD,MAAM,UAAU,EAAE,CAChB,MAAyC,EACzC,cAAiD,EACjD,QAA8B;IAE9B,IAAI,IAAiB,CAAC;IACtB,IAAI,EAAuB,CAAC;IAC5B,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,EAAE,GAAG,cAAc,CAAC;QACpB,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,cAAc,CAAC;QACtB,EAAE,GAAG,QAA+B,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CACxB,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAA2B,CAAC,EACjD,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,OAA0C,EAAE,KAAmB;IACpF,MAAM,IAAI,SAAS,CAAC,kEAAkE,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9F,CAAC"}

package/lib/wasm/decompress.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WASM decompression functions for browser usage.
+ *
+ * Provides unxzAsync, unxz (callback), and unxzSync (throws in browser)
+ * matching the Node.js API signatures.
+ */
+import type { CompressionCallback, LZMAOptions } from '../types.js';
+/**
+ * Decompress XZ data (async, Promise-based).
+ *
+ * @param buffer - XZ compressed data
+ * @param opts - Decompression options (memlimit)
+ * @returns Decompressed data
+ */
+export declare function unxzAsync(buffer: Uint8Array | ArrayBuffer | string, _opts?: LZMAOptions): Promise<Uint8Array>;
+/**
+ * Decompress XZ data (callback-based).
+ *
+ * @param buffer - XZ compressed data
+ * @param optsOrCallback - Options or callback
+ * @param callback - Callback (if opts provided)
+ */
+export declare function unxz(buffer: Uint8Array | ArrayBuffer | string, callback: CompressionCallback): void;
+export declare function unxz(buffer: Uint8Array | ArrayBuffer | string, opts: LZMAOptions, callback: CompressionCallback): void;
+/**
+ * Synchronous XZ decompression — **throws in browser**.
+ *
+ * Sync operations are not supported in WASM because they would block
+ * the main thread. Use unxzAsync() instead.
+ */
+export declare function unxzSync(_buffer: Uint8Array | ArrayBuffer | string, _opts?: LZMAOptions): never;
+//# sourceMappingURL=decompress.d.ts.map

package/lib/wasm/decompress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompress.d.ts","sourceRoot":"","sources":["../../src/wasm/decompress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIpE;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACzC,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CAKrB;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAClB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACzC,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAAC;AACR,wBAAgB,IAAI,CAClB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EACzC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAAC;AAsBR;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,KAAK,CAE/F"}

package/lib/wasm/decompress.js

@@ -0,0 +1,45 @@
+/**
+ * WASM decompression functions for browser usage.
+ *
+ * Provides unxzAsync, unxz (callback), and unxzSync (throws in browser)
+ * matching the Node.js API signatures.
+ */
+import { LZMAError } from '../errors.js';
+import { initModule, streamBufferDecode } from './bindings.js';
+import { toUint8Array } from './utils.js';
+/**
+ * Decompress XZ data (async, Promise-based).
+ *
+ * @param buffer - XZ compressed data
+ * @param opts - Decompression options (memlimit)
+ * @returns Decompressed data
+ */
+export async function unxzAsync(buffer, _opts) {
+    await initModule();
+    const input = toUint8Array(buffer);
+    // TODO: pass opts.memlimit when LZMAOptions supports it
+    return streamBufferDecode(input);
+}
+export function unxz(buffer, optsOrCallback, callback) {
+    let opts;
+    let cb;
+    if (typeof optsOrCallback === 'function') {
+        cb = optsOrCallback;
+        opts = {};
+    }
+    else {
+        opts = optsOrCallback;
+        cb = callback;
+    }
+    unxzAsync(buffer, opts).then((result) => cb(null, result), (error) => cb(error instanceof Error ? error : new Error(String(error))));
+}
+/**
+ * Synchronous XZ decompression — **throws in browser**.
+ *
+ * Sync operations are not supported in WASM because they would block
+ * the main thread. Use unxzAsync() instead.
+ */
+export function unxzSync(_buffer, _opts) {
+    throw new LZMAError('Sync operations not supported in browser. Use unxzAsync() instead.', -1);
+}
+//# sourceMappingURL=decompress.js.map

package/lib/wasm/decompress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompress.js","sourceRoot":"","sources":["../../src/wasm/decompress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAyC,EACzC,KAAmB;IAEnB,MAAM,UAAU,EAAE,CAAC;IACnB,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,wDAAwD;IACxD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAkBD,MAAM,UAAU,IAAI,CAClB,MAAyC,EACzC,cAAiD,EACjD,QAA8B;IAE9B,IAAI,IAAiB,CAAC;IACtB,IAAI,EAAuB,CAAC;IAC5B,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,EAAE,GAAG,cAAc,CAAC;QACpB,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,cAAc,CAAC;QACtB,EAAE,GAAG,QAA+B,CAAC;IACvC,CAAC;IAED,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAC1B,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAA2B,CAAC,EACjD,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAA0C,EAAE,KAAmB;IACtF,MAAM,IAAI,SAAS,CAAC,oEAAoE,EAAE,CAAC,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/lib/wasm/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WASM liblzma module — public API.
+ *
+ * This module provides TypeScript bindings to the Emscripten-compiled
+ * liblzma WASM binary, enabling XZ/LZMA2 compression in browsers.
+ */
+export { autoDecoderInit, checkIsSupported, code, decoderInit, easyBufferEncode, encoderInit, end, getModule, initModule, memusage, processStream, resetModule, streamBufferDecode, versionString as wasmVersionString, } from './bindings.js';
+export { xz, xzAsync, xzSync } from './compress.js';
+export { unxz, unxzAsync, unxzSync } from './decompress.js';
+export { copyFromWasm, copyToWasm, WasmLzmaStream } from './memory.js';
+export { createUnxz, createXz } from './stream.js';
+export { LZMA_BUF_ERROR, LZMA_CHECK_CRC32, LZMA_CHECK_CRC64, LZMA_CHECK_NONE, LZMA_CHECK_SHA256, LZMA_DATA_ERROR, LZMA_FINISH, LZMA_FORMAT_ERROR, LZMA_FULL_FLUSH, LZMA_GET_CHECK, LZMA_MEM_ERROR, LZMA_MEMLIMIT_ERROR, LZMA_NO_CHECK, LZMA_OK, LZMA_OPTIONS_ERROR, LZMA_PROG_ERROR, LZMA_RUN, LZMA_STREAM_END, LZMA_SYNC_FLUSH, LZMA_UNSUPPORTED_CHECK, type LZMAModule, } from './types.js';
+export { easyDecoderMemusage, easyEncoderMemusage, isXZ, parseFileIndex, toUint8Array, versionNumber, versionString, type XZFileIndex, } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/wasm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wasm/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,IAAI,EACJ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,GAAG,EACH,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,aAAa,IAAI,iBAAiB,GACnC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,IAAI,EACJ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}

package/lib/wasm/index.js

@@ -0,0 +1,18 @@
+/**
+ * WASM liblzma module — public API.
+ *
+ * This module provides TypeScript bindings to the Emscripten-compiled
+ * liblzma WASM binary, enabling XZ/LZMA2 compression in browsers.
+ */
+// --- Block 2: Low-level bindings ---
+export { autoDecoderInit, checkIsSupported, code, decoderInit, easyBufferEncode, encoderInit, end, getModule, initModule, memusage, processStream, resetModule, streamBufferDecode, versionString as wasmVersionString, } from './bindings.js';
+// --- Block 3: Buffer API (high-level) ---
+export { xz, xzAsync, xzSync } from './compress.js';
+export { unxz, unxzAsync, unxzSync } from './decompress.js';
+export { copyFromWasm, copyToWasm, WasmLzmaStream } from './memory.js';
+// --- Block 4: Streaming API (Web Streams) ---
+export { createUnxz, createXz } from './stream.js';
+export { LZMA_BUF_ERROR, LZMA_CHECK_CRC32, LZMA_CHECK_CRC64, LZMA_CHECK_NONE, LZMA_CHECK_SHA256, LZMA_DATA_ERROR, LZMA_FINISH, LZMA_FORMAT_ERROR, LZMA_FULL_FLUSH, LZMA_GET_CHECK, LZMA_MEM_ERROR, LZMA_MEMLIMIT_ERROR, LZMA_NO_CHECK, LZMA_OK, LZMA_OPTIONS_ERROR, LZMA_PROG_ERROR, LZMA_RUN, LZMA_STREAM_END, LZMA_SYNC_FLUSH, LZMA_UNSUPPORTED_CHECK, } from './types.js';
+// --- Block 5: Utility functions ---
+export { easyDecoderMemusage, easyEncoderMemusage, isXZ, parseFileIndex, toUint8Array, versionNumber, versionString, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/lib/wasm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wasm/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sCAAsC;AACtC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,IAAI,EACJ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,GAAG,EACH,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,aAAa,IAAI,iBAAiB,GACnC,MAAM,eAAe,CAAC;AACvB,2CAA2C;AAC3C,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,+CAA+C;AAC/C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,eAAe,EACf,QAAQ,EACR,eAAe,EACf,eAAe,EACf,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,qCAAqC;AACrC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,IAAI,EACJ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,GAEd,MAAM,YAAY,CAAC"}