compress-utils 0.8.0 → 0.10.1

package/README.md

@@ -3,9 +3,10 @@
 [![npm version](https://img.shields.io/npm/v/compress-utils.svg)](https://www.npmjs.com/package/compress-utils)
 [![npm downloads](https://img.shields.io/npm/dm/compress-utils.svg)](https://www.npmjs.com/package/compress-utils)
 [![types: built-in](https://img.shields.io/badge/types-built--in-blue.svg)](https://www.npmjs.com/package/compress-utils)
+[![WASM build](https://img.shields.io/github/actions/workflow/status/dupontcyborg/compress-utils/build_and_test_wasm.yml?label=wasm)](https://github.com/dupontcyborg/compress-utils/actions/workflows/build_and_test_wasm.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Unified WebAssembly bindings for eight compression algorithms: Brotli, bzip2, LZ4, XZ/LZMA, zlib, Zstandard, Snappy, and gzip. Same API for every algorithm, in every JavaScript runtime, with tree-shakeable imports so bundlers ship only what you use.
+Unified WebAssembly bindings for eight compression algorithms — Zstandard, Brotli, zlib, gzip, bzip2, LZ4, XZ/LZMA, and Snappy — over a single high-performance C core. Same API for every algorithm, in every JavaScript runtime, with tree-shakeable imports so bundlers ship only what you use.
 
 ## Installation
 
@@ -16,39 +17,38 @@ npm install compress-utils
 
 ### CDN (no bundler)
 
-The package is published as ESM. You can pull it straight from a CDN — no install step, no build step.
+The package is published as ESM. You can pull it straight from a CDN, with no install step and no build step.
 
 ```html
 <script type="module">
-    import { compress, decompress } from 
-      "https://esm.sh/compress-utils/zstd";
+  import { compress, decompress } from "https://esm.sh/compress-utils/zstd";
 
-    const out = await compress(
-      new TextEncoder().encode("hello")
-      );
+  const out = await compress(new TextEncoder().encode("hello"));
 </script>
 ```
 
-| CDN        | Per-algo URL                                                          |
-|------------|-----------------------------------------------------------------------|
-| esm.sh     | `https://esm.sh/compress-utils/<algo>`                                |
-| jsDelivr   | `https://cdn.jsdelivr.net/npm/compress-utils/dist/algorithms/<algo>/index.js` |
-| unpkg      | `https://unpkg.com/compress-utils/dist/algorithms/<algo>/index.js`    |
+| CDN      | Per-algo URL                                                                  |
+|----------|-------------------------------------------------------------------------------|
+| esm.sh   | `https://esm.sh/compress-utils/<algo>`                                        |
+| jsDelivr | `https://cdn.jsdelivr.net/npm/compress-utils/dist/algorithms/<algo>/index.js` |
+| unpkg    | `https://unpkg.com/compress-utils/dist/algorithms/<algo>/index.js`            |
 
 ## Quick start
 
-Each algorithm is its own subpath import. Pick the one you need; the rest stay out of your bundle.
+Each algorithm is its own subpath import. Pick the one you need, and the rest stay out of your bundle.
 
 ```ts
 import { compress, decompress } from "compress-utils/zstd";
 
-const input = new TextEncoder().encode("the quick brown fox " .repeat(50));
+const input = new TextEncoder().encode("the quick brown fox ".repeat(50));
 
 const compressed = await compress(input, { level: 9 });
 const restored   = await decompress(compressed);
 ```
 
-Available subpaths: `compress-utils/zstd`, `/brotli`, `/zlib`, `/bz2`, `/lz4`, `/xz`, `/snappy`, `/gzip`. Identical surface across all eight. Each also has `/<algo>/decompress` and `/<algo>/compress` variants that ship only one direction for a much smaller `.wasm` — see [Bundle size](#bundle-size).
+Available subpaths: `compress-utils/zstd`, `/brotli`, `/zlib`, `/bz2`, `/lz4`, `/xz`, `/snappy`, `/gzip`, plus the raw block formats `/deflate`, `/lz4_raw` and `/lzo/decompress`. The surface is identical across all of them. Each also has `/<algo>/decompress` and `/<algo>/compress` variants that ship only one direction for a much smaller `.wasm`; see [Bundle size](#bundle-size).
+
+## Streaming
 
 ### Web Streams
 
@@ -72,77 +72,129 @@ chunks.push(cs.finish());
 // cs is destroyed automatically on scope exit (TS 5.2+ / Node 22+).
 ```
 
-If `using` isn't available in your toolchain, call `cs.destroy()` explicitly — or rely on the GC backstop (a `FinalizationRegistry` frees the C-side handle eventually).
+If `using` isn't available in your toolchain, call `cs.destroy()` explicitly, or rely on the GC backstop: a `FinalizationRegistry` frees the C-side handle eventually.
 
 ## Supported algorithms
 
-| Algorithm | Subpath                  | Wire format produced                       |
-|-----------|--------------------------|--------------------------------------------|
-| zlib      | `compress-utils/zlib`    | zlib wrapper (RFC 1950)                    |
-| bzip2     | `compress-utils/bz2`     | bzip2 stream                               |
-| XZ/LZMA   | `compress-utils/xz`      | XZ stream with CRC64                       |
-| LZ4       | `compress-utils/lz4`     | LZ4 frame (compatible with `.lz4` files)   |
-| Zstandard | `compress-utils/zstd`    | ZSTD frame with content size               |
-| Brotli    | `compress-utils/brotli`  | raw Brotli stream                          |
-| Snappy    | `compress-utils/snappy`  | Raw Snappy block                           |
-| gzip      | `compress-utils/gzip`    | gzip stream (RFC 1952)                     |
+<!-- BEGIN:algorithms -->
+<!-- Generated by tools/check-readmes.py from docs/readme/manifest.json. Edit the manifest and run `tools/check-readmes.py --fix`, not this block. -->
 
-Imports are independent — `import "compress-utils/zstd"` and `import "compress-utils/brotli"` pull in two separate `.wasm` modules, not a combined bundle. Files marked `"sideEffects": false` so unused exports are tree-shaken aggressively. For per-module `.wasm` sizes (and the smaller decode-only / encode-only builds), see **[Bundle size](#bundle-size)**.
+| Algorithm | Subpath                         | Wire format                                                                              |
+|-----------|---------------------------------|------------------------------------------------------------------------------------------|
+| Zstandard | `compress-utils/zstd`           | ZSTD frame with content size                                                             |
+| Brotli    | `compress-utils/brotli`         | Raw Brotli stream                                                                        |
+| zlib      | `compress-utils/zlib`           | zlib wrapper (RFC 1950)                                                                  |
+| gzip      | `compress-utils/gzip`           | gzip stream (RFC 1952)                                                                   |
+| bzip2     | `compress-utils/bz2`            | bzip2 stream                                                                             |
+| LZ4       | `compress-utils/lz4`            | LZ4 frame (interoperable with the `lz4` CLI and `.lz4` files)                            |
+| XZ / LZMA | `compress-utils/xz`             | XZ stream with CRC64                                                                     |
+| Snappy    | `compress-utils/snappy`         | Raw Snappy block (interoperable with reference snappy and python-snappy)                 |
+| DEFLATE   | `compress-utils/deflate`        | Raw DEFLATE (RFC 1951), no wrapper                                                       |
+| LZ4 block | `compress-utils/lz4_raw`        | Raw LZ4 block, no frame or size prefix (one-shot compression, incremental decompression) |
+| LZO1X     | `compress-utils/lzo/decompress` | Raw LZO1X block (decompression only)                                                     |
+<!-- END:algorithms -->
 
-## Bundle size
+Imports are independent: `import "compress-utils/zstd"` and `import "compress-utils/brotli"` pull in two separate `.wasm` modules, not a combined bundle. Files are marked `"sideEffects": false` so unused exports are tree-shaken aggressively. For per-module `.wasm` sizes, and the smaller decode-only and encode-only builds, see [Bundle size](#bundle-size).
+
+### Raw blocks and output capacity
 
-Importing `compress-utils/<algo>` gives you the **full** codec — compress *and* decompress. If you only need one direction (a browser that just *decompresses* fetched assets is the common case), import a directional subpath and the other half is dead-stripped from the `.wasm` entirely:
+Raw block formats such as those inside Parquet and ORC pages don't record their decompressed size. Pass `expectedSize`, an upper bound on the output, and the result holds only the bytes actually decoded:
 
 ```ts
-// decoder only, 90 KB
-import { decompress } from "compress-utils/zstd/decompress"; 
+import { decompress } from "compress-utils/lz4_raw";
 
-// or, encoder only:
-import { compress }   from "compress-utils/zstd/compress";
+const page = await decompress(block, { expectedSize: uncompressedPageSize });
 ```
 
-- **`/decompress`** exposes `decompress`, `createDecompressStream`, `decompressionStream`, `setMaxDecompressedSize`, `version`.
-- **`/compress`** exposes `compress`, `createCompressStream`, `compressionStream`, `version`.
-- The default subpath keeps **both**
-
-Comparison of the gzipped sizes:
-
-| algo   | full          | decompress-only       | compress-only         |
-|--------|--------------:|----------------------:|----------------------:|
-| zstd   | 128K  | 36K    | 106K           |
-| brotli | 169K  | 84K    | 154K           |
-| lz4    | 39K   | 15K    | 35K             |
-| bz2    | 33K   | 22K    | 25K             |
-| xz     | 62K   | 43K    | 51K            |
-| zlib   | 33K   | 25K    | 26K             |
-| snappy | 36K   | 32K    | 28K             |
-| gzip   | 80K   | 52K    | 60K             |
-
-The `.wasm` is the bulk of what ships; the JS glue is a few KB, shared, and tree-shaken to the methods you import.
+Without `expectedSize`, `lz4_raw` blocks are decoded with the incremental stream decoder, which is much slower, so pass it when you know the size. Every other algorithm accepts it too, which skips a sizing pass and decodes straight into a buffer of that size.
 
 ## Compression levels
 
-Every algorithm accepts a `level` from **1 (fastest) to 10 (smallest)**. The binding maps that to each algorithm's native range internally — you don't need to know that Zstandard goes 1–22 or zlib goes 1–9. Defaults to `5`.
+Every algorithm accepts a `level` from **1 (fastest) to 10 (smallest)**. The binding maps that to each algorithm's native range internally, so you don't need to know that Zstandard goes 1–22 and zlib goes 1–9. The default is `5`.
 
 ```ts
 await compress(input, { level: 1 });   // fastest
 await compress(input, { level: 10 });  // smallest
 ```
 
+## Errors and limits
+
+Every failure throws a `CompressError`, which carries the underlying C status code and the algorithm name:
+
+```ts
+import { compress, decompress, CompressError } from "compress-utils/zstd";
+
+try {
+    await decompress(garbage);
+} catch (e) {
+    if (e instanceof CompressError) console.error(e.algorithm, e.code, e.message);
+}
+```
+
+`await version()` returns the library version (for example `"0.9.0"`), and `await setMaxDecompressedSize(bytes)` bounds one-shot decompression (default 1 GiB; `0` = unbounded). Both are exported from every subpath that includes decompression.
+
+## Preloading and synchronous calls
+
+Each algorithm and direction-specific subpath exports `preload()`. It loads and initializes that subpath's WASM module once, and concurrent calls share initialization. A failed initialization can be retried. No codec work is performed by preload.
+
+```ts
+import { preload, compressSync, decompressSync } from "compress-utils/zlib";
+await preload();
+const compressed = compressSync(new TextEncoder().encode("hello"));
+const restored = decompressSync(compressed);
+```
+
+`compressSync`, `decompressSync`, `createCompressStreamSync`, and `createDecompressStreamSync` are available for the directions exposed by the subpath. They throw with a `preload()` instruction before initialization completes. Existing asynchronous APIs initialize automatically and also enable subsequent synchronous calls. Initializing one subpath does not initialize another, because encoder and decoder subpaths use different WASM modules.
+
+## Concurrency
+
+Each WASM module instance runs on the thread that loaded it, so nothing is shared between workers: every Worker initializes its own instance and keeps its own streams. Synchronous calls block the calling thread, so run expensive ones in a Worker. A stream handle holds state inside its module instance, so feed each stream from one logical flow rather than from interleaved callers.
+
+## Bundle size
+
+Importing `compress-utils/<algo>` gives you the **full** codec, compress *and* decompress. If you only need one direction (a browser that just *decompresses* fetched assets is the common case), import a directional subpath and the other half is dead-stripped from the `.wasm` entirely:
+
+```ts
+// decoder only, 36 KB gzipped for zstd
+import { decompress } from "compress-utils/zstd/decompress";
+
+// or, encoder only:
+import { compress } from "compress-utils/zstd/compress";
+```
+
+- **`/decompress`** exposes `decompress`, `createDecompressStream`, `decompressionStream`, `setMaxDecompressedSize` and `version`.
+- **`/compress`** exposes `compress`, `createCompressStream`, `compressionStream` and `version`.
+- The default subpath keeps **both**.
+
+Gzipped `.wasm` sizes:
+
+| algo   | full | decompress-only | compress-only |
+|--------|-----:|----------------:|--------------:|
+| zstd   | 128K | 36K             | 106K          |
+| brotli | 169K | 84K             | 154K          |
+| lz4    | 39K  | 15K             | 35K           |
+| bz2    | 33K  | 22K             | 25K           |
+| xz     | 62K  | 43K             | 51K           |
+| zlib   | 33K  | 25K             | 26K           |
+| snappy | 36K  | 32K             | 28K           |
+| gzip   | 80K  | 52K             | 60K           |
+
+The `.wasm` is the bulk of what ships. The JS glue is a few KB, shared, and tree-shaken to the methods you import.
+
 ## Runtime support
 
 Tested in CI on every release:
 
-| Runtime              | Status |
-|----------------------|--------|
-| Node 20, 22, 24      | ✅     |
-| Bun                  | ✅     |
-| Deno 2.x             | ✅     |
-| Chromium / Firefox / WebKit (Playwright) | ✅ |
+| Runtime                                  | Status |
+|------------------------------------------|--------|
+| Node 20, 22, 24                          | ✅     |
+| Bun                                      | ✅     |
+| Deno 2.x                                 | ✅     |
+| Chromium / Firefox / WebKit (Playwright) | ✅     |
 
 ## TypeScript
 
-The package is TypeScript-first. `.d.ts` files ship alongside the JS for every subpath; no `@types/` package needed.
+The package is TypeScript-first. `.d.ts` files ship alongside the JS for every subpath, so no `@types/` package is needed.
 
 ```ts
 import { compress, type CompressOptions, type CompressError } from "compress-utils/zstd";
@@ -151,10 +203,14 @@ const opts: CompressOptions = { level: 7 };
 const compressed: Uint8Array = await compress(input, opts);
 ```
 
+## Performance
+
+Overhead versus native C is **0.60–0.84× on compress and 0.50–1.00× on decompress**. WASM is the slowest binding across the board: zstd and brotli decode are the worst cases because they lean on native SIMD, while lz4 decode is memory-bound and costs nothing extra in the sandbox. The reasons to choose this binding are portability, one API in every runtime, and the small per-codec bundles above, rather than beating native `node:zlib`. Compression ratio is byte-identical to every other binding. See the [language comparison](https://github.com/dupontcyborg/compress-utils/blob/main/benchmarks/README.md#language-comparison) for methodology and the full chart.
+
 ## License
 
 MIT. See [LICENSE](https://github.com/dupontcyborg/compress-utils/blob/main/LICENSE).
 
 ---
 
-Built by [Nico Dupont](https://nico.codes).
+Part of [compress-utils](https://github.com/dupontcyborg/compress-utils). Built by [Nico Dupont](https://nico.codes).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,270 @@
+# Third-party notices
+
+compress-utils is MIT-licensed (see `LICENSE`). It also contains code from the projects below, each under its own license, and their license texts are reproduced here as those licenses require. The Python wheel, npm package, Rust crate and Go module all ship this file; a build that includes only some codecs contains only those codecs' code.
+
+Pinned versions are recorded in `third_party/manifest.json` and `third_party/VENDOR.md`.
+
+## Zstandard (zstd)
+
+- **Source**: https://github.com/facebook/zstd at `v1.5.7` (`third_party/zstd/`)
+- **License**: BSD-3-Clause
+- **Note**: zstd is dual-licensed; compress-utils uses it under the BSD license.
+
+```text
+BSD License
+
+For Zstandard software
+
+Copyright (c) Meta Platforms, Inc. and affiliates. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name Facebook, nor Meta, nor the names of its contributors may
+   be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```
+
+## Brotli
+
+- **Source**: https://github.com/google/brotli at `v1.2.0` (`third_party/brotli/`)
+- **License**: MIT
+
+```text
+Copyright (c) 2009, 2010, 2013-2016 by the Brotli Authors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+```
+
+## zlib
+
+- **Source**: https://github.com/madler/zlib at `v1.3.2` (`third_party/zlib/`)
+- **License**: Zlib
+
+```text
+Copyright notice:
+
+ (C) 1995-2026 Jean-loup Gailly and Mark Adler
+
+  This software is provided 'as-is', without any express or implied
+  warranty.  In no event will the authors be held liable for any damages
+  arising from the use of this software.
+
+  Permission is granted to anyone to use this software for any purpose,
+  including commercial applications, and to alter it and redistribute it
+  freely, subject to the following restrictions:
+
+  1. The origin of this software must not be misrepresented; you must not
+     claim that you wrote the original software. If you use this software
+     in a product, an acknowledgment in the product documentation would be
+     appreciated but is not required.
+  2. Altered source versions must be plainly marked as such, and must not be
+     misrepresented as being the original software.
+  3. This notice may not be removed or altered from any source distribution.
+
+  Jean-loup Gailly        Mark Adler
+  jloup@gzip.org          madler@alumni.caltech.edu
+```
+
+## bzip2
+
+- **Source**: https://gitlab.com/bzip2/bzip2 at `bzip2-1.0.8` (`third_party/bz2/`)
+- **License**: bzip2-1.0.6
+
+```text
+--------------------------------------------------------------------------
+
+This program, "bzip2", the associated library "libbzip2", and all
+documentation, are copyright (C) 1996-2019 Julian R Seward.  All
+rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. The origin of this software must not be misrepresented; you must
+   not claim that you wrote the original software.  If you use this
+   software in a product, an acknowledgment in the product
+   documentation would be appreciated but is not required.
+
+3. Altered source versions must be plainly marked as such, and must
+   not be misrepresented as being the original software.
+
+4. The name of the author may not be used to endorse or promote
+   products derived from this software without specific prior written
+   permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Julian Seward, jseward@acm.org
+bzip2/libbzip2 version 1.0.8 of 13 July 2019
+
+--------------------------------------------------------------------------
+```
+
+## LZ4
+
+- **Source**: https://github.com/lz4/lz4 at `v1.10.0` (`third_party/lz4/`)
+- **License**: BSD-2-Clause
+- **Note**: Only the LZ4 library (`lib/`) is included; this is its license.
+
+```text
+LZ4 Library
+Copyright (c) 2011-2020, Yann Collet
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice, this
+  list of conditions and the following disclaimer in the documentation and/or
+  other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```
+
+## XZ Utils (liblzma)
+
+- **Source**: https://github.com/tukaani-project/xz at `v5.8.3` (`third_party/xz/`)
+- **License**: 0BSD
+- **Note**: Only liblzma is included; it is under the BSD Zero Clause License.
+
+```text
+Permission to use, copy, modify, and/or distribute this
+software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
+THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
+CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
+NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
+CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+```
+
+## snappy-c
+
+- **Source**: https://github.com/andikleen/snappy-c at `fef67ac6effb40c83fb5e37eaf243381fa056f9b` (`third_party/snappy/`)
+- **License**: BSD-3-Clause
+
+```text
+The snappy-c code is under the same license as the original snappy source
+
+Copyright 2011 Intel Corporation All Rights Reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+copyright notice, this list of conditions and the following disclaimer
+in the documentation and/or other materials provided with the
+distribution.
+    * Neither the name of Intel Corporation nor the names of its
+contributors may be used to endorse or promote products derived from
+this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```
+
+## lzokay
+
+- **Source**: https://github.com/AxioDL/lzokay at `db2df1fcbebc2ed06c10f727f72567d40f06a2be` (`third_party/lzokay/`)
+- **License**: MIT
+- **Note**: Decoder-only C adaptation; see `third_party/lzokay/PROVENANCE.md`.
+
+```text
+The MIT License
+
+Copyright (c) 2018 Jack Andersen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/algorithms/brotli/compress/index.d.ts

@@ -1,8 +1,14 @@
 export declare const compress: (input: Uint8Array, opts?: import("./index.js").CompressOptions) => Promise<Uint8Array>;
+/** Synchronous counterpart; requires completed preload(). */
+export declare const compressSync: (input: Uint8Array, opts?: import("./index.js").CompressOptions) => Uint8Array;
 export declare const createCompressStream: (opts?: import("./index.js").CompressOptions) => Promise<import("./index.js").CompressStream>;
-export declare const compressionStream: (opts?: import("./index.js").CompressOptions) => TransformStream<Uint8Array, Uint8Array>;
+/** Synchronous counterpart; requires completed preload(). */
+export declare const createCompressStreamSync: (opts?: import("./index.js").CompressOptions) => import("./index.js").CompressStream;
+export declare const compressionStream: (opts?: import("./index.js").CompressionStreamOptions) => TransformStream<Uint8Array, Uint8Array>;
+/** Initializes this independently loaded WASM subpath. */
+export declare const preload: () => Promise<void>;
 export declare const version: () => Promise<string>;
 export { CompressError } from "../../../core/types.js";
-export type { CompressOptions, AlgorithmName } from "../../../core/types.js";
+export type { CompressOptions, CompressionStreamOptions, AlgorithmName, } from "../../../core/types.js";
 export type { CompressStream } from "../../../core/dispatch.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/algorithms/brotli/compress/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/algorithms/brotli/compress/index.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,QAAQ,yFAAoB,CAAC;AAC1C,eAAO,MAAM,oBAAoB,+FAAgC,CAAC;AAClE,eAAO,MAAM,iBAAiB,0FAA6B,CAAC;AAC5D,eAAO,MAAM,OAAO,uBAAmB,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/algorithms/brotli/compress/index.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,QAAQ,yFAAoB,CAAC;AAC1C,6DAA6D;AAC7D,eAAO,MAAM,YAAY,gFAAwB,CAAC;AAClD,eAAO,MAAM,oBAAoB,+FAAgC,CAAC;AAClE,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,sFAAoC,CAAC;AAC1E,eAAO,MAAM,iBAAiB,mGAA6B,CAAC;AAC5D,0DAA0D;AAC1D,eAAO,MAAM,OAAO,qBAAmB,CAAC;AACxC,eAAO,MAAM,OAAO,uBAAmB,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EACR,eAAe,EACf,wBAAwB,EACxB,aAAa,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/algorithms/brotli/compress/index.js

@@ -8,8 +8,14 @@ import { defineAlgorithm } from "../../../core/algorithm.js";
 import { Algorithm } from "../../../core/types.js";
 const bindings = /*#__PURE__*/ defineAlgorithm(Algorithm.Brotli, "brotli", new URL("./brotli.wasm", import.meta.url));
 export const compress = bindings.compress;
+/** Synchronous counterpart; requires completed preload(). */
+export const compressSync = bindings.compressSync;
 export const createCompressStream = bindings.createCompressStream;
+/** Synchronous counterpart; requires completed preload(). */
+export const createCompressStreamSync = bindings.createCompressStreamSync;
 export const compressionStream = bindings.compressionStream;
+/** Initializes this independently loaded WASM subpath. */
+export const preload = bindings.preload;
 export const version = bindings.version;
 export { CompressError } from "../../../core/types.js";
 //# sourceMappingURL=index.js.map

package/dist/algorithms/brotli/compress/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/algorithms/brotli/compress/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAC1C,SAAS,CAAC,MAAM,EAChB,QAAQ,EACR,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,oBAAoB,CAAC;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC;AAC5D,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/algorithms/brotli/compress/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAC1C,SAAS,CAAC,MAAM,EAChB,QAAQ,EACR,IAAI,GAAG,CAAC,eAAe,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;AAC1C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,oBAAoB,CAAC;AAClE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC,wBAAwB,CAAC;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC;AAC5D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/algorithms/brotli/decompress/index.d.ts

@@ -1,6 +1,12 @@
 export declare const decompress: (input: Uint8Array, opts?: import("./index.js").DecompressOptions) => Promise<Uint8Array>;
+/** Synchronous counterpart; requires completed preload(). */
+export declare const decompressSync: (input: Uint8Array, opts?: import("./index.js").DecompressOptions) => Uint8Array;
 export declare const createDecompressStream: () => Promise<import("./index.js").DecompressStream>;
+/** Synchronous counterpart; requires completed preload(). */
+export declare const createDecompressStreamSync: () => import("./index.js").DecompressStream;
 export declare const decompressionStream: () => TransformStream<Uint8Array, Uint8Array>;
+/** Initializes this independently loaded WASM subpath. */
+export declare const preload: () => Promise<void>;
 export declare const version: () => Promise<string>;
 export declare const setMaxDecompressedSize: (bytes: number) => Promise<void>;
 export { CompressError } from "../../../core/types.js";

package/dist/algorithms/brotli/decompress/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/algorithms/brotli/decompress/index.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,UAAU,2FAAsB,CAAC;AAC9C,eAAO,MAAM,sBAAsB,sDAAkC,CAAC;AACtE,eAAO,MAAM,mBAAmB,+CAA+B,CAAC;AAChE,eAAO,MAAM,OAAO,uBAAmB,CAAC;AACxC,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/algorithms/brotli/decompress/index.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,UAAU,2FAAsB,CAAC;AAC9C,6DAA6D;AAC7D,eAAO,MAAM,cAAc,kFAA0B,CAAC;AACtD,eAAO,MAAM,sBAAsB,sDAAkC,CAAC;AACtE,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,6CAAsC,CAAC;AAC9E,eAAO,MAAM,mBAAmB,+CAA+B,CAAC;AAChE,0DAA0D;AAC1D,eAAO,MAAM,OAAO,qBAAmB,CAAC;AACxC,eAAO,MAAM,OAAO,uBAAmB,CAAC;AACxC,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/algorithms/brotli/decompress/index.js

@@ -8,8 +8,14 @@ import { defineAlgorithm } from "../../../core/algorithm.js";
 import { Algorithm } from "../../../core/types.js";
 const bindings = /*#__PURE__*/ defineAlgorithm(Algorithm.Brotli, "brotli", new URL("./brotli.wasm", import.meta.url));
 export const decompress = bindings.decompress;
+/** Synchronous counterpart; requires completed preload(). */
+export const decompressSync = bindings.decompressSync;
 export const createDecompressStream = bindings.createDecompressStream;
+/** Synchronous counterpart; requires completed preload(). */
+export const createDecompressStreamSync = bindings.createDecompressStreamSync;
 export const decompressionStream = bindings.decompressionStream;
+/** Initializes this independently loaded WASM subpath. */
+export const preload = bindings.preload;
 export const version = bindings.version;
 export const setMaxDecompressedSize = bindings.setMaxDecompressedSize;
 export { CompressError } from "../../../core/types.js";

package/dist/algorithms/brotli/decompress/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/algorithms/brotli/decompress/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAC1C,SAAS,CAAC,MAAM,EAChB,QAAQ,EACR,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC,sBAAsB,CAAC;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,mBAAmB,CAAC;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC,sBAAsB,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/algorithms/brotli/decompress/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAC1C,SAAS,CAAC,MAAM,EAChB,QAAQ,EACR,IAAI,GAAG,CAAC,eAAe,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;AAC9C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC,sBAAsB,CAAC;AACtE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC,0BAA0B,CAAC;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,mBAAmB,CAAC;AAChE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC,sBAAsB,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}