@myrialabs/zipkit 0.0.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Myria Labs
+
+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/README.md

@@ -0,0 +1,329 @@
+<p align="center">
+  <img src="https://zipkit.myrialabs.dev/favicon.svg" alt="ZipKit" width="72" height="72" />
+</p>
+
+<h1 align="center">ZipKit</h1>
+
+<p align="center">
+  <strong>Overkill compression for Node, Bun &amp; the browser.</strong><br />
+  gzip · deflate · zlib · zstd · lz4 · snappy · brotli · lzma · bzip2 · ZIP —
+  one tiny, typed API over a single Wasm engine.
+</p>
+
+<p align="center">
+  <a href="https://demo.zipkit.myrialabs.dev/">Demo</a> ·
+  <a href="https://zipkit.myrialabs.dev/">Website</a> ·
+  <a href="https://www.npmjs.com/package/@myrialabs/zipkit">npm</a> ·
+  <a href="./docs/api.md">API reference</a> ·
+  <a href="./docs/cli.md">CLI reference</a> ·
+  <a href="./examples/README.md">Examples</a> ·
+  <a href="https://github.com/myrialabs/zipkit/issues">Issues</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@myrialabs/zipkit"><img src="https://img.shields.io/npm/v/@myrialabs%2Fzipkit" alt="npm version" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" /></a>
+  <img src="https://img.shields.io/badge/runtime-Node%2018%2B%20%7C%20Bun%20%7C%20Browser-black" alt="Node 18+, Bun and Browser" />
+</p>
+
+---
+
+ZipKit compiles best-in-class C compression libraries (libdeflate, zstd, lz4,
+brotli, snappy, LZMA, bzip2) into one WebAssembly engine, then wraps them in a
+small TypeScript API. The default path is adaptive: native speed where the runtime
+wins, the portable engine where it wins, and libdeflate density when ratio matters.
+
+```ts
+import { gzip, gunzip, zstd, unzstd, zip, unzip, compress, decompress } from '@myrialabs/zipkit';
+
+const gz = await gzip(bytes);              // balanced default
+const back = await gunzip(gz);
+
+const fast = await zstd(bytes, { mode: 'speed' });
+const exact = await unzstd(fast);
+
+const archive = await zip([{ name: 'data.bin', data: bytes }]);
+const files = await unzip(archive);
+
+const small = await compress(bytes, 'zstd', { mode: 'ratio' });
+const orig = await decompress(small);      // auto-detects the format
+```
+
+```sh
+zipkit compress data.json --codec zstd     # CLI
+zipkit zip site.zip index.html app.js --method zstd
+```
+
+## Why ZipKit
+
+- **One simple API, every codec** — named imports (`gzip`, `zstd`, `zip`) when you
+  know what you want, or `compress()` / `decompress()` for generic dispatch.
+- **One clear option** — `mode: 'speed' | 'balanced' | 'ratio'`. No tuning maze;
+  `level` is still available when you need exact control.
+- **Adaptive performance** — ZipKit chooses native Bun zlib/zstd where it wins,
+  the Wasm engine where it wins, and libdeflate for density.
+- **Denser gzip when you ask for ratio** — `mode: 'ratio'` uses libdeflate for
+  gzip/deflate/zlib and beats runtime zlib output size on every benchmark dataset.
+- **Runs everywhere** — Node 18+, Bun, and the browser, from the same import. No
+  Bun required; native APIs are accelerators only when present.
+- **More than fflate** — feature parity with fflate plus zstd/brotli/lzma/bzip2/xz,
+  ZIP-with-zstd, **streaming & AES-encrypted ZIP**, **tar** and **7z** containers,
+  **zstd dictionaries** and **delta** compression, native `TransformStream`s, and
+  lossless image (QOI) and video (frame-delta) codecs.
+- **Typed & documented** — TypeScript-first, JSDoc on every export, tree-shakeable
+  named imports, `sideEffects: false`.
+
+## Install
+
+```sh
+bun add @myrialabs/zipkit          # or: npm i @myrialabs/zipkit / pnpm add @myrialabs/zipkit
+bun add -g @myrialabs/zipkit       # CLI
+```
+
+## Quick start
+
+| Task | API |
+| --- | --- |
+| Compress | `await zstd(bytes)` |
+| Decompress | `await unzstd(bytes)` |
+| Generic + auto-detect | `await compress(bytes, 'gzip')` · `await decompress(bytes)` |
+| Just the smallest | `await pack(bytes)` · `await unpack(packed)` |
+| Prefer speed | `await gzip(bytes, { mode: 'speed' })` |
+| Prefer ratio | `await zstd(bytes, { mode: 'ratio' })` |
+| ZIP archive | `await zip([{ name, data }])` · `await unzip(archive)` |
+| Encrypted ZIP | `await zip(entries, { password })` · `await unzip(a, { password })` |
+| Streaming ZIP | `zipStream(entries).pipeTo(dest)` |
+| tar / tarball | `tar(entries)` · `await tarGz(entries)` (`@myrialabs/zipkit/tar`) |
+| 7z | `await sevenZip(entries)` · `await unSevenZip(a)` (`@myrialabs/zipkit/sevenzip`) |
+| xz | `await xz(bytes)` · `await unxz(bytes)` |
+| Dictionary / delta | `compressWithDictionary` · `compressDelta` |
+| Stream codec | `readable.pipeThrough(compressionStream('gzip'))` |
+
+> **Auto-detect scope.** `decompress()` decodes the self-describing codecs —
+> **gzip, zlib, zstd, xz** — and recognizes container formats (ZIP, tar, 7z,
+> bzip2, lz4-frame), pointing you to the right reader. For headerless or
+> ZipKit-framed codecs (brotli, snappy, lz4, lzma, bzip2) name the codec:
+> `decompressWith(bytes, 'brotli')`.
+
+### The two API styles
+
+**Named functions** (async, tree-shakeable) — the default. Each lazily loads the
+shared engine the first time it's called.
+
+```ts
+import { brotli, unbrotli } from '@myrialabs/zipkit';
+const c = await brotli(bytes, { mode: 'ratio' });
+```
+
+**The `ZipKit` class** (synchronous) — load the engine once, then call
+synchronously. It accepts the same `mode` option as the async helpers while still
+supporting the old numeric level argument (`zk.gzip(bytes, 6)`).
+
+```ts
+import { ZipKit } from '@myrialabs/zipkit';
+const zk = await ZipKit.load();
+const gz = zk.gzip(bytes, { mode: 'speed' }); // sync
+const smallest = zk.pack(bytes); // tries brotli/lzma/bzip2/zstd-max, keeps the smallest
+```
+
+## Performance
+
+Bun 1.3.14, every codec against its best competitor. Reproduce with
+`bun run bench.ts`; the full tables (three datasets + parallel + ZIP archive vs
+JSZip/fflate) live in [bench-results.md](./bench-results.md). All roundtrips are
+byte-identical.
+
+Representative — **E-commerce API**, ~97 KB JSON (throughput, higher is faster):
+
+| Codec | Implementation | Ratio | Compress | Decompress |
+|-------|----------------|------:|---------:|-----------:|
+| **gzip** | | | | |
+| | ZipKit | 5.1% | 396 MB/s | 2.7 GB/s |
+| | ZipKit (ratio) | 4.9% | 51 MB/s | 2.6 GB/s |
+| | fflate | 5.9% | 55 MB/s | 122 MB/s |
+| | Bun.gzipSync | 5.1% | 380 MB/s | 2.5 GB/s |
+| **deflate** | | | | |
+| | ZipKit | 5.1% | 400 MB/s | 2.7 GB/s |
+| | ZipKit (ratio) | 4.9% | 50 MB/s | 2.5 GB/s |
+| | fflate | 5.9% | 68 MB/s | 119 MB/s |
+| | Bun.deflateSync | 5.1% | 399 MB/s | 2.7 GB/s |
+| **zlib** | | | | |
+| | ZipKit | 6.0% | 273 MB/s | 1.2 GB/s |
+| | ZipKit (ratio) | 4.9% | 53 MB/s | 2.0 GB/s |
+| | fflate | 5.9% | 63 MB/s | 112 MB/s |
+| **zstd** | | | | |
+| | ZipKit | 5.6% | 1.5 GB/s | 3.4 GB/s |
+| | ZipKit (ratio) | 3.9% | 2 MB/s | 5.3 GB/s |
+| | zstd-wasm | 5.6% | 354 MB/s | 978 MB/s |
+| | Bun.zstdCompressSync | 5.6% | 1.9 GB/s | 3.5 GB/s |
+| **lz4** | | | | |
+| | ZipKit | 12.9% | 1018 MB/s | 2.1 GB/s |
+| | lz4js | 12.5% | 399 MB/s | 515 MB/s |
+| **snappy** | | | | |
+| | ZipKit | 13.5% | 599 MB/s | 1.5 GB/s |
+| | snappyjs | 13.5% | 358 MB/s | 437 MB/s |
+| **brotli** | | | | |
+| | ZipKit | 4.1% | 107 MB/s | 844 MB/s |
+| | ZipKit (ratio) | 3.4% | 611.5 KB/s | 1.8 GB/s |
+| | brotli-wasm | 4.1% | 42 MB/s | 560 MB/s |
+| **lzma** | | | | |
+| | ZipKit | 3.8% | 18 MB/s | 423 MB/s |
+| **bzip2** | | | | |
+| | ZipKit | 3.4% | 17 MB/s | 83 MB/s |
+
+What the full run adds beyond this table:
+
+- **Against portable JS** (fflate, pako, zstd-wasm, brotli-wasm), ZipKit
+  compresses several× faster at an equal-or-better ratio across all datasets.
+- **`mode: 'ratio'`** trades speed for size: libdeflate gzip/deflate is denser
+  than native zlib, and brotli/lzma/bzip2 reach the smallest output (~3.3–3.8% on JSON).
+- **Parallel** (8 cores, 34 MB logs) is the multi-core path native libs lack:
+  `compressParallel` gzip runs **5.4× faster** than `Bun.gzipSync`, same output size.
+- **ZIP archives** fan entry compression across the pool: a 20-file, 8 MB archive
+  packs **8.9× faster** than `fflate` and **7.8× faster** than JSZip, 10% smaller.
+- **Dictionary & delta** target what generic codecs handle poorly: a zstd
+  dictionary makes 500 small JSON records **~66% smaller** than per-record zstd,
+  and `compressDelta` encodes a one-line edit to a 64 KB doc **>250× smaller**
+  than recompressing it. `xz` is included in every codec table too.
+
+## Streaming
+
+Web-standard `TransformStream`s for every codec. gzip / zlib / deflate are backed by
+the platform's native `CompressionStream` (true incremental streaming); the rest
+buffer and compress on flush.
+
+```ts
+import { compressionStream } from '@myrialabs/zipkit/streams';
+
+await fetch(url)
+  .then((r) => r.body!)
+  .then((body) => body.pipeThrough(compressionStream('gzip')).pipeTo(dest));
+```
+
+## ZIP archives
+
+```ts
+import { zip, unzip } from '@myrialabs/zipkit';
+
+const archive = await zip([
+  { name: 'index.html', data: html },
+  { name: 'app.js', data: js, method: 'zstd' },     // denser, ZipKit-aware peers
+  { name: 'logo.png', data: png, method: 'store', unixPermissions: 0o644 }
+]);
+
+const files = await unzip(archive, { filter: (e) => e.name.endsWith('.js') });
+```
+
+`store` and `deflate` entries interoperate with every standard ZIP tool; `zstd`
+entries (method 93) are much denser between ZipKit-aware peers. ZIP64 kicks in
+automatically beyond 4 GB / 65 535 entries.
+
+**Encrypted** (WinZip AES-256, reads back in 7-Zip/WinZip), **streaming** (never
+buffers the whole archive), and **integrity-checked**:
+
+```ts
+const enc = await zip(entries, { password: 'secret' });   // AES-256 (AE-2)
+const out = await unzip(enc, { password: 'secret', verify: true });
+
+import { zipStream } from '@myrialabs/zipkit/zip';
+await zipStream(entries).pipeTo(destination);             // memory-bounded
+```
+
+## tar, 7z & xz
+
+```ts
+import { tar, tarGz, untarGz } from '@myrialabs/zipkit/tar';
+import { sevenZip, unSevenZip } from '@myrialabs/zipkit/sevenzip';
+import { xz, unxz } from '@myrialabs/zipkit/xz';
+
+const tgz = await tarGz([{ name: 'a.txt', data }]);        // .tar.gz (also tarZstd)
+const archive = await sevenZip([{ name: 'a.txt', data }]); // 7-Zip-compatible
+const x = await xz(data, { level: 9 });                    // standard .xz
+```
+
+tar is POSIX `ustar`+PAX (Unix-`tar`/Docker compatible); 7z reads/writes
+copy/LZMA(2) and interoperates with 7-Zip both directions; xz is the full
+streaming `.xz` container.
+
+## Dictionary & delta
+
+```ts
+import { trainDictionary, compressWithDictionary } from '@myrialabs/zipkit/dictionary';
+import { compressDelta, applyDelta } from '@myrialabs/zipkit/delta';
+
+const dict = await trainDictionary(samples);          // many small similar payloads
+const small = await compressWithDictionary(record, dict);
+
+const patch = await compressDelta(prevRevision, newRevision);  // logs/chat/state
+const restored = await applyDelta(prevRevision, patch);
+```
+
+## HTTP middleware
+
+`Accept-Encoding`-negotiating compression for Elysia, Express, and Hono
+(brotli → zstd → gzip → deflate).
+
+```ts
+import { Elysia } from 'elysia';
+import { elysia as compression } from '@myrialabs/zipkit/middleware';
+
+new Elysia()
+  .onAfterHandle(compression())
+  .get('/', () => ({ rows: Array.from({ length: 200 }, (_, i) => ({ i })) }))
+  .listen(3000);
+```
+
+```ts
+import express from 'express';
+import { express as compression } from '@myrialabs/zipkit/middleware';
+
+const app = express();
+app.use(compression());
+app.get('/', (_req, res) => res.json({ rows: Array.from({ length: 200 }, (_, i) => ({ i })) }));
+app.listen(3000);
+```
+
+```ts
+import { Hono } from 'hono';
+import { hono as compression } from '@myrialabs/zipkit/middleware';
+
+const app = new Hono();
+app.use('*', compression());
+```
+
+## Browser
+
+The engine loads its `.wasm` via `import.meta.url`, which Vite, webpack 5, esbuild,
+and Rollup resolve as an asset out of the box. See [docs/browser.md](./docs/browser.md).
+
+The combined engine is ~1.4 MB of `.wasm` (every codec in one module), loaded
+once and cached. Keep it off your initial bundle with a dynamic import
+(`const { gzip } = await import('@myrialabs/zipkit')`), or skip the engine entirely for
+gzip/zlib/deflate by using [`@myrialabs/zipkit/streams`](./docs/streaming.md), which run on
+the browser's native `CompressionStream`. Per-codec Wasm splitting is on the
+roadmap.
+
+## Documentation
+
+- [API reference](./docs/api.md) — every export, option, and method.
+- [CLI reference](./docs/cli.md) — every command and flag.
+- [Algorithms](./docs/algorithms.md) — which codec to use, with benchmark tables.
+- [Streaming](./docs/streaming.md) · [ZIP](./docs/zip.md) · [Browser](./docs/browser.md)
+- [Examples](./examples/README.md) — runnable scenarios.
+
+## Support
+
+If ZipKit is useful to you, consider supporting its development:
+
+| Method | Address / Link |
+|--------|----------------|
+| Bitcoin (BTC) | `bc1qd9fyx4r84cce2a9hkjksetah802knadw5msls3` |
+| Solana (SOL) | `Ev3P4KLF1PNC5C9rZYP8M3DdssyBQAQAiNJkvNmPQPVs` |
+| Ethereum (ERC-20) | `0x61D826e5b666AA5345302EEEd485Acca39b1AFCF` |
+| USDT (TRC-20) | `TLH49i3EoVKhFyLb6u2JUXZWScK7uzksdC` |
+| Saweria | [saweria.co/myrialabs](https://saweria.co/myrialabs) |
+
+## License
+
+MIT — see [LICENSE](LICENSE). Bundles several open-source C libraries; see
+[their licenses](./docs/algorithms.md#third-party-licenses).

package/dist/bench/corpus.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Deterministic benchmark corpora.
+ *
+ * `zipkit bench` with no file compares codecs on these built-in datasets, so
+ * ratio/timing comparisons across versions or PRs are apple-to-apple instead of
+ * depending on whatever file a user happened to pass. Everything is generated
+ * from a fixed seed (no `Math.random`, no bundled fixtures bloating the
+ * package), so the same input bytes are reproduced on every machine and run.
+ */
+/** A named benchmark dataset. */
+export interface CorpusEntry {
+    /** Short identifier, e.g. `'text'`. */
+    name: string;
+    /** One-line description of what the dataset models. */
+    description: string;
+    /** The dataset bytes. */
+    data: Uint8Array;
+}
+/** Build the standard corpus at roughly `bytesPerSet` bytes per dataset (default 256 KB). */
+export declare function presetCorpus(bytesPerSet?: number): CorpusEntry[];
+//# sourceMappingURL=corpus.d.ts.map

package/dist/bench/corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/bench/corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC3B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,IAAI,EAAE,UAAU,CAAC;CACjB;AAkFD,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,WAAW,SAAa,GAAG,WAAW,EAAE,CAOpE"}

package/dist/bench/corpus.js

@@ -0,0 +1,92 @@
+/**
+ * Deterministic benchmark corpora.
+ *
+ * `zipkit bench` with no file compares codecs on these built-in datasets, so
+ * ratio/timing comparisons across versions or PRs are apple-to-apple instead of
+ * depending on whatever file a user happened to pass. Everything is generated
+ * from a fixed seed (no `Math.random`, no bundled fixtures bloating the
+ * package), so the same input bytes are reproduced on every machine and run.
+ */
+/** A tiny deterministic PRNG (mulberry32) — reproducible, no global state. */
+function rng(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+const WORDS = ('the quick brown fox jumps over a lazy dog while data flows through pipes and ' +
+    'buffers compress into smaller frames across every runtime node bun browser ' +
+    'engine codec stream archive entry header footer index block size ratio').split(' ');
+/** Natural-language-like English text — exercises entropy coding and matching. */
+function textCorpus(targetBytes) {
+    const next = rng(0x1234abcd);
+    let s = '';
+    while (s.length < targetBytes) {
+        const len = 6 + Math.floor(next() * 14);
+        const line = [];
+        for (let i = 0; i < len; i++)
+            line.push(WORDS[Math.floor(next() * WORDS.length)]);
+        s += line.join(' ') + '.\n';
+    }
+    return new TextEncoder().encode(s.slice(0, targetBytes));
+}
+/** Repetitive structured JSON records — the everyday API/log-payload shape. */
+function jsonCorpus(targetBytes) {
+    const next = rng(0x55aa00ff);
+    const levels = ['debug', 'info', 'warn', 'error'];
+    const svcs = ['api', 'auth', 'cache', 'db', 'queue'];
+    const records = [];
+    let size = 0;
+    let i = 0;
+    while (size < targetBytes) {
+        const rec = JSON.stringify({
+            ts: 1_700_000_000 + i,
+            level: levels[Math.floor(next() * levels.length)],
+            svc: svcs[Math.floor(next() * svcs.length)],
+            id: Math.floor(next() * 1_000_000),
+            ok: next() > 0.1,
+            msg: `request ${i} processed in ${Math.floor(next() * 500)}ms`
+        });
+        records.push(rec);
+        size += rec.length + 1;
+        i++;
+    }
+    return new TextEncoder().encode('[' + records.join(',\n') + ']');
+}
+/** Semi-structured log lines with timestamps and repeated tokens. */
+function logCorpus(targetBytes) {
+    const next = rng(0x0f0f0f0f);
+    const paths = ['/api/users', '/api/orders', '/health', '/assets/app.js', '/login'];
+    let s = '';
+    let i = 0;
+    while (s.length < targetBytes) {
+        const ms = 1_700_000_000_000 + i * 137;
+        s += `${ms} GET ${paths[Math.floor(next() * paths.length)]} ${200 + Math.floor(next() * 5) * 100} ${Math.floor(next() * 9999)}b\n`;
+        i++;
+    }
+    return new TextEncoder().encode(s.slice(0, targetBytes));
+}
+/** High-entropy bytes with light structure — a near-incompressible baseline. */
+function binaryCorpus(targetBytes) {
+    const next = rng(0xdeadbeef);
+    const out = new Uint8Array(targetBytes);
+    for (let i = 0; i < targetBytes; i++) {
+        // Mostly random, but with occasional runs so it isn't pure noise.
+        out[i] = next() < 0.15 ? 0 : Math.floor(next() * 256);
+    }
+    return out;
+}
+/** Build the standard corpus at roughly `bytesPerSet` bytes per dataset (default 256 KB). */
+export function presetCorpus(bytesPerSet = 256 * 1024) {
+    return [
+        { name: 'text', description: 'English-like natural-language text', data: textCorpus(bytesPerSet) },
+        { name: 'json', description: 'repetitive structured JSON records', data: jsonCorpus(bytesPerSet) },
+        { name: 'log', description: 'semi-structured server log lines', data: logCorpus(bytesPerSet) },
+        { name: 'binary', description: 'high-entropy bytes (near-incompressible)', data: binaryCorpus(bytesPerSet) }
+    ];
+}
+//# sourceMappingURL=corpus.js.map

package/dist/bench/corpus.js.map

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

package/dist/checksum.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Explicit integrity helpers.
+ *
+ * The codecs already validate their own framed checksums on decode (gzip's
+ * CRC-32, zstd's optional content checksum), and {@link import('./zip/index.js').unzip}
+ * takes a `verify` option to re-check every entry. This module exposes the raw
+ * CRC-32 so callers can verify or fingerprint arbitrary bytes themselves — the
+ * same libdeflate SIMD routine the ZIP container uses, not a byte-at-a-time
+ * table.
+ */
+/**
+ * CRC-32 (IEEE 802.3) of `data`. Pass a prior result as `seed` to continue a
+ * running checksum across chunks. Returned as an unsigned 32-bit integer.
+ *
+ * @example
+ * ```ts
+ * import { crc32 } from '@myrialabs/zipkit';
+ * const sum = await crc32(bytes);
+ * const running = await crc32(part2, await crc32(part1));
+ * ```
+ */
+export declare function crc32(data: Uint8Array, seed?: number): Promise<number>;
+/**
+ * Verify `data` against an expected CRC-32, returning `true` on a match. A thin
+ * convenience over {@link crc32} for the common "does this match what I stored"
+ * check.
+ */
+export declare function verifyChecksum(data: Uint8Array, expected: number): Promise<boolean>;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../src/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAGvE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzF"}

package/dist/checksum.js

@@ -0,0 +1,35 @@
+/**
+ * Explicit integrity helpers.
+ *
+ * The codecs already validate their own framed checksums on decode (gzip's
+ * CRC-32, zstd's optional content checksum), and {@link import('./zip/index.js').unzip}
+ * takes a `verify` option to re-check every entry. This module exposes the raw
+ * CRC-32 so callers can verify or fingerprint arbitrary bytes themselves — the
+ * same libdeflate SIMD routine the ZIP container uses, not a byte-at-a-time
+ * table.
+ */
+import { getEngine } from './engine.js';
+/**
+ * CRC-32 (IEEE 802.3) of `data`. Pass a prior result as `seed` to continue a
+ * running checksum across chunks. Returned as an unsigned 32-bit integer.
+ *
+ * @example
+ * ```ts
+ * import { crc32 } from '@myrialabs/zipkit';
+ * const sum = await crc32(bytes);
+ * const running = await crc32(part2, await crc32(part1));
+ * ```
+ */
+export async function crc32(data, seed = 0) {
+    const e = await getEngine();
+    return e.crc32(data, seed) >>> 0;
+}
+/**
+ * Verify `data` against an expected CRC-32, returning `true` on a match. A thin
+ * convenience over {@link crc32} for the common "does this match what I stored"
+ * check.
+ */
+export async function verifyChecksum(data, expected) {
+    return (await crc32(data)) === (expected >>> 0);
+}
+//# sourceMappingURL=checksum.js.map

package/dist/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../src/checksum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAgB,EAAE,IAAI,GAAG,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC;IAC5B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAgB,EAAE,QAAgB;IACtE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * zipkit CLI
+ *
+ * A thin command line over the library, so ZipKit can be used straight from a
+ * terminal (`npm i -g @myrialabs/zipkit` / `bun add -g @myrialabs/zipkit`).
+ *
+ *   zipkit compress <file> [--codec zstd] [--mode ratio] [--level N] [-o out]
+ *   zipkit decompress <file> [--codec gzip] [-o out]   (auto-detects by default)
+ *   zipkit zip <archive.zip> <files...> [--method deflate|zstd|store]
+ *   zipkit unzip <archive.zip> [-d <dir>]
+ *   zipkit info <file>                 Inspect a file (format, or ZIP listing)
+ *   zipkit bench <file>                Compare every codec on a file
+ *   zipkit version | help
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG"}