@myrialabs/zipkit 0.0.6

package/dist/pack.js

@@ -0,0 +1,75 @@
+/**
+ * "Smallest possible" packing.
+ *
+ * `pack()` tries the densest codecs (brotli, lzma, bzip2, zstd-ultra) and keeps
+ * the smallest result, tagged with a one-byte codec id so `unpack()` can
+ * reverse it without being told which codec won. Use it when output size
+ * matters more than compression time and both ends are ZipKit.
+ *
+ * The async {@link pack}/{@link unpack} helpers lazily load the shared engine;
+ * the synchronous {@link packSync}/{@link unpackSync} take an already-loaded
+ * engine and back {@link import('./zipkit.js').ZipKit.pack}.
+ */
+import { getEngine } from './engine.js';
+import { ZipKitError } from './types.js';
+const PACK_BROTLI = 0;
+const PACK_LZMA = 1;
+const PACK_BZIP2 = 2;
+const PACK_ZSTD = 3;
+/** Codec name for each pack tag, indexed by the leading tag byte. */
+export const PACK_CODECS = ['brotli', 'lzma', 'bzip2', 'zstd'];
+/** Pack with an already-loaded engine. */
+export function packSync(engine, data) {
+    const candidates = [
+        [PACK_BROTLI, engine.brotliCompress(data, 11)],
+        [PACK_LZMA, engine.lzmaCompress(data, 9)],
+        [PACK_BZIP2, engine.bzip2Compress(data, 9)],
+        [PACK_ZSTD, engine.zstdMaxCompress(data, 22)]
+    ];
+    let best = candidates[0];
+    for (const c of candidates)
+        if (c[1].length < best[1].length)
+            best = c;
+    const out = new Uint8Array(best[1].length + 1);
+    out[0] = best[0];
+    out.set(best[1], 1);
+    return out;
+}
+/** Reverse {@link packSync} with an already-loaded engine. */
+export function unpackSync(engine, data) {
+    const tag = data[0];
+    const body = data.subarray(1);
+    switch (tag) {
+        case PACK_BROTLI:
+            return engine.brotliDecompress(body);
+        case PACK_LZMA:
+            return engine.lzmaDecompress(body);
+        case PACK_BZIP2:
+            return engine.bzip2Decompress(body);
+        case PACK_ZSTD:
+            return engine.zstdDecompress(body);
+        default:
+            throw new ZipKitError(`unpack: unknown codec tag ${tag}`);
+    }
+}
+/**
+ * Compress to the smallest output across brotli/lzma/bzip2/zstd-ultra, tagged so
+ * {@link unpack} can reverse it. Async; lazily loads the shared engine. For the
+ * synchronous form load an engine once via `ZipKit.load()` and call
+ * {@link import('./zipkit.js').ZipKit.pack}.
+ *
+ * @example
+ * ```ts
+ * import { pack, unpack } from '@myrialabs/zipkit';
+ * const small = await pack(bytes);
+ * const orig = await unpack(small);
+ * ```
+ */
+export async function pack(data) {
+    return packSync(await getEngine(), data);
+}
+/** Reverse {@link pack}. Async; lazily loads the shared engine. */
+export async function unpack(data) {
+    return unpackSync(await getEngine(), data);
+}
+//# sourceMappingURL=pack.js.map

