zstdify 1.0.0

package/dist/bitstream/littleEndian.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"littleEndian.test.js","sourceRoot":"","sources":["../../src/bitstream/littleEndian.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEpE,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC;IAC7B,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QACpD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAAA,CACzC,CAAC,CAAC;IAEH,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAAA,CAC7C,CAAC,CAAC;IAEH,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9E,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAAA,CACtD,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAAA,CAC5C,CAAC,CAAC;AAAA,CACJ,CAAC,CAAC"}

package/dist/bitstream/varint.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Variable-length integer (varint) decode/encode per zstd format.
+ * 1-9 bytes, little-endian, 7 bits per byte, high bit = continue.
+ */
+export declare function decodeVarint(data: Uint8Array, offset: number): {
+    value: number;
+    bytesRead: number;
+};
+export declare function encodeVarint(value: number): Uint8Array;

package/dist/bitstream/varint.js

@@ -0,0 +1,40 @@
+/**
+ * Variable-length integer (varint) decode/encode per zstd format.
+ * 1-9 bytes, little-endian, 7 bits per byte, high bit = continue.
+ */
+export function decodeVarint(data, offset) {
+    let value = 0;
+    let shift = 0;
+    let pos = offset;
+    for (let i = 0; i < 9; i++) {
+        if (pos >= data.length) {
+            throw new RangeError('decodeVarint: truncated input');
+        }
+        const byte = data[pos];
+        if (byte === undefined)
+            throw new RangeError('decodeVarint: truncated input');
+        pos++;
+        value |= (byte & 0x7f) << shift;
+        if ((byte & 0x80) === 0) {
+            return { value, bytesRead: pos - offset };
+        }
+        shift += 7;
+        if (shift >= 56) {
+            throw new RangeError('decodeVarint: value too large');
+        }
+    }
+    throw new RangeError('decodeVarint: exceeds 9 bytes');
+}
+export function encodeVarint(value) {
+    const bytes = [];
+    let v = value >>> 0;
+    do {
+        let byte = v & 0x7f;
+        v >>>= 7;
+        if (v !== 0)
+            byte |= 0x80;
+        bytes.push(byte);
+    } while (v !== 0);
+    return new Uint8Array(bytes);
+}
+//# sourceMappingURL=varint.js.map

package/dist/bitstream/varint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"varint.js","sourceRoot":"","sources":["../../src/bitstream/varint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,YAAY,CAAC,IAAgB,EAAE,MAAc,EAAwC;IACnG,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,MAAM,CAAC;IAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;QAC9E,GAAG,EAAE,CAAC;QACN,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC;QAC5C,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;QACX,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;AAAA,CACvD;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAc;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;IAEpB,GAAG,CAAC;QACF,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;QACpB,CAAC,MAAM,CAAC,CAAC;QACT,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,IAAI,IAAI,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;IAElB,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAAA,CAC9B"}

package/dist/bitstream/varint.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/bitstream/varint.test.js

@@ -0,0 +1,25 @@
+import { describe, expect, it } from 'vitest';
+import { decodeVarint, encodeVarint } from './varint.js';
+describe('varint', () => {
+    it('encodes and decodes small values', () => {
+        for (const v of [0, 1, 127, 128, 255, 256, 16383]) {
+            const encoded = encodeVarint(v);
+            const { value, bytesRead } = decodeVarint(encoded, 0);
+            expect(value).toBe(v);
+            expect(bytesRead).toBe(encoded.length);
+        }
+    });
+    it('decodes single-byte varint', () => {
+        const data = new Uint8Array([0x7f]); // 127, no continuation
+        const { value, bytesRead } = decodeVarint(data, 0);
+        expect(value).toBe(127);
+        expect(bytesRead).toBe(1);
+    });
+    it('decodes two-byte varint', () => {
+        const data = new Uint8Array([0x80, 0x01]); // 128 = 0x80 | 0x01<<7
+        const { value, bytesRead } = decodeVarint(data, 0);
+        expect(value).toBe(128);
+        expect(bytesRead).toBe(2);
+    });
+});
+//# sourceMappingURL=varint.test.js.map