package/dist/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAqB,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB,qEAAqE;AACrE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAExE,0CAA0C;AAC1C,MAAM,UAAU,QAAQ,CAAC,MAAoB,EAAE,IAAgB;IAC9D,MAAM,UAAU,GAA2B;QAC1C,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,CAAC,SAAS,EAAE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;KAC7C,CAAC;IACF,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;YAAE,IAAI,GAAG,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,MAAoB,EAAE,IAAgB;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,GAAG,EAAE,CAAC;QACb,KAAK,WAAW;YACf,OAAO,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,SAAS;YACb,OAAO,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,UAAU;YACd,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,KAAK,SAAS;YACb,OAAO,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpC;YACC,MAAM,IAAI,WAAW,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAgB;IAC1C,OAAO,QAAQ,CAAC,MAAM,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB;IAC5C,OAAO,UAAU,CAAC,MAAM,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/parallel/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Parallel, multi-core compression — the one lever no single-threaded codec can
+ * match.
+ *
+ * `fflate`, `pako`, and even the runtime-native `Bun.gzipSync` / `zlib` all
+ * compress a buffer on **one** thread. ZipKit splits the input into independent
+ * blocks, compresses them concurrently across the whole {@link sharedPool}
+ * worker pool, and frames the result in a tiny self-describing container. On an
+ * N-core machine large inputs compress and decompress close to N× faster — so
+ * ZipKit beats native throughput on big data, the way `pigz` beats `gzip`.
+ *
+ * Each block is a complete, standard stream of the chosen codec; only the outer
+ * container (magic `ZKP1`) is ZipKit-specific, so {@link decompressParallel}
+ * reverses it. Per-block independence costs a sliver of ratio at small block
+ * sizes — negligible at the default ≥256 KB blocks.
+ *
+ * @example
+ * ```ts
+ * import { compressParallel, decompressParallel } from '@myrialabs/zipkit/parallel';
+ * const packed = await compressParallel(bigBuffer, 'zstd', { level: 19 });
+ * const original = await decompressParallel(packed);
+ * ```
+ */
+import type { Codec, CompressOptions, DecompressOptions } from '../types.js';
+import { WorkerPool } from '../workers/index.js';
+/** Options for {@link compressParallel}. */
+export interface ParallelCompressOptions extends CompressOptions {
+    /**
+     * Bytes per block. Larger blocks compress slightly denser; smaller blocks
+     * parallelize better. Defaults to an adaptive size (≥256 KB, ~4 blocks per
+     * core) that keeps every worker busy with negligible ratio loss.
+     */
+    blockSize?: number;
+    /** Worker pool to run on. Defaults to the process-wide {@link sharedPool}. */
+    pool?: WorkerPool;
+}
+/** Options for {@link decompressParallel}. */
+export interface ParallelDecompressOptions extends DecompressOptions {
+    /** Worker pool to run on. Defaults to the process-wide {@link sharedPool}. */
+    pool?: WorkerPool;
+}
+/**
+ * Compress `data` in parallel across the worker pool, returning a self-describing
+ * container that {@link decompressParallel} reverses. Falls back to a single
+ * block (and inline execution) where workers aren't available, so it never
+ * breaks — it simply stops being parallel.
+ */
+export declare function compressParallel(data: Uint8Array, codec: Codec, opts?: ParallelCompressOptions): Promise<Uint8Array>;
+/** True if `data` looks like a {@link compressParallel} container. */
+export declare function isParallelContainer(data: Uint8Array): boolean;
+/**
+ * Reverse {@link compressParallel}: decompress every block concurrently across
+ * the pool and concatenate. The codec is read from the container header.
+ */
+export declare function decompressParallel(data: Uint8Array, opts?: ParallelDecompressOptions): Promise<Uint8Array>;
+//# sourceMappingURL=index.d.ts.map

package/dist/parallel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parallel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAc,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAuB7D,4CAA4C;AAC5C,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC/D;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IACnE,8EAA8E;IAC9E,IAAI,CAAC,EAAE,UAAU,CAAC;CAClB;AAsBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,CAAC,EAAE,uBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAkDrB;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwChH"}

package/dist/parallel/index.js