package/dist/bitstream/varint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"varint.test.js","sourceRoot":"","sources":["../../src/bitstream/varint.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC;IACvB,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;IAAA,CACF,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,uBAAuB;QAC5D,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAAA,CAC3B,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,uBAAuB;QAClE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAAA,CAC3B,CAAC,CAAC;AAAA,CACJ,CAAC,CAAC"}

package/dist/compress.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compress input data using zstd.
+ * Level 0: raw blocks only (no compression, fast).
+ */
+export type CompressOptions = {
+    level?: number;
+    checksum?: boolean;
+};
+export declare function compress(input: Uint8Array, options?: CompressOptions): Uint8Array;

package/dist/compress.js

@@ -0,0 +1,74 @@
+/**
+ * Compress input data using zstd.
+ * Level 0: raw blocks only (no compression, fast).
+ */
+import { writeRawBlock, writeRLEBlock } from './encode/blockWriter.js';
+import { buildCompressedBlockPayload, writeCompressedBlock } from './encode/compressedBlock.js';
+import { writeFrameHeader } from './encode/frameWriter.js';
+import { buildGreedySequences } from './encode/greedySequences.js';
+import { computeContentChecksum32 } from './frame/checksum.js';
+const BLOCK_MAX = 128 * 1024;
+export function compress(input, options) {
+    const level = options?.level ?? 0;
+    const hasChecksum = options?.checksum ?? false;
+    const chunks = [];
+    chunks.push(writeFrameHeader(input.length, hasChecksum));
+    let offset = 0;
+    const blockCount = input.length === 0 ? 1 : Math.ceil(input.length / BLOCK_MAX);
+    let blockIndex = 0;
+    while (offset < input.length || blockIndex < blockCount) {
+        const size = Math.min(BLOCK_MAX, input.length - offset);
+        const last = blockIndex === blockCount - 1;
+        const block = input.subarray(offset, offset + size);
+        if (level > 0 && size > 0) {
+            if (level > 1) {
+                const plan = buildGreedySequences(block);
+                if (plan.sequences.length > 0) {
+                    const payload = buildCompressedBlockPayload(plan.literals, plan.sequences);
+                    if (payload) {
+                        const compressed = writeCompressedBlock(payload, last);
+                        const raw = writeRawBlock(input, offset, size, last);
+                        if (compressed.length < raw.length) {
+                            chunks.push(compressed);
+                            offset += size;
+                            blockIndex++;
+                            continue;
+                        }
+                    }
+                }
+            }
+            const first = input[offset] ?? 0;
+            let isRLE = true;
+            for (let i = offset + 1; i < offset + size; i++) {
+                if ((input[i] ?? 0) !== first) {
+                    isRLE = false;
+                    break;
+                }
+            }
+            if (isRLE) {
+                chunks.push(writeRLEBlock(first, size, last));
+            }
+            else {
+                chunks.push(writeRawBlock(input, offset, size, last));
+            }
+        }
+        else {
+            chunks.push(writeRawBlock(input, offset, size, last));
+        }
+        offset += size;
+        blockIndex++;
+    }
+    if (hasChecksum) {
+        const checksum = computeContentChecksum32(input);
+        chunks.push(new Uint8Array([checksum & 0xff, (checksum >>> 8) & 0xff, (checksum >>> 16) & 0xff, (checksum >>> 24) & 0xff]));
+    }
+    const total = chunks.reduce((s, c) => s + c.length, 0);
+    const result = new Uint8Array(total);
+    let pos = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, pos);
+        pos += chunk.length;
+    }
+    return result;
+}
+//# sourceMappingURL=compress.js.map

package/dist/compress.js.map

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

package/dist/decode/block.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Block header parsing and block type dispatch.
+ */
+export declare const BLOCK_HEADER_SIZE = 3;
+export type BlockType = 0 | 1 | 2 | 3;
+export interface BlockHeader {
+    lastBlock: boolean;
+    blockType: BlockType;
+    blockSize: number;
+}
+export declare function parseBlockHeader(data: Uint8Array, offset: number): BlockHeader;

package/dist/decode/block.js

@@ -0,0 +1,28 @@
+/**
+ * Block header parsing and block type dispatch.
+ */
+import { ZstdError } from '../errors.js';
+export const BLOCK_HEADER_SIZE = 3;
+function readU24LE(data, offset) {
+    if (offset + 3 > data.length) {
+        throw new RangeError(`readU24LE: offset ${offset} + 3 exceeds length ${data.length}`);
+    }
+    const a = data[offset] ?? 0;
+    const b = data[offset + 1] ?? 0;
+    const c = data[offset + 2] ?? 0;
+    return a | (b << 8) | (c << 16);
+}
+export function parseBlockHeader(data, offset) {
+    if (offset + BLOCK_HEADER_SIZE > data.length) {
+        throw new ZstdError('Block header truncated', 'corruption_detected');
+    }
+    const w = readU24LE(data, offset);
+    const lastBlock = (w & 1) === 1;
+    const blockType = ((w >> 1) & 3);
+    const blockSize = w >> 3;
+    if (blockType === 3) {
+        throw new ZstdError('Reserved block type', 'corruption_detected');
+    }
+    return { lastBlock, blockType, blockSize };
+}
+//# sourceMappingURL=block.js.map

package/dist/decode/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../src/decode/block.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAUnC,SAAS,SAAS,CAAC,IAAgB,EAAE,MAAc,EAAU;IAC3D,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAAC,qBAAqB,MAAM,uBAAuB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAAA,CACjC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,MAAc,EAAe;IAC9E,IAAI,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7C,MAAM,IAAI,SAAS,CAAC,wBAAwB,EAAE,qBAAqB,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAc,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,CAAC;IAEzB,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAAA,CAC5C"}

package/dist/decode/block.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/decode/block.test.js

@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest';
+import { parseBlockHeader } from './block.js';
+describe('block', () => {
+    it('parses raw block header (last=1, type=0, size=5)', () => {
+        // last=1, type=0, size=5 -> (5<<3)|0<<1|1 = 41
+        const data = new Uint8Array([0x29, 0x00, 0x00]);
+        const block = parseBlockHeader(data, 0);
+        expect(block.lastBlock).toBe(true);
+        expect(block.blockType).toBe(0);
+        expect(block.blockSize).toBe(5);
+    });
+    it('throws on reserved block type 3', () => {
+        // last=0, type=3, size=0
+        const data = new Uint8Array([0x06, 0x00, 0x00]);
+        expect(() => parseBlockHeader(data, 0)).toThrow(/Reserved block type|corruption/i);
+    });
+    it('throws when block header is truncated', () => {
+        const data = new Uint8Array([0x28, 0xb5]);
+        expect(() => parseBlockHeader(data, 0)).toThrow(/Block header truncated|corruption/i);
+    });
+    it('throws when offset + 3 exceeds data length', () => {
+        const data = new Uint8Array([0x29, 0x00]);
+        expect(() => parseBlockHeader(data, 0)).toThrow(/truncated|corruption/i);
+    });
+});
+//# sourceMappingURL=block.test.js.map

package/dist/decode/block.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.test.js","sourceRoot":"","sources":["../../src/decode/block.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;IACtB,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE,CAAC;QAC3D,+CAA+C;QAC/C,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAAA,CACjC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE,CAAC;QAC1C,yBAAyB;QACzB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAAA,CACpF,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAAA,CACvF,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAAA,CAC1E,CAAC,CAAC;AAAA,CACJ,CAAC,CAAC"}