@@ -0,0 +1,158 @@
+/**
+ * Parallel, multi-core compression — the one lever no single-threaded codec can
+ * match.
+ *
+ * `fflate`, `pako`, and even the runtime-native `Bun.gzipSync` / `zlib` all
+ * compress a buffer on **one** thread. ZipKit splits the input into independent
+ * blocks, compresses them concurrently across the whole {@link sharedPool}
+ * worker pool, and frames the result in a tiny self-describing container. On an
+ * N-core machine large inputs compress and decompress close to N× faster — so
+ * ZipKit beats native throughput on big data, the way `pigz` beats `gzip`.
+ *
+ * Each block is a complete, standard stream of the chosen codec; only the outer
+ * container (magic `ZKP1`) is ZipKit-specific, so {@link decompressParallel}
+ * reverses it. Per-block independence costs a sliver of ratio at small block
+ * sizes — negligible at the default ≥256 KB blocks.
+ *
+ * @example
+ * ```ts
+ * import { compressParallel, decompressParallel } from '@myrialabs/zipkit/parallel';
+ * const packed = await compressParallel(bigBuffer, 'zstd', { level: 19 });
+ * const original = await decompressParallel(packed);
+ * ```
+ */
+import { ZipKitError } from '../types.js';
+import { sharedPool } from '../workers/index.js';
+/** Container magic: "ZKP1" (ZipKit Parallel, version 1). */
+const MAGIC = 0x5a_4b_50_31;
+/** Fixed header size: magic(4) + codec(1) + reserved(1) + blockSize(4) + originalLen(4) + nBlocks(4). */
+const HEADER = 18;
+/** Stable on-disk codec ids (independent of the `Codec` union's order). */
+const CODEC_ID = {
+    gzip: 1,
+    deflate: 2,
+    zlib: 3,
+    zstd: 4,
+    lz4: 5,
+    snappy: 6,
+    brotli: 7,
+    lzma: 8,
+    bzip2: 9
+};
+const ID_CODEC = Object.fromEntries(Object.entries(CODEC_ID).map(([k, v]) => [v, k]));
+function cpuCount() {
+    return globalThis.navigator?.hardwareConcurrency ?? 4;
+}
+/** Choose a block size: ~4 blocks per core, never below 256 KB. */
+function defaultBlockSize(len) {
+    const target = Math.max(1, cpuCount() * 4);
+    return Math.max(256 * 1024, Math.ceil(len / target));
+}
+function writeU32(buf, off, v) {
+    buf[off] = v & 0xff;
+    buf[off + 1] = (v >>> 8) & 0xff;
+    buf[off + 2] = (v >>> 16) & 0xff;
+    buf[off + 3] = (v >>> 24) & 0xff;
+}
+function readU32(buf, off) {
+    return (buf[off] | (buf[off + 1] << 8) | (buf[off + 2] << 16) | (buf[off + 3] << 24)) >>> 0;
+}
+/**
+ * Compress `data` in parallel across the worker pool, returning a self-describing
+ * container that {@link decompressParallel} reverses. Falls back to a single
+ * block (and inline execution) where workers aren't available, so it never
+ * breaks — it simply stops being parallel.
+ */
+export async function compressParallel(data, codec, opts) {
+    const id = CODEC_ID[codec];
+    if (id === undefined)
+        throw new ZipKitError(`Unknown codec: ${codec}`);
+    if (data.length > 0xffffffff) {
+        throw new ZipKitError('compressParallel: inputs larger than 4 GB are not supported');
+    }
+    const pool = opts?.pool ?? sharedPool();
+    const blockSize = Math.max(1, opts?.blockSize ?? defaultBlockSize(data.length));
+    const nBlocks = Math.max(1, Math.ceil(data.length / blockSize));
+    // Fan out: every block compresses concurrently; the pool spreads them across
+    // all cores. This is the win — N blocks finish in ~1/N the wall-clock time.
+    let done = 0;
+    const jobs = [];
+    for (let i = 0; i < nBlocks; i++) {
+        const start = i * blockSize;
+        const block = data.subarray(start, Math.min(start + blockSize, data.length));
+        jobs.push(pool.compress(block, codec, { mode: opts?.mode, level: opts?.level, signal: opts?.signal }).then((out) => {
+            done++;
+            opts?.onProgress?.(done / nBlocks, done * blockSize);
+            return out;
+        }));
+    }
+    const parts = await Promise.all(jobs);
+    // Assemble: [header][per-block u32 compressedLen ...][blocks...].
+    const tableSize = nBlocks * 4;
+    let body = 0;
+    for (const p of parts)
+        body += p.length;
+    const out = new Uint8Array(HEADER + tableSize + body);
+    writeU32(out, 0, MAGIC);
+    out[4] = id;
+    out[5] = 0; // reserved
+    writeU32(out, 6, blockSize);
+    writeU32(out, 10, data.length);
+    writeU32(out, 14, nBlocks);
+    let off = HEADER;
+    for (let i = 0; i < nBlocks; i++) {
+        writeU32(out, off, parts[i].length);
+        off += 4;
+    }
+    for (const p of parts) {
+        out.set(p, off);
+        off += p.length;
+    }
+    return out;
+}
+/** True if `data` looks like a {@link compressParallel} container. */
+export function isParallelContainer(data) {
+    return data.length >= HEADER && readU32(data, 0) === MAGIC;
+}
+/**
+ * Reverse {@link compressParallel}: decompress every block concurrently across
+ * the pool and concatenate. The codec is read from the container header.
+ */
+export async function decompressParallel(data, opts) {
+    if (!isParallelContainer(data)) {
+        throw new ZipKitError('decompressParallel: not a ZipKit parallel container (bad magic)');
+    }
+    const codec = ID_CODEC[data[4]];
+    if (!codec)
+        throw new ZipKitError(`decompressParallel: unknown codec id ${data[4]}`);
+    const originalLen = readU32(data, 10);
+    const nBlocks = readU32(data, 14);
+    const tableOff = HEADER;
+    const blocksOff = tableOff + nBlocks * 4;
+    // Slice each compressed block out of the container, then decompress them all
+    // concurrently — decompression parallelizes too.
+    const pool = opts?.pool ?? sharedPool();
+    let cursor = blocksOff;
+    let done = 0;
+    const jobs = [];
+    for (let i = 0; i < nBlocks; i++) {
+        const clen = readU32(data, tableOff + i * 4);
+        const block = data.subarray(cursor, cursor + clen);
+        cursor += clen;
+        jobs.push(pool.decompress(block, codec, { signal: opts?.signal }).then((out) => {
+            done++;
+            opts?.onProgress?.(done / nBlocks, out.length);
+            return out;
+        }));
+    }
+    const parts = await Promise.all(jobs);
+    // Concatenate in block order. originalLen sizes the buffer exactly.
+    const out = new Uint8Array(originalLen);
+    let off = 0;
+    for (const p of parts) {
+        out.set(p, off);
+        off += p.length;
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/parallel/index.js.map

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

package/dist/sevenzip/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 7z container — read and write `.7z` archives.
+ *
+ * Built on the engine's LZMA: the writer stores each file in its own folder with
+ * a copy or LZMA1 coder and a plain header; the reader parses the 7z structure
+ * (plain or LZMA-encoded header) and decodes copy / LZMA1 / LZMA2 single-coder
+ * folders — covering archives from `7z a` (LZMA2 by default), `-m0=lzma`, and
+ * `-m0=copy`. Multi-coder folders (e.g. BCJ filter chains) are reported as
+ * unsupported rather than silently mis-decoded.
+ *
+ * @example
+ * ```ts
+ * import { sevenZip, unSevenZip } from '@myrialabs/zipkit/sevenzip';
+ * const archive = await sevenZip([{ name: 'a.txt', data: strToU8('hi') }]);
+ * const files = await unSevenZip(archive);
+ * ```
+ */
+/** An entry to write into a 7z archive. */
+export interface SevenZipEntryInput {
+    /** Path within the archive (use `/` separators). */
+    name: string;
+    /** File contents. */
+    data: Uint8Array;
+    /** Coder: `'lzma'` (default, dense) or `'copy'` (stored). */
+    method?: 'lzma' | 'copy';
+    /** LZMA level 0–9 (default 6). */
+    level?: number;
+}
+/** A decoded 7z entry. */
+export interface SevenZipEntry {
+    /** Path within the archive. */
+    name: string;
+    /** File contents. */
+    data: Uint8Array;
+    /** Uncompressed size in bytes. */
+    size: number;
+}
+/**
+ * Create a 7z archive from `entries`. Each file is stored in its own folder
+ * (non-solid) with an LZMA1 or copy coder and a plain (uncompressed) header.
+ */
+export declare function sevenZip(entries: SevenZipEntryInput[]): Promise<Uint8Array>;
+/** Read a 7z archive into its entries. */
+export declare function unSevenZip(data: Uint8Array): Promise<SevenZipEntry[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/sevenzip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sevenzip/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAkCH,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IAClC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACb;AAuHD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CA0DjF;AAqWD,0CAA0C;AAC1C,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA2E3E"}