package/dist/decode/decompressFrame.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Decompress a single zstd frame.
+ */
+import type { DecoderDictionaryContext } from '../dictionary/decoderDictionary.js';
+import type { FrameHeader } from '../frame/frameHeader.js';
+export declare function decompressFrame(data: Uint8Array, offset: number, header: FrameHeader, dictionary?: DecoderDictionaryContext | null, maxSize?: number): {
+    output: Uint8Array;
+    bytesConsumed: number;
+};

package/dist/decode/decompressFrame.js

@@ -0,0 +1,147 @@
+/**
+ * Decompress a single zstd frame.
+ */
+import { readU32LE } from '../bitstream/littleEndian.js';
+import { ZstdError } from '../errors.js';
+import { validateContentChecksum } from '../frame/checksum.js';
+import { parseBlockHeader } from './block.js';
+import { decodeCompressedLiterals, decodeRawLiterals, decodeRLELiterals, decodeTreelessLiterals, parseLiteralsSectionHeader, } from './literals.js';
+import { executeSequences } from './reconstruct.js';
+import { decodeSequences } from './sequences.js';
+export function decompressFrame(data, offset, header, dictionary, maxSize) {
+    let pos = offset + 4 + header.headerSize;
+    const chunks = [];
+    let totalSize = 0;
+    const repOffsets = dictionary?.repOffsets
+        ? [dictionary.repOffsets[0], dictionary.repOffsets[1], dictionary.repOffsets[2]]
+        : [1, 4, 8];
+    let history = new Uint8Array(0);
+    if (dictionary?.historyPrefix && dictionary.historyPrefix.length > 0) {
+        history = dictionary.historyPrefix.slice();
+    }
+    let prevHuffmanTable = dictionary?.huffmanTable ?? null;
+    let prevSeqTables = dictionary?.sequenceTables ?? null;
+    while (true) {
+        if (pos + 3 > data.length) {
+            throw new ZstdError('Block header truncated', 'corruption_detected');
+        }
+        const block = parseBlockHeader(data, pos);
+        pos += 3;
+        if (block.blockType === 0) {
+            const literals = decodeRawLiterals(data, pos, block.blockSize);
+            chunks.push(literals);
+            totalSize += literals.length;
+            history = appendToHistory(history, literals, header.windowSize);
+            pos += block.blockSize;
+        }
+        else if (block.blockType === 1) {
+            const literals = decodeRLELiterals(data, pos, block.blockSize);
+            chunks.push(literals);
+            totalSize += literals.length;
+            history = appendToHistory(history, literals, header.windowSize);
+            pos += 1;
+        }
+        else if (block.blockType === 2) {
+            const blockContent = data.subarray(pos, pos + block.blockSize);
+            const { header: litHeader, dataOffset: litDataOffset } = parseLiteralsSectionHeader(blockContent, 0);
+            let literals;
+            let litBytesConsumed;
+            if (litHeader.blockType === 0) {
+                literals = decodeRawLiterals(blockContent, litDataOffset, litHeader.regeneratedSize);
+                litBytesConsumed = litHeader.headerSize + litHeader.regeneratedSize;
+            }
+            else if (litHeader.blockType === 1) {
+                literals = decodeRLELiterals(blockContent, litDataOffset, litHeader.regeneratedSize);
+                litBytesConsumed = litHeader.headerSize + 1;
+            }
+            else if (litHeader.blockType === 2) {
+                const comp = decodeCompressedLiterals(blockContent, litDataOffset, litHeader.compressedSize, litHeader.regeneratedSize, litHeader.numStreams);
+                literals = comp.literals;
+                prevHuffmanTable = comp.huffmanTable;
+                litBytesConsumed = litHeader.headerSize + comp.bytesRead;
+            }
+            else {
+                if (!prevHuffmanTable) {
+                    throw new ZstdError('Treeless literals without previous Huffman table', 'corruption_detected');
+                }
+                const comp = decodeTreelessLiterals(blockContent, litDataOffset, litHeader.compressedSize, litHeader.regeneratedSize, litHeader.numStreams, prevHuffmanTable);
+                literals = comp.literals;
+                litBytesConsumed = litHeader.headerSize + comp.bytesRead;
+            }
+            const seqSectionSize = block.blockSize - litBytesConsumed;
+            let output;
+            if (seqSectionSize <= 0) {
+                output = literals;
+            }
+            else {
+                const seqResult = decodeSequences(blockContent, litBytesConsumed, seqSectionSize, prevSeqTables);
+                prevSeqTables = seqResult.tables;
+                if (seqResult.sequences.length === 0) {
+                    output = literals;
+                }
+                else {
+                    output = executeSequences(literals, seqResult.sequences, header.windowSize, repOffsets, history);
+                }
+            }
+            chunks.push(output);
+            totalSize += output.length;
+            history = appendToHistory(history, output, header.windowSize);
+            pos += block.blockSize;
+        }
+        else {
+            throw new ZstdError('Unsupported block type', 'corruption_detected');
+        }
+        if (maxSize !== undefined && totalSize > maxSize) {
+            throw new ZstdError('Decompressed size exceeds maxSize', 'parameter_unsupported');
+        }
+        if (block.lastBlock)
+            break;
+    }
+    const output = concatenateChunks(chunks);
+    if (header.contentSize !== null && output.length !== header.contentSize) {
+        throw new ZstdError('Frame content size mismatch', 'corruption_detected');
+    }
+    if (header.hasContentChecksum) {
+        if (pos + 4 > data.length) {
+            throw new ZstdError('Content checksum truncated', 'corruption_detected');
+        }
+        const storedChecksum = readU32LE(data, pos);
+        if (!validateContentChecksum(output, storedChecksum)) {
+            throw new ZstdError('Content checksum mismatch', 'corruption_detected');
+        }
+        pos += 4;
+        return { output, bytesConsumed: pos - offset };
+    }
+    return { output, bytesConsumed: pos - offset };
+}
+function appendToHistory(history, chunk, windowSize) {
+    if (windowSize <= 0 || chunk.length === 0) {
+        return history;
+    }
+    const maxHistory = Math.max(1, windowSize);
+    if (chunk.length >= maxHistory) {
+        return new Uint8Array(chunk.subarray(chunk.length - maxHistory));
+    }
+    const keepFromHistory = Math.min(history.length, maxHistory - chunk.length);
+    const next = new Uint8Array(keepFromHistory + chunk.length);
+    if (keepFromHistory > 0) {
+        next.set(history.subarray(history.length - keepFromHistory), 0);
+    }
+    next.set(chunk, keepFromHistory);
+    return next;
+}
+function concatenateChunks(chunks) {
+    if (chunks.length === 0)
+        return new Uint8Array(0);
+    if (chunks.length === 1)
+        return chunks[0];
+    const total = chunks.reduce((s, c) => s + c.length, 0);
+    const result = new Uint8Array(total);
+    let pos = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, pos);
+        pos += chunk.length;
+    }
+    return result;
+}
+//# sourceMappingURL=decompressFrame.js.map

package/dist/decode/decompressFrame.js.map

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

package/dist/decode/literals.corruption.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/decode/literals.corruption.test.js

@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest';
+import { decodeCompressedLiterals, decodeRawLiterals, decodeRLELiterals, decodeTreelessLiterals, parseLiteralsSectionHeader, } from './literals.js';
+describe('literals corruption handling', () => {
+    it('rejects truncated literals section header', () => {
+        const data = new Uint8Array([0x24]); // compressed literals sizeFormat=1 requires 3-byte header
+        expect(() => parseLiteralsSectionHeader(data, 0)).toThrowError(/header truncated/i);
+    });
+    it('rejects raw literals overrun', () => {
+        const data = new Uint8Array([0x61, 0x62]);
+        expect(() => decodeRawLiterals(data, 0, 3)).toThrowError(/Raw literals truncated/i);
+    });
+    it('rejects rle literals when source byte is missing', () => {
+        const data = new Uint8Array([]);
+        expect(() => decodeRLELiterals(data, 0, 10)).toThrowError(/RLE literals truncated/i);
+    });
+    it('rejects invalid compressed literals size', () => {
+        const data = new Uint8Array([0x80]); // direct weights header with 1 weight; no stream payload
+        expect(() => decodeCompressedLiterals(data, 0, 1, 16, 1)).toThrowError(/truncated|Invalid literals compressed size/i);
+    });
+    it('rejects treeless 4-stream with compressedSize < 10', () => {
+        const table = decodeCompressedLiterals(new Uint8Array([129, 0x10, 0x02]), 0, 3, 1, 1).huffmanTable;
+        const data = new Uint8Array(9);
+        expect(() => decodeTreelessLiterals(data, 0, 9, 100, 4, table)).toThrowError(/4-stream mode requires at least 10 bytes/i);
+    });
+});
+//# sourceMappingURL=literals.corruption.test.js.map

package/dist/decode/literals.corruption.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"literals.corruption.test.js","sourceRoot":"","sources":["../../src/decode/literals.corruption.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC;IAC7C,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,0DAA0D;QAC/F,MAAM,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAAA,CACrF,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC;IAAA,CACrF,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC;IAAA,CACtF,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,yDAAyD;QAC9F,MAAM,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CACpE,6CAA6C,CAC9C,CAAC;IAAA,CACH,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,UAAU,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;QACnG,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,YAAY,CAC1E,2CAA2C,CAC5C,CAAC;IAAA,CACH,CAAC,CAAC;AAAA,CACJ,CAAC,CAAC"}

package/dist/decode/literals.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Decode literals section: Raw, RLE, Compressed, Treeless.
+ */
+import { buildHuffmanDecodeTable } from '../entropy/huffman.js';
+export type LiteralsBlockType = 0 | 1 | 2 | 3;
+export interface LiteralsSectionHeader {
+    blockType: LiteralsBlockType;
+    regeneratedSize: number;
+    compressedSize?: number;
+    numStreams: 1 | 4;
+    headerSize: number;
+}
+/**
+ * Parse Literals_Section_Header from compressed block.
+ * Returns header info and the byte offset after the header.
+ */
+export declare function parseLiteralsSectionHeader(data: Uint8Array, offset: number): {
+    header: LiteralsSectionHeader;
+    dataOffset: number;
+};
+/**
+ * Decode raw literals block - direct copy.
+ */
+export declare function decodeRawLiterals(data: Uint8Array, offset: number, size: number): Uint8Array;
+/**
+ * Decode RLE literals block - single byte repeated.
+ */
+export declare function decodeRLELiterals(data: Uint8Array, offset: number, size: number): Uint8Array;
+/**
+ * Decode compressed literals (Huffman). Requires Huffman table from tree description.
+ */
+export declare function decodeCompressedLiterals(data: Uint8Array, offset: number, compressedSize: number, regeneratedSize: number, numStreams: 1 | 4): {
+    literals: Uint8Array;
+    huffmanTable: {
+        table: ReturnType<typeof buildHuffmanDecodeTable>;
+        maxNumBits: number;
+    };
+    bytesRead: number;
+};
+/**
+ * Decode treeless literals (reuse previous Huffman table).
+ */
+export declare function decodeTreelessLiterals(data: Uint8Array, offset: number, compressedSize: number, regeneratedSize: number, numStreams: 1 | 4, huffmanTable: {
+    table: ReturnType<typeof buildHuffmanDecodeTable>;
+    maxNumBits: number;
+}): {
+    literals: Uint8Array;
+    bytesRead: number;
+};